陣列核心函數分類速查
建立與合併
| 函數 | 用途 | 版本 |
| array() / [] | 建立陣列 | 3 |
| array_combine() | 鍵陣列 + 值陣列 → 關聯陣列 | 5 |
| array_merge() | 合併陣列(後覆蓋前,數字鍵重索引) | 4 |
| array_merge_recursive() | 遞迴合併(相同字串鍵合併為陣列) | 4 |
| compact() | 變數 → 關聯陣列 | 4 |
| range() | 建立範圍陣列 | 3 |
鍵值檢查與搜尋
| 函數 | 用途 | 備註 |
| array_key_exists() | 檢查鍵存在 | 鍵值為 null 仍回 true |
| in_array() | 檢查值存在 | 第三參數 true 嚴格模式 |
| array_search() | 搜尋值回傳鍵 | 找不到回 false |
| isset($arr[$key]) | 檢查鍵存在且非 null | 語言結構,非函數,較快 |
鍵值操作
| 函數 | 用途 |
| array_flip() | 交換鍵值(重複值保留最後) |
| array_keys() | 取得所有鍵 |
| array_values() | 取得所有值(重新索引 0...) |
| array_change_key_case() | 鍵名全大/小寫 |
| array_fill() | 指定值填充 |
| array_fill_keys() | 指定鍵+值建立陣列 |
| array_splice() | 移除/替換區段(修改原陣列) |
過濾、映射、歸約
| 函數 | 用途 |
| array_filter() | 回呼過濾元素 |
| array_map() | 回呼映射每個元素 |
| array_walk() | 回呼處理每個元素(可修改原陣列) |
| array_walk_recursive() | 遞迴處理多維陣列 |
| array_reduce() | 回呼歸約為單一值 |
交集、差集、去重
| 函數 | 用途 |
| array_intersect() | 交集(比較值) |
| array_intersect_assoc() | 交集(比較鍵+值) |
| array_intersect_key() | 交集(比較鍵) |
| array_diff() | 差集(值在第一個不在其它) |
| array_diff_assoc() | 差集(鍵+值) |
| array_diff_key() | 差集(鍵) |
| array_unique() | 移除重複值 |
排序函數
| 函數 | 排序依據 | 保持鍵值關聯 |
| sort() | 值 | 否(重新索引) |
| rsort() | 值反向 | 否 |
| asort() | 值 | 是 |
| arsort() | 值反向 | 是 |
| ksort() | 鍵 | 是 |
| krsort() | 鍵反向 | 是 |
| natsort() | 自然排序(值) | 是 |
| natcasesort() | 自然排序不分大小寫 | 是 |
| usort() | 自訂比較函數(值) | 否 |
| uasort() | 自訂比較(值)保持鍵 | 是 |
| uksort() | 自訂比較(鍵) | 是 |
堆疊/佇列操作
| 函數 | 操作 |
| array_push() | 入堆疊(尾部新增) |
| array_pop() | 出堆疊(移除尾部) |
| array_unshift() | 入佇列(頭部新增) |
| array_shift() | 出佇列(移除頭部) |
切片、隨機、統計
| 函數 | 用途 |
| array_slice() | 取出片段(不修改原陣列) |
| array_chunk() | 分割成塊(多維陣列) |
| array_rand() | 隨機取一或多個鍵 |
| shuffle() | 打亂順序(修改原陣列) |
| array_sum() | 值總和 |
| array_product() | 值乘積 |
| array_count_values() | 統計值出現次數 |
| array_reverse() | 反轉順序 |
內部指標控制
| 函數 | 用途 |
| current() / pos() | 目前元素值 |
| key() | 目前元素鍵 |
| next() | 指標前移 |
| prev() | 指標後移 |
| reset() | 指標歸零 |
| end() | 指標移至末尾 |
| each() | 取得目前鍵值並前移(已棄用) |
陣列常數
| 常數 | 用途 |
| CASE_LOWER / CASE_UPPER | array_change_key_case() 參數 |
| SORT_ASC / SORT_DESC | array_multisort() 排序方向 |
| SORT_REGULAR / SORT_NUMERIC / SORT_STRING / SORT_LOCALE_STRING | 比較模式 |
| COUNT_NORMAL / COUNT_RECURSIVE | count() 模式 |
| EXTR_* | extract() 覆蓋/前綴策略 |
常用操作速查卡片
<?php
// 搜尋值 → 鍵
$key = array_search('needle', $haystack);
// 取得所有鍵/值
$keys = array_keys($arr);
$vals = array_values($arr);
// 陣列大小
$n = count($arr); // 或 sizeof($arr)
// 去重
$unique = array_unique($arr);
// 反轉
$rev = array_reverse($arr);
// 交換鍵值
$flipped = array_flip($arr);
// 合併 (字串鍵後覆蓋前,數字鍵重索引)
$merged = array_merge($a, $b);
// 切片 (offset, length)
$slice = array_slice($arr, 2, 3);
// 分塊
$chunks = array_chunk($arr, 100); // 每 100 筆一組
// 隨機取 3 個鍵
$randKeys = array_rand($arr, 3);
// 統計值頻率
$freq = array_count_values($arr);
// 自然排序 (人類直覺順序)
natsort($arr);
// 自訂排序
usort($arr, fn($a,$b) => $a['score'] <=> $b['score']);
?>
效能小撇步
- 頻繁
in_array() 搜尋大陣列 → 改用 isset($flip[$val]) (先 array_flip()),O(1) 查找。
- 大量資料去重 →
array_unique() 較慢,考慮 array_keys(array_flip($arr))。
- 只需鍵或值 →
array_keys()/array_values() 比 foreach 快。