PHP 陣列**同時是有序列表 (List) 與關聯映射 (Map/Hash Table)**,鍵可為 int 或 string,值可為任意型別,支援負索引、稀疏索引、混合鍵。
<?php
// 短語法 (PHP 5.4+)
$arr = [1, 2, 3];
$assoc = ['name' => 'Tom', 'age' => 25];
// array() 傳統語法
$arr = array(1, 2, 3);
// range() 數字/字元序列
range(1, 10); // [1..10]
range(1, 10, 2); // [1,3,5,7,9]
range('a', 'f'); // ['a','b','c','d','e','f']
// 填充值
array_fill(0, 5, 'x'); // [0=>'x', 1=>'x', ...]
array_fill_keys(['a','b'], 0); // ['a'=>0, 'b'=>0]
// 從變數建立 (compact)
$name = 'Tom'; $age = 25;
compact('name', 'age'); // ['name'=>'Tom', 'age'=>25]
<?php
// 二維陣列
$products = [
['code' => 'TIR', 'name' => 'Tires', 'price' => 100],
['code' => 'OIL', 'name' => 'Oil', 'price' => 10],
['code' => 'SPK', 'name' => 'Plugs', 'price' => 4],
];
// 雙重 foreach (推薦)
foreach ($products as $row) {
foreach ($row as $key => $val) {
echo "$key: $val | ";
}
echo "\n";
}
// array_walk 遞歸遍歷 (任意深度)
function walkRecursive($arr, $callback, $depth = 0) {
foreach ($arr as $k => $v) {
if (is_array($v)) {
walkRecursive($v, $callback, $depth + 1);
} else {
$callback($k, $v, $depth);
}
}
}
| 函式 | 排序依據 | 保持鍵值關聯 | 順序 | 回傳值 |
|---|---|---|---|---|
sort() | 值 | ❌ 重建 0..n 索引 | 升序 | bool |
rsort() | 值 | ❌ | 降序 | bool |
asort() | 值 | ✅ | 升序 | bool |
arsort() | 值 | ✅ | 降序 | bool |
ksort() | 鍵 | ✅ | 升序 | bool |
krsort() | 鍵 | ✅ | 降序 | bool |
usort() | 用戶比較函式 | ❌ | 自訂 | bool |
uasort() | 用戶比較函式 | ✅ | 自訂 | bool |
uksort() | 用戶比較鍵 | ✅ | 自訂 | bool |
natsort() | 自然排序 (值) | ✅ | 升序 | bool |
natcasesort() | 自然排序不分大小寫 | ✅ | 升序 | bool |
shuffle() | 隨機打亂 | ❌ | 隨機 | bool |
array_multisort() | 多陣列/多維 | 視情況 | 混合 | bool |
<=> (PHP 7+)<?php
$users = [
['name' => 'Tom', 'age' => 25, 'score' => 90],
['name' => 'Jerry', 'age' => 20, 'score' => 95],
['name' => 'Bob', 'age' => 25, 'score' => 85],
];
// 多欄位:先按 score 降序,再按 age 升序
usort($users, fn($a, $b) =>
[$b['score'], $a['age']] <=> [$a['score'], $b['age']]
);
// 結果:Jerry(95,20), Tom(90,25), Bob(85,25)
| 分類 | 函式 | 用途 | 備註 |
|---|---|---|---|
| 合併/分割 | array_merge() | 合併陣列 (數字鍵重索引) | 字串鍵後覆蓋前 |
array_merge_recursive() | 遞歸合併 (同鍵合為陣列) | ||
array_combine() | 鍵陣列 + 值陣列 → 關聯陣列 | 長度必須相等 | |
array_slice() | 切片 (支援負索引、長度) | 不修改原陣列 | |
array_splice() | 切片並替換 (修改原陣列) | 可插入/刪除/替換 | |
array_chunk() | 分塊 (固定大小) | 分頁處理常用 | |
| 搜尋/過濾 | in_array() | 值是否存在 | 嚴格模式第3參數 true |
array_search() | 搜尋值回傳鍵 | 嚴格模式第3參數 true | |
array_key_exists() | 鍵是否存在 | 含 null 值也回傳 true | |
array_filter() | 回調過濾保留 | ARRAY_FILTER_USE_KEY/BOTH | |
array_diff() | 差集 (值比較) | 僅檢查值,鍵保留 | |
| 轉換/提取 | array_keys() | 取所有鍵 | |
array_values() | 取所有值 (重建 0..n 索引) | ||
array_column() | 提取欄位 (多維陣列神器) | PHP 5.5+ | |
array_map() | 映射轉換每個元素 | 可多陣列並行 | |
array_reduce() | 減縮/聚合 (fold) | 初始值第3參數 | |
| 堆疊/佇列 | array_push() / array_pop() | 堆疊 (尾端進出) | O(1) |
array_unshift() / array_shift() | 佇列 (頭端進出) | O(n) 需重索引 | |
array_reverse() | 反轉順序 | 保留鍵可選 | |
array_flip() | 鍵值互換 | 值重複會覆蓋 | |
| 統計/計數 | count() / sizeof() | 元素個數 | 遞歸計數第2參數 1/COUNT_RECURSIVE |
array_count_values() | 值頻率統計 | 僅標量值 | |
array_sum() | 數值求和 | ||
array_product() | 數值求積 | ||
| 去重/唯一 | array_unique() | 移除重複值 | 保留首次出現鍵,SORT_STRING/REGULAR/NUMERIC |
array_intersect() | 交集 (值比較) | 鍵保留 | |
array_intersect_key() | 交集 (鍵比較) |
<?php
// 讀取整檔案為陣列 (每行一元素)
$lines = file('orders.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
// CSV 解析 (正確處理引號、逗號、換行)
$fh = fopen('orders.csv', 'r');
while (($row = fgetcsv($fh)) !== false) {
// $row = ['2024-01-01', '10', '2', '1', '120', 'Taipei']
}
fclose($fh);
// JSON 檔案
$config = json_decode(file_get_contents('config.json'), true); // true = 關聯陣列
count() 陷阱:非陣列/非 Countable 物件回傳 1,null 回傳 0。count('abc') === 1、count(null) === 0、count(new StdClass) === 1。array_merge 數字鍵重索引:array_merge([5=>'a'], [3=>'b']) → [0=>'a', 1=>'b']。保留鍵用 + 運算子:[5=>'a'] + [3=>'b'] → [5=>'a', 3=>'b']。foreach 參考副作用:foreach ($arr as &$v) {} 後 $v 仍參考最後元素,**必須 unset($v)**。isset() vs array_key_exists():isset($arr['key']) 值為 null 回傳 false;array_key_exists() 回傳 true。$b = $a 複製陣列結構,但物件/資源元素仍共享引用。深拷貝需 unserialize(serialize($a)) 或遞歸 clone。[] vs array_push():$arr[] = $val 比 array_push($arr, $val) 快 (無函數呼叫開銷)。<?php
// 使用 Laravel Collections 或自建輕量封裝
class Collection implements IteratorAggregate, Countable, ArrayAccess {
private array $items = [];
public function __construct(array $items = []) { $this->items = $items; }
public function map(callable $fn): self {
return new self(array_map($fn, $this->items));
}
public function filter(callable $fn): self {
return new self(array_filter($this->items, $fn));
}
public function reduce(callable $fn, $initial = null) {
return array_reduce($this->items, $fn, $initial);
}
// ... 鏈式調用、不可變、型別安全
}
// 使用
$users = new Collection(User::all());
$activeAdmins = $users
->filter(fn($u) => $u->is_active)
->filter(fn($u) => $u->role === 'admin')
->map(fn($u) => $u->toArray())
->values();
PHP 陣列功能極其強大,但**陷阱也多**。掌握 **排序家族選擇**、**遍歷參考陷阱**、**合併語義差異**、**淺拷貝特性**、**內建函式庫覆蓋面**,並善用 **Collection 物件封裝** 提供型別安全與鏈式 API,能讓陣列操作代碼更健壯、更易讀、更易測試。