PHP 擁有超過 80 個陣列函數,記憶全部分類與參數順序極不現實。本文按功能分類整理核心函數,附上常用範例與效能提示,供開發隨時查閱。
| 函數 | 說明 | 範例 |
|---|---|---|
| current() | 取得目前指標值 | current($arr) |
| key() | 取得目前指標鍵名 | key($arr) |
| next() | 指標後移,回傳新值 | next($arr) |
| prev() | 指標前移 | prev($arr) |
| reset() | 指標歸零,回傳第一個值 | reset($arr) |
| end() | 指標移至末尾,回傳最後值 | end($arr) |
| each() | 回傳目前鍵值並後移(已棄用) | 改用 foreach |
| 函數 | 說明 | 範例 |
|---|---|---|
| array_change_key_case() | 鍵名統一大小寫 | array_change_key_case($arr, CASE_UPPER) |
| array_flip() | 交換鍵值 | array_flip(['a'=>1, 'b'=>2]) → [1=>'a', 2=>'b'] |
| array_keys() | 取得所有鍵名 | array_keys($arr) |
| array_values() | 重新索引(0 起始) | array_values(['a'=>1, 'c'=>2]) → [1,2] |
| 函數 | 說明 | 範例 |
|---|---|---|
| array_merge() | 合併陣列,字串鍵後覆蓋前,數字鍵重新索引 | array_merge([1,2], [3,4]) → [1,2,3,4] |
| array_merge_recursive() | 遞歸合併,相同字串鍵合併為陣列 | 適用多維設定合併 |
| array_chunk() | 切分成固定大小塊 | array_chunk([1..6], 2) → [[1,2],[3,4],[5,6]] |
| array_slice() | 切片(保留鍵名可選) | array_slice($arr, 2, 3, true) |
| array_splice() | 移除並可替換(修改原陣列) | array_splice($arr, 1, 2, ['x','y']) |
| array_fill() | 建立固定值陣列 | array_fill(0, 5, 'x') → ['x','x','x','x','x'] |
| array_fill_keys() | 指定鍵名建立陣列 | array_fill_keys(['a','b'], 0) → ['a'=>0,'b'=>0] |
| 函數 | 說明 | 範例 |
|---|---|---|
| array_filter() | 回呼函數篩選(保留鍵名) | array_filter($arr, fn($v) => $v > 10) |
| array_unique() | 移除重複值(保留首次鍵名) | array_unique([1,2,1,3]) → [1,2,3] |
| array_count_values() | 統計值出現次數 | array_count_values(['a','b','a']) → ['a'=>2,'b'=>1] |
| in_array() | 檢查值是否存在 | in_array('x', $arr, true)(嚴格模式) |
| array_search() | 搜尋值回傳鍵名 | array_search('x', $arr, true) |
| array_key_exists() | 檢查鍵名是否存在 | array_key_exists('k', $arr) |
| array_column() | 提取多維陣列單一欄位 | array_column($users, 'email') |
| 函數 | 排序依據 | 鍵名保留 | 順序 |
|---|---|---|---|
| sort() | 值 | ❌ 重新索引 | 升冪 |
| rsort() | 值 | ❌ | 降冪 |
| asort() | 值 | ✅ | 升冪 |
| arsort() | 值 | ✅ | 降冪 |
| ksort() | 鍵名 | ✅ | 升冪 |
| krsort() | 鍵名 | ✅ | 降冪 |
| natsort() | 值(自然排序) | ✅ | 升冪 |
| natcasesort() | 值(自然、不分大小寫) | ✅ | 升冪 |
| usort() | 自訂比較函數 | ❌ | 自訂 |
| uasort() | 自訂比較函數 | ✅ | 自訂 |
| uksort() | 自訂鍵名比較 | ✅ | 自訂 |
| 操作 | 函數 | 說明 |
|---|---|---|
| 堆疊 (LIFO) | array_push() / array_pop() | 陣列末端推入/彈出 |
| 佇列 (FIFO) | array_unshift() / array_shift() | 陣列前端推入/彈出 |
效能提示:array_shift 需重新索引所有元素,O(n);高頻佇列操作請用 SplQueue 或 SplDoublyLinkedList。
| 函數 | 說明 | 範例 |
|---|---|---|
| array_sum() | 數值加總 | array_sum([1,2,3]) → 6 |
| array_product() | 數值乘積 | array_product([2,3,4]) → 24 |
| array_reduce() | 自訂歸約 | array_reduce($arr, fn($c,$v)=>$c+$v, 0) |
| array_map() | 逐元素映射 | array_map('strtoupper', $arr) |
| array_walk() | 逐元素操作(修改原陣列) | array_walk($arr, fn(&$v)=>$v*=2) |
| array_diff() | 差集(比較值) | array_diff([1,2,3], [2]) → [1,3] |
| array_intersect() | 交集(比較值) | array_intersect([1,2], [2,3]) → [2] |
| array_diff_key() | 差集(比較鍵) | 同上,比較鍵名 |
| array_intersect_key() | 交集(比較鍵) | 同上,比較鍵名 |
$arr = ['name' => 'Tom', 'age' => 25];
extract($arr); // 產生 $name, $var
compact('name', 'age'); // 還原陣列
foreach 而非 array_map/walk(呼叫開銷較低)。usort 而非多次 sort。in_array 搜尋 → 改用 isset($flip[$val])(先 array_flip),O(1) 查找。array_push,直接 $arr[] = $val 更快。array_slice($arr, 0) 建立淺拷貝。熟練掌握核心 20 個陣列函數即可應付 95% 場景。本表可作為開發時的速查卡,建議收藏或匯入 IDE Snippets。