Array 數(shù)組

定義數(shù)組 array()

可以用 array() 語言結(jié)構(gòu)來新建一個 array。它接受任意數(shù)量用逗號分隔的 鍵（key） => 值（value） 對。

array(
    key  => value,
    key2 => value2,
    key3 => value3,
    ...
)

最后一個數(shù)組單元之后的逗號可以省略。通常用于單行數(shù)組定義中，例如常用 array(1, 2) 而不是 array(1, 2, )。對多行數(shù)組定義通常保留最后一個逗號，這樣要添加一個新單元時更方便。

注意:

可以用短數(shù)組語法 [] 替代 array() 。

key 可以是 integer 或者 string。value 可以是任意類型。

此外 key 會有如下的強(qiáng)制轉(zhuǎn)換：

• String 中包含有效的十進(jìn)制 int，除非數(shù)字前面有一個 + 號，否則將被轉(zhuǎn)換為 int 類型。例如鍵名 "8" 實(shí)際會被儲存為 8。另外， "08" 不會被強(qiáng)制轉(zhuǎn)換，因?yàn)樗皇且粋€有效的十進(jìn)制整數(shù)。
• Float 也會被轉(zhuǎn)換為 int ，意味著其小數(shù)部分會被舍去。例如鍵名 8.7 實(shí)際會被儲存為 8。
• Bool 也會被轉(zhuǎn)換成 int。即鍵名 true 實(shí)際會被儲存為 1 而鍵名 false 會被儲存為 0。
• Null 會被轉(zhuǎn)換為空字符串，即鍵名 null 實(shí)際會被儲存為 ""。
• Array 和 object 不能 被用為鍵名。堅(jiān)持這么做會導(dǎo)致警告：Illegal offset type。

如果在數(shù)組定義時多個元素都使用相同鍵名，那么只有最后一個會被使用，其它的元素都會被覆蓋。

array(1) {
  [1]=>
  string(1) "d"
}

PHP 數(shù)組可以同時含有 int 和 string 類型的鍵名，因?yàn)? PHP 實(shí)際并不區(qū)分索引數(shù)組和關(guān)聯(lián)數(shù)組。

array(4) {
  ["foo"]=>
  string(3) "bar"
  ["bar"]=>
  string(3) "foo"
  [100]=>
  int(-100)
  [-100]=>
  int(100)
}

key 為可選項(xiàng)。如果未指定，PHP 將自動使用之前用過的最大 int 鍵名加上 1 作為新的鍵名。

array(4) {
  [0]=>
  string(3) "foo"
  [1]=>
  string(3) "bar"
  [2]=>
  string(5) "hello"
  [3]=>
  string(5) "world"
}

還可以只對某些單元指定鍵名而對其它的空置：

array(4) {
  [0]=>
  string(1) "a"
  [1]=>
  string(1) "b"
  [6]=>
  string(1) "c"
  [7]=>
  string(1) "d"
}

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"
}

用方括號語法訪問數(shù)組單元

數(shù)組單元可以通過 array[key] 語法來訪問。

string(3) "bar"
int(24)
string(3) "foo"

注意:

在 PHP 8.0.0 之前，方括號和花括號可以互換使用來訪問數(shù)組單元（例如 $array[42] 和 $array{42} 在上例中效果相同）。 花括號語法在 PHP 7.4.0 中已棄用，在 PHP 8.0.0 中不再支持。

注意:

試圖訪問一個未定義的數(shù)組鍵名與訪問任何未定義變量一樣：會導(dǎo)致 E_NOTICE 級別錯誤信息，其結(jié)果為 null。

注意:

數(shù)組解引用非 string 的標(biāo)量值會產(chǎn)生 null。 在 PHP 7.4.0 之前，它不會發(fā)出錯誤消息。 從 PHP 7.4.0 開始，這個問題產(chǎn)生 E_NOTICE ； 從 PHP 8.0.0 開始，這個問題產(chǎn)生 E_WARNING 。

用方括號的語法新建／修改

可以通過明示地設(shè)定其中的值來修改現(xiàn)有的 array 。

這是通過在方括號內(nèi)指定鍵名來給 array 賦值實(shí)現(xiàn)的。也可以省略鍵名，在這種情況下給變量名加上一對空的方括號（[]）。

$arr[key] = value;
$arr[] = value;
// key 可以是 int 或 string
// value 可以是任意類型的值

