使用 array() 指定

可以使用 array() 語言結構建立 陣列。它接受任意數量的以逗號分隔的 鍵 => 值 對作為參數。

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

最後一個陣列元素後的逗號是可選的，可以省略。這通常用於單行陣列，例如，array(1, 2) 優於 array(1, 2, )。另一方面，對於多行陣列，通常使用尾隨逗號，因為它允許更容易地在末尾添加新元素。

注意:

存在一種簡短的陣列語法，可以用 [] 取代 array()。

鍵 可以是 int 或 string。值 可以是任何型別。

此外，將會發生以下 鍵 的型別轉換

• 包含有效十進制 int 的 字串，除非該數字前面帶有 + 號，否則將轉換為 int 型別。例如，鍵 "8" 實際上將以 8 的形式儲存。另一方面，"08" 不會轉換，因為它不是有效的十進制整數。
• 浮點數 也會轉換為 int，這表示小數部分將會被截斷。例如，鍵 8.7 實際上將以 8 的形式儲存。
• 布林值 也會轉換為 int，也就是說，鍵 true 實際上將以 1 的形式儲存，而鍵 false 將以 0 的形式儲存。
• Null 將轉換為空字串，也就是說，鍵 null 實際上將以 "" 的形式儲存。
• 陣列 和 物件不能 用作鍵。這樣做將會導致警告：Illegal offset type。

如果陣列宣告中的多個元素使用相同的鍵，則只會使用最後一個，因為所有其他元素都會被覆寫。

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

PHP 陣列可以同時包含 int 和 string 鍵，因為 PHP 不區分索引陣列和關聯陣列。

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

鍵 是可選的。如果未指定，PHP 將使用先前使用的最大 int 鍵的遞增值。

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

array(2) {
  [-5]=>
  int(1)
  [-4]=>
  int(2)
}

array(2) {
  [-5]=>
  int(1)
  [0]=>
  int(2)
}

使用方括號語法存取陣列元素

可以使用 array[key] 語法存取陣列元素。

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

注意:

在 PHP 8.0.0 之前，方括號和花括號可以互換使用來存取陣列元素 (例如，在上面的範例中，$array[42] 和 $array{42} 都會做相同的事情)。花括號語法從 PHP 7.4.0 開始被棄用，並且從 PHP 8.0.0 開始不再支援。

注意:

嘗試存取尚未定義的陣列鍵值，就像存取任何其他未定義的變數一樣：會發出 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。

使用方括號語法建立/修改

可以透過在現有的 array 中明確設定值來修改它。

這是透過將值指定給 array，並在方括號中指定鍵值來完成的。也可以省略鍵值，產生一對方括號 ([])。

$arr[key] = value;
$arr[] = value;
// key may be an int or string
// value may be any value of any type

如果 $arr 尚未存在或設定為 null 或 false，它將會被建立，因此這也是建立 array 的替代方法。然而，不建議這樣做，因為如果 $arr 已經包含一些值 (例如，來自請求變數的 string)，那麼該值將會保留在原位，並且 [] 可能實際上代表字串存取運算子。始終最好透過直接賦值來初始化變數。

注意: 從 PHP 7.1.0 開始，在字串上應用空索引運算子會拋出致命錯誤。以前，字串會靜默轉換為陣列。

注意: 從 PHP 8.1.0 開始，從 false 值建立新的陣列已被棄用。仍然允許從 null 和未定義的值建立新的陣列。

若要變更特定值，請使用其鍵值將新值指定給該元素。若要移除鍵值/值對，請對其呼叫 unset() 函數。

注意:

如上所述，如果未指定鍵值，則會取現有 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
)

陣列解構

陣列可以使用 [] （自 PHP 7.1.0 起）或 list() 語言結構來解構。這些結構可以用於將陣列解構成不同的變數。

陣列解構可以用在 foreach 中，在迭代多維陣列時解構它。

如果沒有提供變數，則會忽略陣列元素。陣列解構總是從索引 0 開始。

自 PHP 7.1.0 起，也可以解構關聯陣列。這也允許更輕鬆地選擇數字索引陣列中的正確元素，因為可以明確指定索引。

陣列解構可以用於輕鬆交換兩個變數。

注意:

展開運算符號（...）在賦值中不支援。

注意:

嘗試存取尚未定義的陣列鍵值，就像存取任何其他未定義的變數一樣：會發出 E_WARNING 級別的錯誤訊息 (在 PHP 8.0.0 之前為 E_NOTICE 級別)，結果將會是 null。

為什麼 $foo[bar] 是錯誤的？

始終在字串文字陣列索引周圍使用引號。例如，$foo['bar'] 是正確的，而 $foo[bar] 是不正確的。但為什麼呢？在舊腳本中經常會遇到這種語法。

這是錯誤的，但它可以工作。原因是因為此程式碼具有一個未定義的常數（bar），而不是一個 string（'bar' - 請注意引號）。它可以工作的原因是 PHP 會自動將裸字串（一個未加引號且不對應於任何已知符號的 string）轉換為一個包含該裸字串的 string。例如，如果沒有定義名為 bar 的常數，那麼 PHP 將替換為 string 'bar' 並使用它。

注意： 這並不意味著要總是將鍵加上引號。請勿將 常數 或 變數 的鍵加上引號，因為這會阻止 PHP 解釋它們。

<?php
error_reporting(E_ALL);
ini_set('display_errors', true);
ini_set('html_errors', false);
// 簡單陣列：
$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";
}
?>

上述範例將會輸出

Checking 0: 
Notice: Undefined index:  $i in /path/to/script.html on line 9
Bad: 
Good: 1
Notice: Undefined index:  $i in /path/to/script.html on line 11
Bad: 
Good: 1

Checking 1: 
Notice: Undefined index:  $i in /path/to/script.html on line 9
Bad: 
Good: 2
Notice: Undefined index:  $i in /path/to/script.html on line 11
Bad: 
Good: 2

更多範例來說明這個行為

當 error_reporting 設定為顯示 E_NOTICE 等級錯誤（例如，設定為 E_ALL），此類用法會立即顯現出來。預設情況下，error_reporting 設定為不顯示通知。

如在語法章節中所述，方括號（'[' 和 ']'）內部的內容必須是一個表達式。這表示像這樣的程式碼可以運作

這是使用函數傳回值作為陣列索引的範例。PHP 也知道常數

請注意，E_ERROR 也是一個有效的識別符號，就像第一個範例中的 bar 一樣。但最後一個範例實際上與寫入以下內容相同

因為 E_ERROR 等於 1，依此類推。