萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 陣列賦值完整指南:一維、二維、多維陣列操作與常見錯誤

前言

陣列是 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],
    ],
];
?>

動態建構(解決「Cannot use a scalar value as an array」錯誤)

錯誤原因:直接對未初始化為陣列的變數使用 $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_mergearray_merge($a, $b) 數字鍵重新索引,字串鍵後者覆蓋
合併陣列(鍵保留)+ 運算子$a + $b 先出現的鍵保留,後者忽略
鍵名轉小寫array_change_key_casearray_change_key_case($arr, CASE_LOWER)
檢查鍵存在array_key_exists / issetisset($arr['key']) 速度快但 null 值回 false
取得所有鍵/值array_keys / array_values重新索引用 array_values($arr)
翻轉鍵值array_flip值必須為 int/string
篩選array_filterarray_filter($arr, fn($v) => $v > 10)
映射轉換array_maparray_map('strtoupper', $arr)
遞迴處理array_walk_recursive處理多維陣列葉子節點

陣列合併陷阱:+ vs array_merge

<?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。

copyright © 萬盛學電腦網 all rights reserved