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 更新日志	extract_rules 值 EXTR_REFS 在 PHP 4.3 中添加。 extract_rules 值 EXTR_IF_EXISTS 和 EXTR_PREFIX_IF_EXISTS 在 PHP 4.2 中添加。从 PHP 4.0.5 开始，此函数返回提取的变量数量。 extract_rules 值 EXTR_PREFIX_INVALID 在 PHP 4.0.5 中添加。从 PHP 4.0.5 开始， extract_rules 值 EXTR_PREFIX_ALL 现在也包含数字变量。