近日在看一個牛人的代碼時,看到一個非常好用的函數:extract(),它的主要作用是將數組展開,鍵名作為變數名,元素值為變數值,可以說為數組的操作提供了另外一個方便的工具,比方說,可以很方便的提取$_POST或者$_GET的元素,對錶單提交上來的內容不能不用一一賦值,直接使用下面代碼:
form.html
<form action="action.php" method="post">
<input type="text"
name="username">
<input type="password"
name="password">
<input type="submit">
在action.php中只要使用extract()函數將$_POST全域資料解開:
action.php
<?php
extract($_POST);
//相當於$username =
$_POST['username'];
//$password = $_POST['password'];
?>
是不是很方便呢?呵呵,下面是PHP手冊裡的詳細解釋:
extract
(PHP 4, PHP 5)
extract — 從數組中將變數匯入到當前的符號表
說明
int extract ( array $var_array [, int $extract_type [, string
$prefix ]] )
本函數用來將變數從數組中匯入到當前的符號表中。接受結合數組 var_array
作為參數並將鍵名當作變數名,值作為變數的值。對每個鍵/值對都會在當前的符號表中建立變數,並受到 extract_type 和 prefix 參數的影響。
Note: 自版本 4.0.5 起本函數返回被提取的變數數目。
Note: EXTR_IF_EXISTS 和 EXTR_PREFIX_IF_EXISTS 是版本 4.2.0 中引進的。
Note: EXTR_REFS 是版本 4.3.0 中引進的。
extract() 檢查每個鍵名看是否可以作為一個合法的變數名,同時也檢查和符號表中已有的變數名的衝突。對待非法/數字和衝突的鍵名的方法將根據
extract_type 參數決定。可以是以下值之一:
EXTR_OVERWRITE
如果有衝突,覆蓋已有的變數。
EXTR_SKIP
如果有衝突,不覆蓋已有的變數。
EXTR_PREFIX_SAME
如果有衝突,在變數名前加上首碼 prefix 。
EXTR_PREFIX_ALL
給所有變數名加上首碼 prefix 。自 PHP 4.0.5 起這也包括了對數字索引的處理。
EXTR_PREFIX_INVALID
僅在非法/數位變數名前加上首碼 prefix 。本標記是 PHP 4.0.5 新加的。
EXTR_IF_EXISTS
僅在當前符號表中已有同名變數時,覆蓋它們的值。其它的都不處理。可以用在已經定義了一組合法的變數,然後要從一個數組例如 $_REQUEST
中提取值覆蓋這些變數的場合。本標記是 PHP 4.2.0 新加的。
EXTR_PREFIX_IF_EXISTS
僅在當前符號表中已有同名變數時,建立附加了首碼的變數名,其它的都不處理。本標記是 PHP 4.2.0 新加的。
EXTR_REFS
將變數作為引用提取。這有力地表明了匯入的變數仍然引用了 var_array 參數的值。可以單獨使用這個標誌或者在 extract_type 中用 OR
與其它任何標誌結合使用。本標記是 PHP 4.3.0 新加的。
如果沒有指定 extract_type ,則被假定為
EXTR_OVERWRITE。
注意 prefix 僅在 extract_type 的值是
EXTR_PREFIX_SAME,EXTR_PREFIX_ALL,EXTR_PREFIX_INVALID 或 EXTR_PREFIX_IF_EXISTS
時需要。如果附加了首碼後的結果不是合法的變數名,將不會匯入到符號表中。首碼和數組鍵名之間會自動加上一個底線。
extract() 返回成功匯入到符號表中的變數數目。
Warning
不要對不能信任的資料使用 extract(),例如使用者的輸入($_GET,…)。如果這樣做,舉例說,要臨時運行依賴於 register_globals
的老代碼,要確保使用不會覆蓋的 extract_type 值,例如 EXTR_SKIP,並且要留意應該按照 php.ini 中由 variables_order
定義的順序來提取。
extract() 的一種可能用法是將 wddx_deserialize() 返回的結合數組中的內容匯入到符號表變數中去。
Example#1 extract() 例子
<?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”;
?>
上例將輸出:
blue, large, sphere, medium
$size 沒有被覆蓋,因為指定了 EXTR_PREFIX_SAME,這使得 $wddx_size 被建立。如果指定了 EXTR_SKIP,則
$wddx_size 也不會被建立。EXTR_OVERWRITE 將使 $size 的值為“medium”,EXTR_PREFIX_ALL 將建立新變數
$wddx_color,$wddx_size 和 $wddx_shape。
必須使用關聯陣列,數字索引的數組將不會產生結果,除非用了 EXTR_PREFIX_ALL 或者 EXTR_PREFIX_INVALID