基本語法 : PHP 數組
數組
php 中的數組實際上是一個有序圖。圖是一種把 values 映射到 keys 的類型。此類型在很多方面做了最佳化,因此可以把它當成真正的數組來使用,或列表(矢量),散列表(是圖的一種實現),字典,集合,棧,佇列以及更多可能性。因為可以用另一個 php 數組作為值,也可以很容易地模擬樹。
解釋這些結構超出了本手冊的範圍,但對於每種結構至少會發現一個例子。要得到這些結構的更多信息,建議參考有關此廣闊主題的外部著作。
PHP 5 Array 函式
PHP Array 函式允許您訪問並運算元組。
函式 | 描述 |
---|
| 創建數組。 |
array_change_key_case() | 返回其鍵均為大寫或小寫的數組。 |
array_chunk() | 把一個數組分割為新的數組塊。 |
| 返回輸入數組中某個單一列的值。 |
array_combine() | 通過合併兩個數組(一個為鍵名數組,一個為鍵值數組)來創建一個新數組。 |
array_count_values() | 用於統計數組中所有值出現的次數。 |
array_diff() | 比較數組,返回兩個數組的差集(只比較鍵值)。 |
array_diff_assoc() | 比較數組,返回兩個數組的差集(比較鍵名和鍵值)。 |
array_diff_key() | 比較數組,返回兩個數組的差集(只比較鍵名)。 |
array_diff_uassoc() | 比較數組,返回兩個數組的差集(比較鍵名和鍵值,使用用戶自定義的鍵名比較函式)。 |
array_diff_ukey() | 比較數組,返回兩個數組的差集(只比較鍵名,使用用戶自定義的鍵名比較函式)。 |
array_fill() | 用給定的鍵值填充數組。 |
array_fill_keys() | 用給定的指定鍵名的鍵值填充數組。 |
array_filter() | 用回調函式過濾數組中的元素。 |
array_flip() | 反轉/交換數組中的鍵名和對應關聯的鍵值。 |
array_intersect() | 比較數組,返回兩個數組的交集(只比較鍵值)。 |
array_intersect_assoc() | 比較數組,返回兩個數組的交集(比較鍵名和鍵值)。 |
array_intersect_key() | 比較數組,返回兩個數組的交集(只比較鍵名)。 |
array_intersect_uassoc() | 比較數組,返回兩個數組的交集(比較鍵名和鍵值,使用用戶自定義的鍵名比較函式)。 |
array_intersect_ukey() | 比較數組,返回兩個數組的交集(只比較鍵名,使用用戶自定義的鍵名比較函式)。 |
array_key_exists() | 檢查指定的鍵名是否存在於數組中。 |
array_keys() | 返回數組中所有的鍵名。 |
array_map() | 將用戶自定義函式作用到給定數組的每個值上,返回新的值。 |
array_merge() | 把一個或多個數組合併為一個數組。 |
array_merge_recursive() | 遞歸地把一個或多個數組合併為一個數組。 |
array_multisort() | 對多個數組或多維數組進行排序。 |
array_pad() | 將指定數量的帶有指定值的元素插入到數組中。 |
array_pop() | 刪除數組中的最後一個元素(出棧)。 |
array_product() | 計算數組中所有值的乘積。 |
array_push() | 將一個或多個元素插入數組的末尾(入棧)。 |
array_rand() | 從數組中隨機選出一個或多個元素,返回鍵名。 |
array_reduce() | 通過使用用戶自定義函式,疊代地將數組簡化為一個字元串,並返回。 |
array_replace() | 將所有被替換數組中的元素替換成第一個數組。 |
array_replace_recursive() | 將所有被替換數組中的元素遞歸地替換成第一個數組。 |
array_reverse() | 將原數組中的元素順序翻轉,創建新的數組並返回。 |
array_search() | 在數組中搜尋給定的值,如果成功則返回相應的鍵名。 |
array_shift() | 刪除數組中的第一個元素,並返回被刪除元素的值。 |
| 返回數組中的選定部分。 |
array_splice() | 把數組中的指定元素去掉並用其它值取代。 |
array_sum() | 返回數組中所有值的和。 |
array_udiff() | 比較數組,返回兩個數組的差集(只比較鍵值,使用一個用戶自定義的鍵名比較函式)。 |
array_udiff_assoc() | 比較數組,返回兩個數組的差集(比較鍵名和鍵值,使用內建函式比較鍵名,使用用戶自定義函式比較鍵值)。 |
array_udiff_uassoc() | 比較數組,返回兩個數組的差集(比較鍵名和鍵值,使用兩個用戶自定義的鍵名比較函式)。 |
array_uintersect() | 比較數組,返回兩個數組的交集(只比較鍵值,使用一個用戶自定義的鍵名比較函式)。 |
array_uintersect_assoc() | 比較數組,返回兩個數組的交集(比較鍵名和鍵值,使用內建函式比較鍵名,使用用戶自定義函式比較鍵值)。 |
array_uintersect_uassoc() | 比較數組,返回兩個數組的交集(比較鍵名和鍵值,使用兩個用戶自定義的鍵名比較函式)。 |
array_unique() | 刪除數組中重複的值。 |
array_unshift() | 在數組開頭插入一個或多個元素。 |
array_values() | 返回數組中所有的值。 |
array_walk() | 對數組中的每個成員套用用戶函式。 |
array_walk_recursive() | 對數組中的每個成員遞歸地套用用戶函式。 |
arsort() | 對關聯數組按照鍵值進行降序排序。 |
asort() | 對關聯數組按照鍵值進行升序排序。 |
compact() | 創建一個包含變數名和它們的值的數組。 |
count() | 返回數組中元素的數目。 |
current() | 返回數組中的當前元素。 |
each() | 返回數組中當前的鍵/值對。 |
end() | 將數組的內部指針指向最後一個元素。 |
extract() | 從數組中將變數導入到當前的符號表。 |
in_array() | 檢查數組中是否存在指定的值。 |
key() | 從關聯數組中取得鍵名。 |
krsort() | 對關聯數組按照鍵名降序排序。 |
| 對關聯數組按照鍵名升序排序。 |
list() | 把數組中的值賦給一些數組變數。 |
natcasesort() | 用"自然排序"算法對數組進行不區分大小寫字母的排序。 |
natsort() | 用"自然排序"算法對數組排序。 |
next() | 將數組中的內部指針向前移動一位。 |
| current() 的別名。 |
prev() | 將數組的內部指針倒回一位。 |
range() | 創建一個包含指定範圍的元素的數組。 |
reset() | 將數組的內部指針指向第一個元素。 |
rsort() | 對數值數組進行降序排序。 |
shuffle() | 把數組中的元素按隨機順序重新排列。 |
| count() 的別名。 |
| 對數值數組進行升序排序。 |
uasort() | 使用用戶自定義的比較函式對數組中的鍵值進行排序。 |
uksort() | 使用用戶自定義的比較函式對數組中的鍵名進行排序。 |
usort() | 使用用戶自定義的比較函式對數組進行排序。 |
語法
定義 array()
可以用 array() 語言結構來新建一個 array。它接受一定數量用逗號分隔的 key => value 參數對。
array( [key =>]value , ... )// key 可以是 integer 或者 string// value 可以是任何值<?php$arr = array("foo" => "bar", 12 => true);echo $arr["foo"]; // barecho $arr[12]; // 1?>
key 可以是 integer 或者 string。如果鍵名是一個 integer 的標準表達方法,則被解釋為整數(例如 "8" 將被解釋為 8,而 "08" 將被解釋為 "08")。key 中的浮點數被取整為 integer。php 中沒有不同的數字下標和關聯下標數組,數組的類型只有一種,它可以同時包含整型和字元串型的下標。
值可以是任何值。
<?php$arr = array("somearray" => array(6 => 5, 13 => 9, "a" => 42));echo $arr["somearray"][6]; // 5echo $arr["somearray"][13]; // 9echo $arr["somearray"]["a"]; // 42?>
如果對給出的值沒有指定鍵名,則取當前最大的整數索引值,而新的鍵名將是該值加一。如果指定的鍵名已經有了值,則該值會被覆蓋。
<?php// This array is the same as ...array(5 => 43, 32, 56, "b" => 12);// ...this arrayarray(5 => 43, 6 => 32, 7 => 56, "b" => 12);?>如果 $arr 還不存在,將會新建一個。這也是一種定義數組的替換方法。要改變一個值,只要給它賦一個新值。如果要刪除一個鍵名/值對,要對它用 unset()。 <?php$arr = array(5 => 1, 12 => 2);$arr[] = 56; // This is the same as $arr[13] = 56; // at this point of the script$arr["x"] = 42; // This adds a new element to // the array with key "x"unset($arr[5]); // This removes the element from the arrayunset($arr); // This deletes the whole array?>
注意這裡所使用的最大整數鍵名不一定當前就在數組中。它只要在上次數組重新生成索引後曾經存在過就行了。以下面的例子來說明:
<?php// 創建一個簡單的數組$array = array(1, 2, 3, 4, 5);print_r($array);// 現在刪除其中的所有單元,但保持數組本身的結構foreach ($array as $i => $value) { unset($array[$i]);}print_r($array);// 添加一個單元(注意新的鍵名是 5,而不是你可能以為的 0)$array[] = 6;print_r($array);// 重新索引:$array = array_values($array);$array[] = 7;print_r($array);?>上例將輸出:
Array( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5)Array()Array( [5] => 6)Array( [0] => 6 [1] => 7) |
實用函式
有相當多的實用函式作用於數組,參見數組函式一節。
注: unset() 函式允許取消一個數組中的鍵名。要注意數組將不會重建索引。
<?php
$a = array( 1 => 'one', 2 => 'two', 3 => 'three' );
unset( $a[2] );
/* 將產生一個數組,定義為
$a = array( 1=>'one', 3=>'three');
而不是
$a = array( 1 => 'one', 2 => 'three');
*/
$b = array_values($a);
// Now $b is array(0 => 'one', 1 =>'three')
?>
foreach 控制結構是專門用於數組的。它提供了一個簡單的方法來遍歷數組。
數組做什麼和不做什麼
為什麼 $foo[bar] 錯了?
應該始終在用字元串表示的數組索引上加上引號。例如用 $foo['bar'] 而不是 $foo[bar]。但是為什麼 $foo[bar] 錯了呢?可能在老的腳本中見過如下語法:
<?php$foo[bar] = 'enemy';echo $foo[bar];// etc?>
這樣是錯的,但可以正常運行。那么為什麼錯了呢?原因是此代碼中有一個未定義的常量(bar)而不是字元串('bar'-注意引號),而 php 可能會在以後定義此常量,不幸的是你的代碼中有同樣的名字。它能運行,是因為 php 自動將裸字元串(沒有引號的字元串且不對應於任何已知符號)轉換成一個其值為該裸字元串的正常字元串。例如,如果沒有常量定義為 bar,php 將把它替代為 'bar' 並使用之。 注: 這並不意味著總是給鍵名加上引號。用不著給鍵名為常量或變數的加上引號,否則會使 php 不能解析它們。
<?phperror_reporting(E_ALL);ini_set('display_errors', true);ini_set('html_errors', false);// Simple array:$array = array(1, 2);$count = count($array);for ($i = 0; $i < $count; $i++) { echo "/nChecking $i: /n"; echo "Bad: " . $array['$i'] . "/n"; echo "Good: " . $array[$i] . "/n"; echo "Bad: {$array['$i']}/n"; echo "Good: {$array[$i]}/n";}?>
演示此效應的更多例子:
<?php// 顯示所有錯誤error_reporting(E_ALL);$arr = array('fruit' => 'apple', 'veggie' => 'carrot');// 正確print $arr['fruit']; // appleprint $arr['veggie']; // carrot// 不正確。This works but also throws a php error of// level E_NOTICE because of an undefined constant named fruit//// Notice: Use of undefined constant fruit - assumed 'fruit' in...print $arr[fruit]; // apple// Let's define a constant to demonstrate what's going on. We// will assign value 'veggie' to a constant named fruit.define('fruit','veggie');// Notice the difference nowprint $arr['fruit']; // appleprint $arr[fruit]; // carrot// The following is okay as it's inside a string. Constants are not// looked for within strings so no E_NOTICE error hereprint "Hello $arr[fruit]"; // Hello apple// With one exception, braces surrounding arrays within strings// allows constants to be looked forprint "Hello {$arr[fruit]}"; // Hello carrotprint "Hello {$arr['fruit']}"; // Hello apple// This will not work, results in a parse error such as:// Parse error: parse error, expecting T_STRING' or T_VARIABLE' or T_NUM_STRING'// This of course applies to using autoglobals in strings as wellprint "Hello $arr['fruit']";print "Hello $_GET['foo']";// Concatenation is another optionprint "Hello " . $arr['fruit']; // Hello apple?>
當打開 error_reporting() 來顯示 E_NOTICE 級別的錯誤(例如將其設為 E_ALL)時將看到這些錯誤。默認情況下 error_reporting 被關閉不顯示這些。
和在語法一節中規定的一樣,在方括弧(“[”和“]”)之間必須有一個表達式。這意味著可以這樣寫:
<?phpecho $arr[somefunc($bar)];?>
這是一個用函式返回值作為數組索引的例子。php 也可以用已知常量,可能之前已經見過 E_*。 <?php$error_descriptions[E_ERROR] = "A fatal error has occured";$error_descriptions[E_WARNING] = "php issued a warning";$error_descriptions[E_NOTICE] = "This is just an informal notice";?>
注意 E_ERROR 也是個合法的標識符,就和第一個例子中的 bar 一樣。但是上一個例子實際上和如下寫法是一樣的: <?php$error_descriptions[1] = "A fatal error has occured";$error_descriptions[2] = "php issued a warning";$error_descriptions[8] = "This is just an informal notice";?>
因為 E_ERROR 等於 1,等等。 如同在以上例子中解釋的那樣,$foo[bar] 起作用但其實是錯誤的。它起作用是因為根據語法的預期,bar 被當成了一個常量表達式。然而,在這個例子中不存在名為 bar 的常量。php 就假定指的是字面上的 bar,也就是字元串 "bar",但忘記加引號了。
那么為什麼這樣做不好?在未來的某一時刻,php 開發小組可能會想新增一個常量或者關鍵字,或者用戶可能希望以後在自己的程式中引入新的常量,那就有麻煩了。例如已經不能這樣用 empty 和 default 這兩個詞了,因為他們是保留字。
注: 重申一次,在雙引號字元串中,不給索引加上引號是合法的因此 "$foo[bar]"是合法的。至於為什麼參見以上的例子和字元串中的變數解析中的解釋。
轉換為數組
對於任何的類型:整型、浮點、字元串、布爾和資源,如果將一個值轉換為數組,將得到一個僅有一個元素的數組(其下標為 0),該元素即為此標量的值。
如果將一個對象轉換成一個數組,所得到的數組的元素為該對象的屬性(成員變數),其鍵名為成員變數名。
如果將一個 NULL 值轉換成數組,將得到一個空數組。
比較
有可能通過 array_diff() 和數組運算符來比較數組。
例子
php 中的數組類型有非常多的用途,因此這裡有一些例子展示數組的完整威力。
<?php// this$a = array( 'color' => 'red', 'taste' => 'sweet', 'shape' => 'round', 'name' => 'apple', 4 // key will be 0 );// is completely equivalent with$a['color'] = 'red';$a['taste'] = 'sweet';$a['shape'] = 'round';$a['name'] = 'apple';$a[] = 4; // key will be 0$b[] = 'a';$b[] = 'b';$b[] = 'c';// will result in the array array(0 => 'a' , 1 => 'b' , 2 => 'c'),// or simply array('a', 'b', 'c')?>
例子 11-6. 使用 array()
<?php// Array as (property-)map$map = array( 'version' => 4, 'OS' => 'Linux', 'lang' => 'english', 'short_tags' => true );// strictly numerical keys$array = array( 7, 8, 0, 156, -10 );// this is the same as array(0 => 7, 1 => 8, ...)$switching = array( 10, // key = 0 5 => 6, 3 => 7, 'a' => 4, 11, // key = 6 (maximum of integer-indices was 5) '8' => 2, // key = 8 (integer!) '02' => 77, // key = '02' 0 => 12 // the value 10 will be overwritten by 12 );// empty array$empty = array();?>例子 11-7. 集合
<?php$colors = array('red', 'blue', 'green', 'yellow');foreach ($colors as $color) { echo "Do you like $color?/n";}?>上例將輸出:
Do you like red?Do you like blue?Do you like green?Do you like yellow? |
直接改變數組的值在 php 5 中可以通過引用傳遞來做到。之前的版本需要需要採取別的方法:
例子 11-8. 集合
<?php// php 5foreach ($colors as &$color) { $color = strtoupper($color);}unset($color); /* 確保下面對 $color 的覆蓋不會影響到前一個數組單元 */// 之前版本的方法foreach ($colors as $key => $color) { $colors[$key] = strtoupper($color);}print_r($colors);?>上例將輸出:
Array( [0] => RED [1] => BLUE [2] => GREEN [3] => YELLOW) |
本例產生一個基於一的數組。
例子 11-9. 基於一的數組
<?php$firstquarter = array(1 => 'January', 'February', 'March');print_r($firstquarter);?>上例將輸出:
Array( [1] => 'January' [2] => 'February' [3] => 'March')*/?> |
例子 11-10. 填充數組
<?php// fill an array with all items from a directory$handle = opendir('.');while (false !== ($file = readdir($handle))) { $files[] = $file;}closedir($handle);?>數組是有序的。也可以使用不同的排序函式來改變順序。更多信息參見數組函式。可以用 count() 函式來數出數組中元素的個數。
例子 11-11. 數組排序
<?phpsort($files);print_r($files);?>因為數組中的值可以為任意值,也可是另一個數組。這樣可以產生遞歸或多維數組。
例子 11-12. 遞歸和多維數組
<?php$fruits = array ( "fruits" => array ( "a" => "orange", "b" => "banana", "c" => "apple" ), "numbers" => array ( 1, 2, 3, 4, 5, 6 ), "holes" => array ( "first", 5 => "second", "third" ) );// Some examples to address values in the array aboveecho $fruits["holes"][5]; // prints "second"echo $fruits["fruits"]["a"]; // prints "orange"unset($fruits["holes"][0]); // remove "first"// Create a new multi-dimensional array$juices["apple"]["green"] = "good";?>需要注意數組的賦值總是會涉及到值的拷貝。需要在複製數組時用引用符號(&)。
<?php$arr1 = array(2, 3);$arr2 = $arr1;$arr2[] = 4; // $arr2 is changed, // $arr1 is still array(2,3)$arr3 = &$arr1;$arr3[] = 4; // now $arr1 and $arr3 are the same?>