(PHP 4, PHP 5, PHP 7, PHP 8)
extract — 從數組中將變量導入到當前的符號表
&$array, int $flags = EXTR_OVERWRITE, string $prefix = ""): int本函數用來(lái)將變量從數組中導入到當前的符號表中。
檢查每個(gè)鍵名看是否可以作為一個(gè)合法的變量名，同時(shí)也檢查和符號表中已有的變量名的沖突。
array
一個(gè)關(guān)聯(lián)數組。此函數會(huì )將鍵名當作變量名，值作為變量的值。
對每個(gè)鍵／值對都會(huì )在當前的符號表中建立變量，并受到
flags 和 prefix 參數的影響。
必須使用關(guān)聯(lián)數組，數字索引的數組將不會(huì )產(chǎn)生結果，除非用了
EXTR_PREFIX_ALL 或者 EXTR_PREFIX_INVALID。
flags
對待非法／數字和沖突的鍵名的方法將根據取出標記
flags 參數決定?？梢允且韵轮抵唬?
EXTR_OVERWRITEEXTR_SKIPEXTR_PREFIX_SAMEprefix。
EXTR_PREFIX_ALLprefix。
EXTR_PREFIX_INVALIDprefix。
EXTR_IF_EXISTSEXTR_PREFIX_IF_EXISTSEXTR_REFSarray 參數的值?？梢詥为毷褂眠@個(gè)標志或者在
flags 中用 OR 與其它任何標志結合使用。
如果沒(méi)有指定 flags，則被假定為 EXTR_OVERWRITE。
prefix
注意 prefix 僅在
flags 的值是
EXTR_PREFIX_SAME，EXTR_PREFIX_ALL，EXTR_PREFIX_INVALID
或 EXTR_PREFIX_IF_EXISTS
時(shí)需要。
如果附加了前綴后的結果不是合法的變量名，將不會(huì )導入到符號表中。前綴和數組鍵名之間會(huì )自動(dòng)加上一個(gè)下劃線(xiàn)。
返回成功導入到符號表中的變量數目。
示例 #1 extract() 例子
extract() 的一種可能用法是將 wddx_deserialize() 返回的結合數組中的內容導入到符號表變量中去。
<?php
/* 假定 $var_array 是 wddx_deserialize 返回的數組*/
$size = "large";
$var_array = array("color" => "blue",
"size" => "medium",
"shape" => "sphere");
extract($var_array, EXTR_PREFIX_SAME, "wddx");
echo "$color, $size, $shape, $wddx_size\n";
?>
以上例程會(huì )輸出：
blue, large, sphere, medium
$size 沒(méi)有被覆蓋，因為指定了
EXTR_PREFIX_SAME，這使得 $wddx_size
被建立。如果指定了 EXTR_SKIP，則 $wddx_size
也不會(huì )被建立。EXTR_OVERWRITE 將使 $size
的值為“medium”，EXTR_PREFIX_ALL 將建立新變量
$wddx_color，$wddx_size 和
$wddx_shape。
不要對不能信任的數據使用
extract()，例如用戶(hù)的輸入（$_GET， $_FILES...）。
如果這樣做，要確保使用不會(huì )覆蓋的
flags 值，例如
EXTR_SKIP，并且要留意應該按照
variables_order
在 php.ini 里
定義的順序來(lái)提取。