PHP 陣列同時支援有序映射 (關聯陣列) 與列表 (索引陣列),靈活強大但也易產生索引混亂、鍵值遺漏等問題。本文系統整理陣列索引與鍵值核心操作、陷阱避坑、效能技巧與現代 PHP 8+ 新語法。
<?php
// 1. 短語法 (PHP 5.4+)
$indexed = ['a', 'b', 'c']; // 索引 0,1,2
$assoc = ['id' => 1, 'name' => 'Tom']; // 關聯鍵
// 2. 自動索引:空括號追加
$arr = ['a', 'b'];
$arr[] = 'c'; // 索引自動為 3 (最大整數索引 + 1)
// 3. 指定數值索引會影響後續自動索引
$arr = ['a', 'b'];
$arr[9] = 'Simon'; // 索引 9
$arr[] = 'Auto'; // 索引變 10 (max(9)+1)
// 4. 負數索引合法但不影響自動索引
$arr[-5] = 'neg';
$arr[] = 'next'; // 索引 10 (max(9, -5)+1 = 10)
| 操作 | 函數/語法 | 特性 |
|---|---|---|
| 新增/更新單一元素 | $arr[$key] = $val | 鍵存在則更新,不存在則新增 |
| 批次新增/更新 | $arr += $other (聯集) | 左側優先,不覆蓋既有鍵 |
| 合併並覆蓋 | array_merge($a, $b) | 右側覆蓋,數值鍵重新索引 |
| 遞迴合併 | array_merge_recursive() | 同鍵值包成陣列 |
| 刪除單一元素 | unset($arr[$key]) | 保留鍵值空洞,不重新索引 |
| 刪除多個元素 | array_diff_key($arr, $keys) | 依鍵差集刪除,保留索引 |
| 重新索引 (0,1,2...) | array_values($arr) | 捨棄原鍵,重建連續索引 |
| 檢查鍵存在 | array_key_exists($key, $arr) / isset($arr[$key]) | isset 若值為 null 回傳 false |
| 取得所有鍵 | array_keys($arr) | 回傳鍵陣列 |
| 取得所有值 | array_values($arr) | 回傳值陣列 (同時重新索引) |
| 鍵值互換 | array_flip($arr) | 值必須唯一且為字串/整數 |
| 反轉順序 | array_reverse($arr, true) | 第 2 參數 true 保留鍵值 |
<?php
// 建立
$arr = [0 => 1, 1 => 2, 2 => 3, 3 => 4, 6 => 5];
print_r($arr);
/*
Array ( [0]=>1 [1]=>2 [2]=>3 [3]=>4 [6]=>5 ) // 索引 4,5 空洞
*/
// 更新
$arr[2] = 100;
print_r($arr); // [2] => 100
// 新增字串鍵
$arr['X'] = 50;
print_r($arr); // [X] => 50
// 刪除所有元素但保留陣列結構 (錯誤示範)
foreach ($arr as $k => $v) {
unset($arr[$k]); // 迭代中 unset 安全,但陣列變空
}
print_r($arr); // Array ( )
// 正確清空:$arr = []; 或 $arr = array();
// 重新添加 (索引從 0 開始,因陣列已空)
$arr[] = 25; // 索引 0
print_r($arr); // [0] => 25
// 手動重新索引
$arr = [10 => 'a', 20 => 'b'];
$arr = array_values($arr); // [0 => 'a', 1 => 'b']
$arr[] = 13; // 索引 2
print_r($arr);
<?php
$arr = ['user_id' => 1, 'user_name' => 'Tom', 'user_email' => 'tom@example.com'];
// 鍵名駝峰
$camel = array_combine(
array_map(fn($k) => lcfirst(str_replace('_', '', ucwords($k, '_'))), array_keys($arr)),
array_values($arr)
);
// ['userId' => 1, 'userName' => 'Tom', 'userEmail' => 'tom@example.com']
// 加前綴
$prefixed = array_combine(
array_map(fn($k) => 'prefix_' . $k, array_keys($arr)),
array_values($arr)
);
<?php
$data = ['a' => 10, 'b' => 20, 'c' => 5, 'd' => 30, 'e' => 15];
// 保留值 > 15
$filtered = array_filter($data, fn($v) => $v > 15); // ['b'=>20, 'd'=>30]
// ARRAY_FILTER_USE_KEY 依鍵篩選
$byKey = array_filter($data, fn($k) => $k !== 'c', ARRAY_FILTER_USE_KEY);
// 依鍵取子集
$subset = array_intersect_key($data, array_flip(['a', 'c', 'e'])); // ['a'=>10, 'c'=>5, 'e'=>15]
<?php
// 扁平化巢狀陣列
$nested = [1, [2, 3], [4, [5, 6]]];
$flat = array_merge(...array_map(
fn($v) => is_array($v) ? array_merge(...array_map(fn($x) => is_array($x) ? $x : [$x], $v)) : [$v],
$nested
)); // [1,2,3,4,5,6] (簡化版,深層需遞迴)
// 分組:依欄位值分組
$users = [
['id'=>1, 'dept'=>'IT'], ['id'=>2, 'dept'=>'HR'], ['id'=>3, 'dept'=>'IT']
];
$grouped = [];
foreach ($users as $u) {
$grouped[$u['dept']][] = $u;
}
// ['IT' => [...], 'HR' => [...]]
foreach 參考傳遞副作用$arr = [1,2,3];
foreach ($arr as &$v) $v *= 2;
foreach ($arr as $v) {} // 第二次迴圈 $v 仍是參考!
// $arr 最後一個元素會被覆蓋
unset($v); // 關鍵:解除參考
array_shift/pop 會重新索引unset($arr[key($arr)]) 保留鍵。in_array 嚴格模式'123' == 123 為 true,務必加 true 第三參數:in_array($needle, $haystack, true)。[] == null 為 true,[] === null 為 false。判空用 empty($arr) 或 count($arr) === 0。$arr['123'] = 'x' 實際鍵為整數 123;$arr['0123'] 保留字串。避免數值字串當鍵。<?php
// 1. 解構賦值 (PHP 7.1+)
[$a, $b, $c] = [1, 2, 3];
['id' => $id, 'name' => $name] = ['id' => 1, 'name' => 'Tom'];
// 2. 陣列解構合併 (PHP 7.4+)
$merged = [...$arr1, ...$arr2]; // 列表合併,重新索引
$mergedAssoc = $arr1 + $arr2; // 關聯合併,左側優先 (無新語法)
// 3. readonly 陣列 (PHP 8.1+ 需搭配物件)
// 陣列本身不可 readonly,但可用物件封裝
final class ReadonlyArray {
public function __construct(public readonly array $data) {}
public function get(string $key, mixed $default = null) { return $this->data[$key] ?? $default; }
}
// 4. array_is_list() (PHP 8.1+) 判斷是否為列表 (連續整數鍵從 0 開始)
$list = ['a', 'b', 'c'];
$assoc = ['x' => 1, 'y' => 2];
var_dump(array_is_list($list)); // true
var_dump(array_is_list($assoc)); // false
isset 是語言結構,比函數呼叫快。foreach ($arr as &$v) $v = ... 避免複製,記得 unset($v)。$arr = []; $arr[10000] = 'x'; 會預先分配,但通常不需手動優化。for ($i=0, $n=count($arr); $i<$n; $i++) 或直接 foreach。PHP 陣列是「有序映射」混合體,理解索引行為、鍵值語意、函數副作用,能寫出更簡潔、高效、無 Bug 的代碼。善用 array_* 函數族群與現代語法,讓陣列操作成為你的得力工具而非隱患!