PHP 陣列是有序映射,同時支援列表(向量)、雜湊表(關聯陣列)、堆疊、佇列等多種資料結構,是 PHP 最核心、最靈活的資料型別。本文系統整理陣列分類、建立語法、鍵值轉換規則、多維結構與常見操作陷阱。
| 類型 | 特徵 | 典型用途 |
|---|---|---|
| 數值陣列(索引陣列) | 整數鍵,通常從 0 開始連續遞增 | 有序列表、集合、佇列、堆疊 |
| 關聯陣列 | 字串鍵,鍵值對映射關係 | 字典、設定檔、記錄、JSON 物件對應 |
| 多維陣列 | 陣列元素本身為陣列,可巢狀任意層級 | 表格資料、樹狀結構、矩陣、複雜物件圖 |
注意:PHP 內部無此三類型之分,同一陣列可同時包含整數鍵與字串鍵。
$arr = array(
'foo' => 'bar',
42 => 'answer',
'multi' => array(1, 2, 3)
);
$arr = [
'foo' => 'bar',
42 => 'answer',
'multi' => [1, 2, 3],
];
// 只有值,鍵自動為 0,1,2...
$list = ['apple', 'banana', 'cherry'];
$arr = [];
$arr[] = 'first'; // 鍵 0
$arr[] = 'second'; // 鍵 1
$arr['key'] = 'value'; // 字串鍵
$arr[10] = 'jump'; // 鍵 10,下一個自動鍵為 11
| 原始鍵 | 實際鍵 | 說明 |
|---|---|---|
"8" | 8 (int) | 標準整數字串轉整數 |
"08" | "08" (string) | 前導零非標準整數表示,保留字串 |
3.14 | 3 (int) | 浮點數截斷取整 |
true | 1 (int) | 布林轉整數 |
false | 0 (int) | |
null | "" (string) | null 視為空字串 |
[] / new StdClass() | ❌ Warning | 陣列/物件不可作為鍵 |
$arr = [
1 => 'a',
'1' => 'b', // 同鍵 1,覆蓋為 'b'
true => 'c', // 同鍵 1,覆蓋為 'c'
];
var_dump($arr); // [1 => 'c']
$families = [
'Griffin' => ['Peter', 'Lois', 'Megan'],
'Quagmire' => ['Glenn'],
'Brown' => ['Cleveland', 'Loretta', 'Junior'],
];
// 存取
echo $families['Griffin'][0]; // Peter
echo $families['Brown'][2]; // Junior
$data = [];
$data['users']['john']['email'] = 'john@example.com';
$data['users']['john']['roles'] = ['admin', 'editor'];
$data['users']['jane']['email'] = 'jane@example.com';
// 自動建立中間層級陣列
$arr = ['a' => 1, 'b' => 2];
$val = $arr['a']; // 1
$val = $arr['c'] ?? 'default'; // null 合併運算子(PHP 7.0+),避免 Notice
$val = $arr['c'] ??? 'default'; // PHP 8.0+ nullsafe 鏈式(僅適用物件/可為 null 型別)
$arr['a'] = 10; // 修改
$arr['c'] = 3; // 新增
unset($arr['a']); // 刪除鍵值對
$arr = [1, 2, 3];
$ref = &$arr[1];
$ref = 20;
var_dump($arr); // [1, 20, 3]
foreach ($arr as &$value) {
$value *= 2;
}
unset($value); // 重要:釋放參考,避免後續誤用
var_dump($arr); // [2, 40, 6]
$arr = ['bar' => 'value'];
echo $arr[bar]; // PHP 7.2+ Deprecated: Use of undefined constant bar
// 正確
echo $arr['bar'];
$arr = [1, 2, 3];
foreach ($arr as &$v) { $v *= 2; }
unset($v); // 必須 unset!
foreach ($arr as $v) { // 無參考
// $v 現在會覆蓋 $arr[2] 的值!
}
var_dump($arr); // [2, 4, 4] 😱 最後一個元素被修改
$a = [0 => 'a', 1 => 'b'];
$b = [0 => 'c', 1 => 'd'];
array_merge($a, $b); // [0=>'a', 1=>'b', 2=>'c', 3=>'d'] 重新索引
$a + $b; // [0=>'a', 1=>'b'] 後者不覆蓋前者同鍵
['a','b'] + ['c','d']; // 同 array_merge 行為(字串鍵不同)
$a = [1, 2];
$b = [1, 2];
$c = ['a' => 1, 'b' => 2];
$a == $b; // true 鍵值對相同(順序、型別鬆散比較)
$a === $b; // true 鍵值對相同、順序相同、型別相同
$a == $c; // false 鍵不同(數值 vs 字串)
$a === $c; // false
| 分類 | 函數 | 用途 |
|---|---|---|
| 檢查 | is_array() | 是否為陣列 |
array_key_exists() | 鍵是否存在(值可為 null) | |
in_array() | 值是否存在(嚴格模式第 3 參數 true) | |
isset($arr[$key]) | 鍵存在且值非 null(效能最好) | |
| 新增/刪除 | array_push()/[] | 末尾新增 |
array_unshift() | 開頭新增(重新索引) | |
array_pop() | 移除並回傳最後元素 | |
array_shift() | 移除並回傳第一元素(重新索引) | |
unset($arr[$key]) | 刪除指定鍵(不重新索引) | |
array_splice() | 切片刪除/替換/插入(重新索引) | |
| 合併/切片 | array_merge() | 合併,數值鍵重新索引 |
array_merge_recursive() | 遞迴合併,同鍵值成陣列 | |
array_slice() | 切片(保留鍵可用第 4 參數 true) | |
array_splice() | 原地切片修改 | |
+ 運算子 | 聯集,前者優先 | |
| 排序 | sort()/rsort() | 值排序,重新索引 |
asort()/arsort() | 值排序,保持鍵關聯 | |
ksort()/krsort() | 鍵排序 | |
usort()/uksort() | 自訂比較函數排序 | |
| 進階 | array_map() | 映射轉換每個值 |
array_filter() | 過濾保留符合條件的值 | |
array_reduce() | 減縮為單一值 | |
array_column() | 提取多維陣列單一欄位(PHP 5.5+) |
for 迴圈比 foreach 略快(避免複製),但差異微小isset($arr[$key]) 或將值作為鍵(array_flip())true 的陣列模擬 Set,isset($set[$val]) 為 O(1)unset(),或使用生成器 (yield) 惰性產生PHP 陣列是「有序映射」的統一抽象,同時扮演列表、字典、集合等角色。掌握鍵值轉換規則(整數字串轉整數、浮點數截斷、布林轉 0/1、null 轉空字串)、參考賦值與 foreach 陷阱、合併/聯集運算子差異,是寫出正確、高效 PHP 程式碼的關鍵。現代開發中,善用短語法 []、解構賦值 [$a, $b] = $arr、箭頭函數 fn($x) => $x * 2 搭配 array_map(),能讓陣列操作更簡潔優雅。