大网数据广告活动
PHP 语言与运行手册

compact · 建立一个数组,包括变量名和它们的值

· 52CE 我爱测

对每个参数,compact() 在当前的符号表中查找该变量名并将它添加到输出的数组中, 变量名成为键名而变量的内容成为该键的值。简单说,它做的事和 extract() 正好相反。返回将所有变量添加进去后的数组。

compact

(PHP 4, PHP 5, PHP 7, PHP 8)

compact — 建立一个数组,包括变量名和它们的值

说明

function compact(array|string $var_name, array|string ...$var_names): array

创建一个包含变量与其值的数组。

对每个参数,compact() 在当前的符号表中查找该变量名并将它添加到输出的数组中, 变量名成为键名而变量的内容成为该键的值。简单说,它做的事和 extract() 正好相反。返回将所有变量添加进去后的数组。

注意:

在 PHP 7.3 之前版本,未设置的字符串会被静默忽略。

参数

var_name var_names

compact() 接受可变的参数数量。每个参数不是包含变量名的字符串,就是变量名组成的数组。数组中可以包含由其他变量名组成的数组,compact() 会递归处理。

返回值

返回输出的数组,包含了添加的所有变量。

错误/异常

如果字符串指向的变量未定义,compact() 会产生 E_WARNING 级别的错误。

更新日志

版本 说明
8.0.0 如果指定字符串引用了未设置的变量,现在会发出 E_WARNING 级别的错误。
7.3.0 现在,如果字符串指向的变量未定义,compact() 会产生 E_NOTICE 级错误。在此之前,这样的字符串会默默地跳过。

示例

示例 #1 compact() 示例

<?php

$city  = "San Francisco";
$state = "CA";
$event = "SIGGRAPH";

$location_vars = array("city", "state");

$result = compact("event", $location_vars);
print_r($result);

?>

以上示例会输出:

Array
(
    [event] => SIGGRAPH
    [city] => San Francisco
    [state] => CA
)

注释

注意: Gotcha

因为可变变量也许不能在函数内部用于 PHP 的超全局数组,此时不能将超全局数组传递入 compact() 中。

参见

  • extract() - 从数组中将变量导入到当前的符号表

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。