PHP extract() 函数

将值 "Cat"、"Dog" 和 "Horse" 分别赋给变量 $a、$b 和 $c

<?php
$a = "Original";
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array);
echo "\$a = $a; \$b = $b; \$c = $c";
?>

定义和用法

extract() 函数将数组中的变量导入到局部符号表中。

此函数使用数组键作为变量名，使用值作为变量值。对于每个元素，它将在当前符号表中创建一个变量。

此函数在成功时返回提取的变量数量。

extract(array, extract_rules, prefix)

参数	描述
array	必需。指定要使用的数组
extract_rules	可选。extract() 函数检查无效的变量名和与现有变量名的冲突。此参数指定如何处理无效和冲突的名称。可能的值 EXTR_OVERWRITE - 默认。发生冲突时，将覆盖现有变量 EXTR_SKIP - 发生冲突时，将不会覆盖现有变量 EXTR_PREFIX_SAME - 发生冲突时，将为变量名添加前缀 EXTR_PREFIX_ALL - 所有变量名都将添加前缀 EXTR_PREFIX_INVALID - 仅为无效或数字变量名添加前缀 EXTR_IF_EXISTS - 仅覆盖当前符号表中已有的变量，否则不执行任何操作 EXTR_PREFIX_IF_EXISTS - 仅当当前符号表中存在相同的变量时，才为变量添加前缀 EXTR_REFS - 将变量作为引用提取。导入的变量仍然引用数组参数的值
prefix	可选。如果在 extract_rules 参数中使用 EXTR_PREFIX_SAME、EXTR_PREFIX_ALL、EXTR_PREFIX_INVALID 或 EXTR_PREFIX_IF_EXISTS，则需要指定前缀。此参数指定前缀。前缀会自动使用下划线字符与数组键隔开。

参数

描述

array

必需。指定要使用的数组

extract_rules

可选。extract() 函数检查无效的变量名和与现有变量名的冲突。此参数指定如何处理无效和冲突的名称。

可能的值

prefix

可选。如果在 extract_rules 参数中使用 EXTR_PREFIX_SAME、EXTR_PREFIX_ALL、EXTR_PREFIX_INVALID 或 EXTR_PREFIX_IF_EXISTS，则需要指定前缀。

此参数指定前缀。前缀会自动使用下划线字符与数组键隔开。

返回值	返回成功提取的变量数量
PHP 版本	4+
PHP 变更日志	在 PHP 4.3 中添加了 extract_rules 值 EXTR_REFS。在 PHP 4.2 中添加了 extract_rules 值 EXTR_IF_EXISTS 和 EXTR_PREFIX_IF_EXISTS。从 PHP 4.0.5 开始，此函数现在返回提取的变量数量。在 PHP 4.0.5 中添加了 extract_rules 值 EXTR_PREFIX_INVALID。从 PHP 4.0.5 开始， extract_rules 值 EXTR_PREFIX_ALL 现在也包含数字变量。