陣列是 PHP 最核心的資料結構,靈活支援索引陣列、關聯陣列、多維陣列。本文系統整理各維度陣列的建立、賦值、修改、銷毀操作,並針對常見的「Cannot use a scalar value as an array」錯誤提供解決方案。
<?php
// 方法一:array() / [] 語法(推薦 [])
$colors = ['red', 'green', 'blue'];
$colors = array('red', 'green', 'blue'); // 舊式
// 方法二:指定索引
$colors[0] = 'red';
$colors[5] = 'blue'; // 索引可不連續
// 方法三:關聯陣列
$user = [
'name' => 'John',
'email' => 'john@example.com',
'age' => 25
];
$user['name'] = 'Jane'; // 修改
$user['city'] = 'Taipei'; // 新增
?>
<?php
$arr = ['a', 'b', 'c', 'd'];
unset($arr[1]); // 刪除索引 1,陣列變 ['a', 'c', 'd'],索引保留 0,2,3
unset($arr); // 完全銷毀變數
$arr = []; // 清空陣列(保留變數)
$arr = array(); // 同上
?>
<?php
// 二維關聯陣列:用戶列表
$users = [
['id' => 1, 'name' => 'Alice', 'role' => 'admin'],
['id' => 2, 'name' => 'Bob', 'role' => 'user'],
['id' => 3, 'name' => 'Carol', 'role' => 'editor'],
];
// 多維陣列:分類下的產品
$catalog = [
'electronics' => [
['id' => 101, 'name' => 'Phone', 'price' => 20000],
['id' => 102, 'name' => 'Laptop', 'price' => 50000],
],
'books' => [
['id' => 201, 'name' => 'PHP Guide', 'price' => 600],
],
];
?>
錯誤原因:直接對未初始化為陣列的變數使用 $arr[$i][$key] = $val,PHP 會嘗試將標量轉為陣列導致錯誤。
<?php
// ❌ 錯誤寫法
$data_array = array($total, 2); // 這是一維陣列 [0=>total, 1=>2]
$data_array[$i][2] = $Area; // 錯誤:$data_array[$i] 是整數,非陣列
// ✅ 正確寫法:先初始化子陣列
$data_array = []; // 空陣列
$i = 0;
while ($row = $db->fetch_assoc($result)) {
// 方法一:完整定義子陣列
$data_array[$i] = [
'id' => $row['id'],
'area' => $row['Area'],
'name' => $row['Name'],
];
// 方法二:逐項賦值(需先建立子陣列)
$data_array[$i] = []; // 關鍵:先初始化為陣列
$data_array[$i]['area'] = $row['Area'];
$data_array[$i]['name'] = $row['Name'];
$i++;
}
// 更簡潔:直接 push
while ($row = $db->fetch_assoc($result)) {
$data_array[] = [
'id' => $row['id'],
'area' => $row['Area'],
'name' => $row['Name'],
];
}
?>
<?php
$catalog = [
'electronics' => [
['id' => 101, 'name' => 'Phone', 'price' => 20000],
]
];
// 讀取
echo $catalog['electronics'][0]['name']; // Phone
// 修改
$catalog['electronics'][0]['price'] = 19900;
// 新增子元素
$catalog['electronics'][] = ['id' => 102, 'name' => 'Tablet', 'price' => 15000];
// 新增頂層鍵
$catalog['accessories'] = [
['id' => 301, 'name' => 'Case', 'price' => 500],
];
?>
| 功能 | 函數 | 範例 |
|---|---|---|
| 合併陣列(值覆蓋) | array_merge | array_merge($a, $b) 數字鍵重新索引,字串鍵後者覆蓋 |
| 合併陣列(鍵保留) | + 運算子 | $a + $b 先出現的鍵保留,後者忽略 |
| 鍵名轉小寫 | array_change_key_case | array_change_key_case($arr, CASE_LOWER) |
| 檢查鍵存在 | array_key_exists / isset | isset($arr['key']) 速度快但 null 值回 false |
| 取得所有鍵/值 | array_keys / array_values | 重新索引用 array_values($arr) |
| 翻轉鍵值 | array_flip | 值必須為 int/string |
| 篩選 | array_filter | array_filter($arr, fn($v) => $v > 10) |
| 映射轉換 | array_map | array_map('strtoupper', $arr) |
| 遞迴處理 | array_walk_recursive | 處理多維陣列葉子節點 |
<?php
$a = [0 => 'a', 1 => 'b'];
$b = [0 => 'c', 1 => 'd', 2 => 'e'];
var_dump($a + $b); // [0=>'a', 1=>'b', 2=>'e'] 先出現優先,數字鍵不重新索引
var_dump(array_merge($a, $b)); // [0=>'a', 1=>'b', 2=>'c', 3=>'d', 4=>'e'] 數字鍵重新索引
// 關聯陣列
$a = ['x' => 1, 'y' => 2];
$b = ['y' => 3, 'z' => 4];
var_dump($a + $b); // ['x'=>1, 'y'=>2, 'z'=>4] $a 的 'y' 保留
var_dump(array_merge($a, $b)); // ['x'=>1, 'y'=>3, 'z'=>4] $b 的 'y' 覆蓋
?>
PHP 陣列功能強大但細節多。關鍵原則:動態建構多維陣列時,先初始化子陣列($arr[$i] = [])再賦值;合併陣列明確語意選擇 + 或 array_merge;善用內建函數替代手寫循環。理解這些機制,能避開 90% 的陣列相關 Bug。