Arrays

在PHP中一个数组实际上是一个有次序的映射。一个映射是映射值到关键字上。这个类型在单独的方法上被优化的，你可以作为一个真实的数组或一个列表（向量）,hashtable (一个映射的执行)，字典，聚集，堆栈，队列和更多的来使用它。因为你可能还有另外的PHP-数组作为一个值，你也可以十分容易的模仿树结构。

这个结构的解释超过了这本手册的范围，但是你将发现为这结构的最小的范例。关于这个结构的更多信息，请你查阅其它文献。

语法

用array()指定数组

一个数组可以被array() 构造。它由一对key => value并用逗号分割的一系列的号码组成。

一个 key 是任意的非负整数或一个字符串组成。 如果一个是由一个标准的非负整数表达的，它将被解释成这样(i.e. '8' 将被解释成8，'08' 将被解释成'08').

一个值可以是任意的。

忽略键。如果你忽略一个键，那么新键将用最大的整数索引加一。如果整数索引也不存在，这个键将是0。如果你已经指定一个值给一个键，那么这个将被复盖。

array( [key =>] value , ... ) // 键是任意的字符串或非负整数 // 值可以是任意的

用带方括号的语法新建/修改

你可以通过明确的设置值去修改一个已存在的数组。

可以用带方括号的键去分配值给数组。你也可以忽略这个键，在变量名后加一对空方括号。

$arr[key] = value; $arr[] = value; // key 是任意字符串或非负整数 // value 可以是任意的

如果 $arr 不存在，它将被新建。如此也可能选择性的去指定一个数组。去改变一个确定的值，刚好分配一个新值给它。如果你想去删除一对键/值，你需要用 unset() 。

有用的函数

为数组的工作，有一睦有用的函数，参见数组函数 段落。

foreach 流程控制明确提供了一个容易的方法去循环一个数组。

Array do's and don'ts

为什么$foo[bar]是错误的?

在旧的脚本中你可能看到过下边的语法：

$foo[bar] = 'enemy'; echo $foo[bar]; // etc

这是错误的，但它会工作。然而，为什么是错误的呢？在这之后的 syntax 片段中规定，表达式必须在方括号之间。。这意味着你可以象下边一样做：

echo $arr[ foo(true) ];

这个例子使用一个函数的返回值作为数组的索引。PHP也知道是常量，你可以见 E_*。

$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 。But the last example is in fact the same as writing:

$error_descriptions[1] = "A fatal error has occured"; $error_descriptions[2] = "PHP issued a warning"; $error_descriptions[8] = "This is just an informal notice";

because E_ERROR equals 1, etc.

Then, how is it possible that $foo[bar] works? It works, because bar is due to its syntax expected to be a constant expression. However, in this case no constant with the name bar exists. PHP now assumes that you meant bar literally, as the string "bar", but that you forgot to write the quotes.

So why is it bad then?

At some point in the future, the PHP team might want to add another constant or keyword, and then you get in trouble. For example, you already cannot use the words empty and default this way, since they are special keywords.

And, if these arguments don't help: this syntax is simply deprecated, and it might stop working some day.

Tip: When you turn error_reporting to E_ALL, you will see that PHP generates warnings whenever this construct is used. This is also valid for other deprecated 'features'. (put the line error_reporting(E_ALL); in your script)

Note: Inside a double-quoted string, an other syntax is valid. See variable parsing in strings for more details.

Examples

The array type in PHP is very versatile, so here will be some examples to show you the full power of arrays.

// 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')

Example 6-4. Using array() // 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 ); <!-- TODO example of - mixed keys - overwriting keys - integer keys as string - using vars/functions as key/values - mixed skipping --> // empty array $empty = array();

Example 6-5. Collection $colors = array('red','blue','green','yellow'); foreach ( $colors as $color ) { echo "Do you like $color?/n"; } /* output: Do you like red? Do you like blue? Do you like green? Do you like yellow? */

Note that it is currently not possible to change the values of the array directly in such a loop. A workaround is the following:

Example 6-6. Collection foreach ( $colors as $key => $color ) { // won't work: //$color = strtoupper($color); //works: $colors[$key] = strtoupper($color); } print_r($colors); /* output: Array ( [0] => RED [1] => BLUE [2] => GREEN [3] => YELLOW ) */

This example creates a one-based array.

Example 6-7. One-based index $firstquarter = array(1 => 'January', 'February', 'March'); print_r($firstquarter); /* output: Array ( [1] => 'January' [2] => 'February' [3] => 'March' ) */

Example 6-8. Filling real array // fill an array with all items from a directory $handle = opendir('.'); while ($file = readdir($handle)) { $files[] = $file; } closedir($handle);

Arrays are ordered. You can also change the order using various sorting-functions. See array-functions for more information.

Example 6-9. Sorting array sort($files); print_r($files);

Because the value of an array can be everything, it can also be another array. This way you can make recursive and multi-dimensional arrays.

Example 6-10. Recursive and multi-dimensional arrays $fruits = array ( "fruits" => array ( "a" => "orange" , "b" => "banana" , "c" => "apple" ) , "numbers" => array ( 1 , 2 , 3 , 4 , 5 , 6 ) , "holes" => array ( "first" , 5 => "second" , "third" ) );