compact() 函数将变量名转为数组键名,值为对应变量值,未定义变量自动过滤,常用于安全组装数据、构建响应字段或与 extract() 配合实现数组与变量间转换,提升代码简洁性与容错能力。

在PHP中,compact() 函数是一个非常实用的工具,用于将变量快速转换为数组,其中变量名作为键名,变量值作为键值。这个函数特别适合在构建返回数据、传递参数或组织局部变量时使用。
compact() 基本用法
compact() 接收一个或多个变量名(以字符串形式),检查当前作用域中是否存在同名变量,如果存在,则将其加入返回数组中,格式为 ['变量名' => 变量值]。
$name = 'Alice';
$age = 25;
$city = 'Beijing';
$result = compact('name', 'age', 'city');
// 输出: ['name' => 'Alice', 'age' => 25, 'city' => 'Beijing']
注意:传给 compact() 的是变量名的字符串,不是变量本身。它会自动查找当前作用域中的变量。
变量名作键名的实现原理
compact() 的核心机制是“通过变量名字符串反向提取变量值”。它依赖于当前作用域中的变量定义情况。
立即学习“PHP免费学习笔记(深入)”;
例如:
$title = '工程师';
$salary = 15000;
$data = compact('title', 'salary', 'department');
// 即使 'department' 未定义,也不会报错
// 结果: ['title' => '工程师', 'salary' => 15000]
// 'department' 被静默忽略
可以看到,未定义的变量会被自动过滤掉,不会导致错误,这是 compact() 的一个重要特性。
未定义变量的过滤技巧
由于 compact() 会跳过不存在的变量,我们可以利用这一点进行安全的数据组装,尤其在处理可选参数或动态字段时非常有用。
常见应用场景:
- 控制器中收集可选参数返回给视图
- API 接口拼接响应字段
- 表单数据整理时避免未定义警告
示例:动态构建用户信息
function buildUserInfo($withContact = false) {
$name = 'Bob';
$role = 'admin';
if ($withContact) {
$email = 'bob@example.com';
$phone = '13800138000';
}
// 无论 email 和 phone 是否定义,都不会出错
return compact('name', 'role', 'email', 'phone');
}
// 调用
$info1 = buildUserInfo(false); // ['name'=>'Bob', 'role'=>'admin']
$info2 = buildUserInfo(true); // 包含 email 和 phone
与 extract() 的对应关系
compact() 可看作是 extract() 的“逆操作”:
- compact(): 变量 → 数组(键名为变量名)
- extract(): 数组 → 变量(键名转为变量名)
两者配合使用,可以在数组与变量间灵活转换,提升代码简洁性。
基本上就这些。compact() 看似简单,但在实际开发中能有效减少冗长的数组赋值代码,同时具备对未定义变量的容错能力,合理使用能让逻辑更清晰。不复杂但容易忽略细节。