如果 $arr 不存在或者設(shè)置為 null 或者 false，將會新建它，這也是另一種創(chuàng)建 array 的方法。不過并不鼓勵這樣做，因?yàn)槿绻? $arr 已經(jīng)包含有值（例如來自請求變量的 string）則此值會保留而 [] 實(shí)際上代表著字符串訪問運(yùn)算符。初始化變量的最好方式是直接給其賦值。

注意: 從 PHP 7.1.0 起，對字符串應(yīng)用空索引操作符會拋出致命錯誤。以前，字符串被靜默地轉(zhuǎn)換為數(shù)組。

注意: 從 PHP 8.1.0 起，棄用從 false 值中創(chuàng)建一個新數(shù)組。 但仍然允許從 null 或者未定義的變量中創(chuàng)建新數(shù)組。

要修改某個值，通過其鍵名給該單元賦一個新值。要刪除某鍵值對，對其調(diào)用 unset() 函數(shù)。

注意:

如上所述，如果給出方括號但沒有指定鍵名，則取當(dāng)前最大 int 索引值，新的鍵名將是該值加上 1（但是最小為 0）。如果當(dāng)前還沒有 int 索引，則鍵名將為 0 。

注意這里所使用的最大整數(shù)鍵名目前不需要存在于 array 中。 它只要在上次 array 重新生成索引后曾經(jīng)存在于 array 就行了。以下面的例子來說明：

<?php
// 創(chuàng)建一個簡單的數(shù)組
$array = array(1, 2, 3, 4, 5);
print_r($array);

// 現(xiàn)在刪除其中的所有元素，但保持?jǐn)?shù)組本身不變:
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
)

為什么 $foo[bar] 錯了？

應(yīng)該始終在用字符串表示的數(shù)組索引上加上引號。例如用 $foo['bar'] 而不是 $foo[bar]。但是為什么呢？可能在老的腳本中見過如下語法：

這樣是錯的，但可以正常運(yùn)行。那么為什么錯了呢？原因是此代碼中有一個未定義的常量（ bar ）而不是 string（'bar'－注意引號）。而 PHP 可能會在以后定義此常量，不幸的是你的代碼中有同樣的名字。它能運(yùn)行，是因?yàn)? PHP 自動將裸字符串（沒有引號的 string 且不對應(yīng)于任何已知符號）轉(zhuǎn)換成一個其值為該裸 string 的 string。例如，如果沒有常量定義為 bar，那么PHP 將在 string 中替代為 'bar' 并使用之。

注意: 這并不意味著總是給鍵名加上引號。用不著給鍵名為 常量 或 變量 的加上引號，否則會使 PHP 不能解析它們。

<?php
error_reporting(E_ALL);
ini_set('display_errors', true);
ini_set('html_errors', false);
// 簡單數(shù)組:
$array = array(1, 2);
$count = count($array);
for ($i = 0; $i < $count; $i++) {
    echo "\n檢查 $i: \n";
    echo "壞的: " . $array['$i'] . "\n";
    echo "好的: " . $array[$i] . "\n";
    echo "壞的: {$array['$i']}\n";
    echo "好的: {$array[$i]}\n";
}
?>

以上例程會輸出：

檢查 0:
Notice: Undefined index:  $i in /path/to/script.html on line 9
壞的:
好的: 1
Notice: Undefined index:  $i in /path/to/script.html on line 11
壞的:
好的: 1

檢查 1:
Notice: Undefined index:  $i in /path/to/script.html on line 9
壞的:
好的: 2
Notice: Undefined index:  $i in /path/to/script.html on line 11
壞的:
好的: 2

演示此行為的更多例子：

當(dāng)打開 error_reporting 來顯示 E_NOTICE 級別的錯誤（將其設(shè)為 E_ALL）時將看到這些錯誤。默認(rèn)情況下 error_reporting 被關(guān)閉不顯示這些。

和在 語法 一節(jié)中規(guī)定的一樣，在方括號（[” 和 “]”）之間必須有一個表達(dá)式。這意味著可以這樣寫：

這是一個用函數(shù)返回值作為數(shù)組索引的例子。PHP 也可以用已知常量，可能之前已經(jīng)見過：

注意 E_ERROR 也是個合法的標(biāo)識符，就和第一個例子中的 bar 一樣。但是上一個例子實(shí)際上和如下寫法是一樣的：

因?yàn)?E_ERROR 等于 1，等等。