PHP 中的 array 实际上是一个有序映射。映射是一种把 values 关联到 keys 的类型。此类型针对多种不同用途进行了优化; 它可以被视为数组、列表(向量)、哈希表(映射的实现)、字典、集合、堆栈、队列等等。 由于 array 的值可以是其它 array 所以树形结构和多维 array 也是允许的。
一、语法
1、定义数组array()
可以用 array() 语言结构来新建一个 array。它接受任意数量用逗号分隔的 键(key) => 值(value) 对。
array( key => value, key2 => value2, key3 => value3, ... )
最后一个数组单元之后的逗号可以省略。通常用于单行数组定义中,例如常用 array(1, 2) 而不是 array(1, 2, )。对多行数组定义通常保留最后一个逗号,这样要添加一个新单元时更方便。
注意:可以用短数组语法 [] 替代 array() 。
示例:一个简单数组
<?php $array = array( "foo" => "bar", "bar" => "foo", ); // 使用短数组语法 $array = [ "foo" => "bar", "bar" => "foo", ]; ?>
key 可以是 integer 或者 string。value 可以是任意类型。
此外 key 会有如下的强制转换:
- String 中包含有效的十进制 int,除非数字前面有一个 + 号,否则将被转换为 int 类型。例如键名 “8” 实际会被储存为 8。另外, “08” 不会被强制转换,因为它不是一个有效的十进制整数。
- Float 也会被转换为 int ,意味着其小数部分会被舍去。例如键名 8.7 实际会被储存为 8。
- Bool 也会被转换成 int。即键名 true 实际会被储存为 1 而键名 false 会被储存为 0。
- Null 会被转换为空字符串,即键名 null 实际会被储存为 “”。
- Array 和 object 不能 被用为键名。坚持这么做会导致警告:Illegal offset type。
如果在数组定义时多个元素都使用相同键名,那么只有最后一个会被使用,其它的元素都会被覆盖。
示例 :类型转换与覆盖的示例
<?php $array = array( 1 => "a", "1" => "b", 1.5 => "c", true => "d", ); var_dump($array); ?>
以上示例会输出:
array(1) { [1]=> string(1) "d" }
上例中所有的键名都被强制转换为 1,则每一个新单元都会覆盖前一个的值,最后剩下的只有一个 “d”。
PHP 数组可以同时含有 int 和 string 类型的键名,因为 PHP 实际并不区分索引数组和关联数组。
示例 :混合 int 和 string 键名
<?php $array = array( "foo" => "bar", "bar" => "foo", 100 => -100, -100 => 100, ); var_dump($array); ?>
以上示例会输出:
array(4) { ["foo"]=> string(3) "bar" ["bar"]=> string(3) "foo" [100]=> int(-100) [-100]=> int(100) }
key 为可选项。如果未指定,PHP 将自动使用之前用过的最大 int 键名加上 1 作为新的键名。
示例:没有键名的索引数组
<?php $array = array("foo", "bar", "hello", "world"); var_dump($array); ?>
以上示例会输出:
array(4) { [0]=> string(3) "foo" [1]=> string(3) "bar" [2]=> string(5) "hello" [3]=> string(5) "world" }
还可以只对某些单元指定键名而对其它的空置:
示例 : 仅对部分单元指定键名
<?php $array = array( "a", "b", 6 => "c", "d", ); var_dump($array); ?>
以上示例会输出:
array(4) { [0]=> string(1) "a" [1]=> string(1) "b" [6]=> string(1) "c" [7]=> string(1) "d" }
可以看到最后一个值 “d” 被自动赋予了键名 7。这是由于之前最大的整数键名是 6。
示例 : 复杂类型转换和覆盖的例子
这个例子包括键名类型转换和元素覆盖的所有变化。
<?php $array = array( 1 => 'a', '1' => 'b', // 值 "a" 会被 "b" 覆盖 1.5 => 'c', // 值 "b" 会被 "c" 覆盖 -1 => 'd', '01' => 'e', // 由于这不是整数字符串,因此不会覆盖键名 1 '1.5' => 'f', // 由于这不是整数字符串,因此不会覆盖键名 1 true => 'g', // 值 "c" 会被 "g" 覆盖 false => 'h', '' => 'i', null => 'j', // 值 "i" 会被 "j" 覆盖 'k', // 值 “k” 的键名被分配为 2。这是因为之前最大的整数键是 1 2 => 'l', // 值 "k" 会被 "l" 覆盖 ); var_dump($array); ?>
以上示例会输出:
array(7) { [1]=> string(1) "g" [-1]=> string(1) "d" ["01"]=> string(1) "e" ["1.5"]=> string(1) "f" [0]=> string(1) "h" [""]=> string(1) "j" [2]=> string(1) "l" }
2、用方括号语法访问数组单元
数组单元可以通过 array[key] 语法来访问。
示例:访问数组单元
<?php $array = array( "foo" => "bar", 42 => 24, "multi" => array( "dimensional" => array( "array" => "foo" ) ) ); var_dump($array["foo"]); var_dump($array[42]); var_dump($array["multi"]["dimensional"]["array"]); ?>
以上示例会输出:
string(3) "bar" int(24) string(3) "foo"
注意:在 PHP 8.0.0 之前,方括号和花括号可以互换使用来访问数组单元(例如 $array[42] 和 $array{42} 在上例中效果相同)。 花括号语法在 PHP 7.4.0 中已弃用,在 PHP 8.0.0 中不再支持。
示例 :数组解引用
<?php function getArray() { return array(1, 2, 3); } $secondElement = getArray()[1]; ?>
注意:
- 试图访问一个未定义的数组键名与访问任何未定义变量一样:会导致 E_WARNING 级别错误信息(在 PHP 8.0.0 之前是 E_NOTICE 级别),其结果为 null。
- 数组解引用非 string 的标量值会产生 null。 在 PHP 7.4.0 之前,它不会发出错误消息。 从 PHP 7.4.0 开始,这个问题产生 E_NOTICE ; 从 PHP 8.0.0 开始,这个问题产生 E_WARNING 。
3、用方括号语法新建/修改
可以通过明示地设定其中的值来修改现有的 array 。这是通过在方括号内指定键名来给 array 赋值实现的。也可以省略键名,在这种情况下给变量名加上一对空的方括号([])。
$arr[key] = value; $arr[] = value; // key 可以是 int 或 string // value 可以是任意类型的值
如果 $arr 不存在或者设置为 null 或者 false,将会新建它,这也是另一种创建 array 的方法。不过并不鼓励这样做,因为如果 $arr 已经包含有值(例如来自请求变量的 string)则此值会保留而 [] 实际上代表着字符串访问运算符。初始化变量的最好方式是直接给其赋值。
注意:
- 从 PHP 7.1.0 起,对字符串应用空索引操作符会抛出致命错误。以前,字符串被静默地转换为数组。
- 从 PHP 8.1.0 起,弃用从 false 值中创建一个新数组。 但仍然允许从 null 或者未定义的变量中创建新数组。
要修改某个值,通过其键名给该单元赋一个新值。要删除某键值对,对其调用 unset() 函数。
<?php $arr = array(5 => 1, 12 => 2); $arr[] = 56; // 这与 $arr[13] = 56 相同; // 在脚本的这一点上 $arr["x"] = 42; // 添加一个新元素 // 键名使用 "x" unset($arr[5]); // 从数组中删除元素 unset($arr); // 删除整个数组 ?>
注意:如上所述,如果给出方括号但没有指定键名,则取当前最大 int 索引值,新的键名将是该值加上 1(但是最小为 0)。如果当前还没有 int 索引,则键名将为 0 。
这里所使用的最大整数键名目前不需要存在于 array 中。 它只要在上次 array 重新生成索引后曾经存在于 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 )
4、数组解包
可以使用 [](自 PHP 7.1.0 起)或者 list() 语言结构解包数组。这些结构可用于将数组解包为不同的变量。
<?php $source_array = ['foo', 'bar', 'baz']; [$foo, $bar, $baz] = $source_array; echo $foo; // 打印 "foo" echo $bar; // 打印 "bar" echo $baz; // 打印 "baz" ?>
数组解包可用于 foreach 在迭代多维数组时对其进行解包。
<?php $source_array = [ [1, 'John'], [2, 'Jane'], ]; foreach ($source_array as [$id, $name]) { // 这里是 $id 和 $name 的逻辑 } ?>
如果变量未提供,数组元素将会被忽略。数组解包始终从索引 0 开始。
<?php $source_array = ['foo', 'bar', 'baz']; // 将索引 2 的元素分配给变量 $baz [, , $baz] = $source_array; echo $baz; // 打印 "baz" ?>
自 PHP 7.1.0 起,也可以解包关联数组。这在数字索引数组中更容易选择正确的元素,因为可以显式指定索引。
<?php $source_array = ['foo' => 1, 'bar' => 2, 'baz' => 3]; // 将索引 'baz' 处的元素分配给变量 $three ['baz' => $three] = $source_array; echo $three; // 打印 3 $source_array = ['foo', 'bar', 'baz']; // 将索引 2 处的元素分配给变量 $baz [2 => $baz] = $source_array; echo $baz; // 打印 "baz" ?>
数组解包可以方便的用于两个变量交换。
<?php $a = 1; $b = 2; [$b, $a] = [$a, $b]; echo $a; // 打印 2 echo $b; // 打印 1 ?>
注意:
- 分配时不支持展开运算符(…)。
- 尝试访问未定义的数组键与访问任何未定义的变量相同:都将发出 E_WARNING 级别的错误消息(PHP 8.0.0 之前是 E_NOTICE 级别),结果将是 null。
二、实用函数
注意:unset() 函数允许删除 array 中的某个键。但要注意数组将不会重建索引。如果需要删除后重建索引,可以用 array_values() 函数重建 array 索引。
<?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); // 现在 $b 是 array(0 => 'one', 1 =>'three') ?>
foreach 控制结构是专门用于 array 的。它提供了一个简单的方法来遍历array。
三、转换为数组
对于任意 int,float, string,bool 和 resource 类型,如果将一个值转换为 array,将得到一个仅有一个元素的数组,其下标为 0,该元素即为此标量的值。换句话说,(array)$scalarValue 与 array($scalarValue) 完全一样。
如果将 object 类型转换为 array,则结果为一个数组,其单元为该对象的属性。键名将为成员变量名,不过有几点例外:整数属性不可访问; 私有变量前会加上类名作前缀;保护变量前会加上一个 ‘*’ 做前缀。这些前缀的前后都各有一个 NUL 字节。 未初始化的类型属性将会被丢弃。
<?php class A { private $B; protected $C; public $D; function __construct() { $this->{1} = null; } } var_export((array) new A()); ?>
以上示例会输出:
array ( '' . "\0" . 'A' . "\0" . 'B' => NULL, '' . "\0" . '*' . "\0" . 'C' => NULL, 'D' => NULL, 1 => NULL, )
这些 NUL 会导致一些意想不到的行为:
<?php class A { private $A; // 将变为 '\0A\0A' } class B extends A { private $A; // 将变为 '\0B\0A' public $AA; // 将变为 'AA' } var_dump((array) new B()); ?>
以上示例会输出:
array(3) { ["BA"]=> NULL ["AA"]=> NULL ["AA"]=> NULL }
上例会有两个键名为 ‘AA’,不过其中一个实际上是 ‘\0A\0A’。另外,将 null 转换为 array 会得到一个空的数组。
四、数组解包
在 array 定义时,用 … 前缀的一个 array 可以被展开到当前位置。 只有实现了 Traversable 的数组和对象才能被展开。 PHP 7.4.0 开始可以使用 … 解包 array。它可以多次使用,在 … 操作符前后都可以添加常规元素:
示例 :简单的数组解包
<?php // 使用简短的数组语法。 // 亦可用于 array() 语法 $arr1 = [1, 2, 3]; $arr2 = [...$arr1]; //[1, 2, 3] $arr3 = [0, ...$arr1]; //[0, 1, 2, 3] $arr4 = [...$arr1, ...$arr2, 111]; //[1, 2, 3, 1, 2, 3, 111] $arr5 = [...$arr1, ...$arr1]; //[1, 2, 3, 1, 2, 3] function getArr() { return ['a', 'b']; } $arr6 = [...getArr(), 'c' => 'd']; //['a', 'b', 'c' => 'd'] ?>
… 操作符解包 array 时也遵守函数 array_merge() 的语义。 也就是说,key 为字符时,后面的字符键会覆盖之前的字符键;key 为 integer 时则会重新编号:
示例 :重复 key 的数组解包
<?php // string key $arr1 = ["a" => 1]; $arr2 = ["a" => 2]; $arr3 = ["a" => 0, ...$arr1, ...$arr2]; var_dump($arr3); // ["a" => 2] // integer key $arr4 = [1, 2, 3]; $arr5 = [4, 5, 6]; $arr6 = [...$arr4, ...$arr5]; var_dump($arr6); // [1, 2, 3, 4, 5, 6] // 即 [0 => 1, 1 => 2, 2 => 3, 3 => 4, 4 => 5, 5 => 6] // 也就是原始的 integer key 不再保留 ?>
注意:
既不是 integer 也不是 string 的 key 会抛出 TypeError。 这类 key 只能通过 Traversable 对象生成。
在 PHP 8.1 之前,带有 string 键的 array 无法解包:
<?php $arr1 = [1, 2, 3]; $arr2 = ['a' => 4]; $arr3 = [...$arr1, ...$arr2]; // Fatal error: Uncaught Error: Cannot unpack array with string keys in example.php:5 $arr4 = [1, 2, 3]; $arr5 = [4, 5]; $arr6 = [...$arr4, ...$arr5]; // works. [1, 2, 3, 4, 5] ?>
五、示例
PHP 中的数组类型有非常多的用途。以下是一些示例:
<?php // This: $a = array( 'color' => 'red', 'taste' => 'sweet', 'shape' => 'round', 'name' => 'apple', 4 // 键名为 0 ); $b = array('a', 'b', 'c'); // . . .完全等同于: $a = array(); $a['color'] = 'red'; $a['taste'] = 'sweet'; $a['shape'] = 'round'; $a['name'] = 'apple'; $a[] = 4; // 键名为 0 $b = array(); $b[] = 'a'; $b[] = 'b'; $b[] = 'c'; // 执行上述代码后,数组 $a 将是 // array('color' => 'red', 'taste' => 'sweet', 'shape' => 'round', // 'name' => 'apple', 0 => 4), 数组 $b 将是 // array(0 => 'a', 1 => 'b', 2 => 'c'), 或简单的 array('a', 'b', 'c'). ?>
示例:使用 array()
<?php // Array as (property-)map $map = array( 'version' => 4, 'OS' => 'Linux', 'lang' => 'english', 'short_tags' => true ); // 严格的数字键 $array = array( 7, 8, 0, 156, -10 ); // 这相当于 array(0 => 7, 1 => 8, ...) $switching = array( 10, // key = 0 5 => 6, 3 => 7, 'a' => 4, 11, // key = 6 (整数索引的最大值为 5) '8' => 2, // key = 8 (整数!) '02' => 77, // key = '02' 0 => 12 // 值 10 被 12 覆盖 ); // 空数组 $empty = array(); ?>
示例 :集合
<?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?
可以通过引用传递 array 的值来直接更改数组的值。
示例 : 在循环中改变单元
<?php foreach ($colors as &$color) { $color = strtoupper($color); } unset($color); /* 确保后面对 $color 的写入不会修改最后一个数组元素 */ print_r($colors); ?>
以上示例会输出:
Array ( [0] => RED [1] => BLUE [2] => GREEN [3] => YELLOW )
本例生成一个下标从 1 开始的数组。
示例:下标从 1 开始的数组
<?php $firstquarter = array(1 => 'January', 'February', 'March'); print_r($firstquarter); ?>
以上示例会输出:
Array ( [1] => 'January' [2] => 'February' [3] => 'March' )
示例 : 填充数组
<?php // 把指定目录中的所有项填充到数组 $handle = opendir('.'); while (false !== ($file = readdir($handle))) { $files[] = $file; } closedir($handle); ?>
Array 是有序的,也可以使用不同的排序函数来改变顺序。可以用 count() 函数来统计出 array 中元素的个数。
示例 :数组排序
<?php sort($files); print_r($files); ?>
因为 array 中的值可以为任意值,也可是另一个 array。这样可以产生递归或多维 array。
示例 : 递归和多维数组
<?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" ) ); // 处理上面数组中的值的一些例子 echo $fruits["holes"][5]; // 打印 "second" echo $fruits["fruits"]["a"]; // 打印 "orange" unset($fruits["holes"][0]); // 删除 "first" // 创建一个新的多维数组 $juices["apple"]["green"] = "good"; ?>
Array 的赋值总是会涉及到值的拷贝。使用 引用运算符 通过引用来拷贝 array。
<?php $arr1 = array(2, 3); $arr2 = $arr1; $arr2[] = 4; // $arr2 已更改, // $arr1 仍然是 array(2, 3) $arr3 = &$arr1; $arr3[] = 4; // 现在 $arr1 和 $arr3 是一样的 ?>