PHP 陣列兼具列表、映射、集合、堆疊、隊列特性,是核心資料結構。整理高頻操作分類速查,代碼可直接複製測試。
$arr = ['xx' => '叉叉', 'yy' => '歪歪']; // 關聯陣列
$arr = range(0, 20, 2); // 0,2,4...20 等差數列
$arr = range('A', 'N'); // 字母序列
$arr = array_fill(0, 5, 'default'); // [0=>'default', 1=>'default', ...]
$val = $arr['xx'] ?? '預設值'; // PHP 7+ null 聯合運算子,避免 Notice
$count = count($arr); // 元素個數
is_array($var); // 判斷是否陣列
isset($arr['key']); // 鍵存在且非 null
array_key_exists('key', $arr); // 鍵存在 (含 null 值)
in_array('value', $arr); // 值存在 (嚴格模式第 3 參數 true)
array_search('value', $arr); // 找值返回鍵 (找不到 false)
// 尾部推入
array_push($arr, 'a', 'b'); // 返回新長度
$arr[] = 'c'; // 更簡潔
// 頭部推入
array_unshift($arr, 'first'); // 返回新長度,數值鍵重新索引
// 尾部彈出
$last = array_pop($arr); // 返回被彈出值
// 頭部彈出
$first = array_shift($arr); // 返回被彈出值,數值鍵重新索引
// 指定位置插入/刪除/替換
array_splice($arr, 2, 1, ['new']); // 從索引 2 刪 1 個,插入 'new'
$a = ['a' => 1, 'b' => 2];
$b = ['b' => 3, 'c' => 4];
// 合併:字串鍵後者覆蓋,數值鍵重新索引附加
$merged = array_merge($a, $b); // ['a'=>1, 'b'=>3, 'c'=>4, 0=>...]
// 遞歸合併:字串鍵遇同名合併為陣列
$rec = array_merge_recursive($a, $b); // ['a'=>1, 'b'=>[2,3], 'c'=>4]
// 鍵值互換
$flipped = array_flip($arr); // 值變鍵,鍵變值 (值必須唯一)
// 以一陣列為鍵、另一陣列為值建立關聯陣列
$keys = ['id', 'name'];
$vals = [1, 'Tom'];
$combined = array_combine($keys, $vals); // ['id'=>1, 'name'=>'Tom']
| 函數 | 排序依據 | 鍵值關係 | 順序 |
|---|---|---|---|
sort() | 值 | 重置數值鍵 | 升序 |
rsort() | 值 | 重置數值鍵 | 降序 |
asort() | 值 | 保持關聯 | 升序 |
arsort() | 值 | 保持關聯 | 降序 |
ksort() | 鍵 | 保持關聯 | 升序 |
krsort() | 鍵 | 保持關聯 | 降序 |
natsort() | 值 (自然排序) | 保持關聯 | 升序 |
natcasesort() | 值 (自然排序、不分大小寫) | 保持關聯 | 升序 |
usort() | 自訂比較函數 | 重置數值鍵 | 自訂 |
uasort() | 自訂比較函數 | 保持關聯 | 自訂 |
uksort() | 自訂鍵比較函數 | 保持關聯 | 自訂 |
自然排序範例: ['a1','a3','a10','a22'] → ['a1','a3','a10','a22'] (一般排序會變 a1,a10,a22,a3)。
// 最常用
foreach ($arr as $key => $val) { ... }
// 僅需值
foreach ($arr as $val) { ... }
// 內部指標操作 (較少用)
while (list($key, $val) = each($arr)) { ... } // PHP 7.2 棄用
reset($arr); next($arr); prev($arr); end($arr); key($arr); current($val);
$arr = ['a','b','a','c','b'];
array_count_values($arr); // ['a'=>2, 'b'=>2, 'c'=>1]
array_unique($arr); // ['a','b','c'] (保留首次出現鍵)
array_reverse($arr); // 反轉順序
name
// 過濾
$filtered = array_filter($arr, fn($v) => $v > 10); // PHP 7.4+ 箭頭函數
// 映射轉換
$mapped = array_map(fn($v) => $v * 2, $arr);
// 減少 (聚合)
$sum = array_reduce($arr, fn($carry, $v) => $carry + $v, 0);
// 鍵是否存在 (效能優於 in_array 大陣列)
$exists = isset($map[$key]); // O(1) vs O(n)
in_array 大陣列極慢 (O(n)),頻繁查找請先 array_flip 或建立 isset 查找表。array_merge 會重置數值鍵,關聯陣列合併用 + 運算子保留首次鍵:$a + $b。foreach 遍歷時修改陣列會導致不可預期行為,需先複製或用引用 &$val 修改值。array_column、array_map、RecursiveIteratorIterator。收藏此表,寫 PHP 操作陣列不再查手冊。