萬盛學電腦網

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

PHP 陣列索引與鍵值操作技巧:新增、更新、刪除、重新索引完整指南

PHP 陣列同時支援有序映射 (關聯陣列) 與列表 (索引陣列),靈活強大但也易產生索引混亂、鍵值遺漏等問題。本文系統整理陣列索引與鍵值核心操作、陷阱避坑、效能技巧與現代 PHP 8+ 新語法。

陣列建立與索引行為

<?php
// 1. 短語法 (PHP 5.4+)
$indexed = ['a', 'b', 'c'];        // 索引 0,1,2
$assoc = ['id' => 1, 'name' => 'Tom']; // 關聯鍵

// 2. 自動索引:空括號追加
$arr = ['a', 'b'];
$arr[] = 'c'; // 索引自動為 3 (最大整數索引 + 1)

// 3. 指定數值索引會影響後續自動索引
$arr = ['a', 'b'];
$arr[9] = 'Simon';  // 索引 9
$arr[] = 'Auto';    // 索引變 10 (max(9)+1)

// 4. 負數索引合法但不影響自動索引
$arr[-5] = 'neg';
$arr[] = 'next';    // 索引 10 (max(9, -5)+1 = 10)

核心操作函數速查

操作函數/語法特性
新增/更新單一元素$arr[$key] = $val鍵存在則更新,不存在則新增
批次新增/更新$arr += $other (聯集)左側優先,不覆蓋既有鍵
合併並覆蓋array_merge($a, $b)右側覆蓋,數值鍵重新索引
遞迴合併array_merge_recursive()同鍵值包成陣列
刪除單一元素unset($arr[$key])保留鍵值空洞,不重新索引
刪除多個元素array_diff_key($arr, $keys)依鍵差集刪除,保留索引
重新索引 (0,1,2...)array_values($arr)捨棄原鍵,重建連續索引
檢查鍵存在array_key_exists($key, $arr) / isset($arr[$key])isset 若值為 null 回傳 false
取得所有鍵array_keys($arr)回傳鍵陣列
取得所有值array_values($arr)回傳值陣列 (同時重新索引)
鍵值互換array_flip($arr)值必須唯一且為字串/整數
反轉順序array_reverse($arr, true)第 2 參數 true 保留鍵值

實戰範例:完整生命週期操作

<?php
// 建立
$arr = [0 => 1, 1 => 2, 2 => 3, 3 => 4, 6 => 5];
print_r($arr);
/*
Array ( [0]=>1 [1]=>2 [2]=>3 [3]=>4 [6]=>5 )  // 索引 4,5 空洞
*/

// 更新
$arr[2] = 100;
print_r($arr); // [2] => 100

// 新增字串鍵
$arr['X'] = 50;
print_r($arr); // [X] => 50

// 刪除所有元素但保留陣列結構 (錯誤示範)
foreach ($arr as $k => $v) {
    unset($arr[$k]); // 迭代中 unset 安全,但陣列變空
}
print_r($arr); // Array ( )

// 正確清空:$arr = []; 或 $arr = array();

// 重新添加 (索引從 0 開始,因陣列已空)
$arr[] = 25; // 索引 0
print_r($arr); // [0] => 25

// 手動重新索引
$arr = [10 => 'a', 20 => 'b'];
$arr = array_values($arr); // [0 => 'a', 1 => 'b']
$arr[] = 13; // 索引 2
print_r($arr);

進階技巧:陣列鍵值轉換與篩選

1. 鍵名轉換 (大小寫、前綴、駝峰)

<?php
$arr = ['user_id' => 1, 'user_name' => 'Tom', 'user_email' => 'tom@example.com'];

// 鍵名駝峰
$camel = array_combine(
    array_map(fn($k) => lcfirst(str_replace('_', '', ucwords($k, '_'))), array_keys($arr)),
    array_values($arr)
);
// ['userId' => 1, 'userName' => 'Tom', 'userEmail' => 'tom@example.com']

// 加前綴
$prefixed = array_combine(
    array_map(fn($k) => 'prefix_' . $k, array_keys($arr)),
    array_values($arr)
);

2. 依鍵/值篩選

<?php
$data = ['a' => 10, 'b' => 20, 'c' => 5, 'd' => 30, 'e' => 15];

// 保留值 > 15
$filtered = array_filter($data, fn($v) => $v > 15); // ['b'=>20, 'd'=>30]
// ARRAY_FILTER_USE_KEY 依鍵篩選
$byKey = array_filter($data, fn($k) => $k !== 'c', ARRAY_FILTER_USE_KEY);

// 依鍵取子集
$subset = array_intersect_key($data, array_flip(['a', 'c', 'e'])); // ['a'=>10, 'c'=>5, 'e'=>15]

3. 陣列扁平化與分組

<?php
// 扁平化巢狀陣列
$nested = [1, [2, 3], [4, [5, 6]]];
$flat = array_merge(...array_map(
    fn($v) => is_array($v) ? array_merge(...array_map(fn($x) => is_array($x) ? $x : [$x], $v)) : [$v],
    $nested
)); // [1,2,3,4,5,6] (簡化版,深層需遞迴)

// 分組:依欄位值分組
$users = [
    ['id'=>1, 'dept'=>'IT'], ['id'=>2, 'dept'=>'HR'], ['id'=>3, 'dept'=>'IT']
];
$grouped = [];
foreach ($users as $u) {
    $grouped[$u['dept']][] = $u;
}
// ['IT' => [...], 'HR' => [...]]

陷阱避坑指南

1. foreach 參考傳遞副作用
$arr = [1,2,3];
foreach ($arr as &$v) $v *= 2;
foreach ($arr as $v) {} // 第二次迴圈 $v 仍是參考!
// $arr 最後一個元素會被覆蓋
unset($v); // 關鍵:解除參考
2. array_shift/pop 會重新索引
僅適用列表陣列;關聯陣列用 unset($arr[key($arr)]) 保留鍵。
3. in_array 嚴格模式
預設鬆散比較 '123' == 123 為 true,務必加 true 第三參數:in_array($needle, $haystack, true)。
4. 空陣列 vs null
[] == null 為 true,[] === null 為 false。判空用 empty($arr) 或 count($arr) === 0。
5. 字串鍵自動轉整數
$arr['123'] = 'x' 實際鍵為整數 123;$arr['0123'] 保留字串。避免數值字串當鍵。

現代 PHP 8.1+ 新功能

<?php
// 1. 解構賦值 (PHP 7.1+)
[$a, $b, $c] = [1, 2, 3];
['id' => $id, 'name' => $name] = ['id' => 1, 'name' => 'Tom'];

// 2. 陣列解構合併 (PHP 7.4+)
$merged = [...$arr1, ...$arr2]; // 列表合併,重新索引
$mergedAssoc = $arr1 + $arr2;   // 關聯合併,左側優先 (無新語法)

// 3. readonly 陣列 (PHP 8.1+ 需搭配物件)
// 陣列本身不可 readonly,但可用物件封裝
final class ReadonlyArray {
    public function __construct(public readonly array $data) {}
    public function get(string $key, mixed $default = null) { return $this->data[$key] ?? $default; }
}

// 4. array_is_list() (PHP 8.1+) 判斷是否為列表 (連續整數鍵從 0 開始)
$list = ['a', 'b', 'c'];
$assoc = ['x' => 1, 'y' => 2];
var_dump(array_is_list($list));  // true
var_dump(array_is_list($assoc)); // false

效能微優化

  • isset() > array_key_exists():檢查鍵存在且值非 null 時,isset 是語言結構,比函數呼叫快。
  • foreach 引用修改:大量修改值時 foreach ($arr as &$v) $v = ... 避免複製,記得 unset($v)。
  • 預分配大小:$arr = []; $arr[10000] = 'x'; 會預先分配,但通常不需手動優化。
  • 避免在迴圈中 count():for ($i=0, $n=count($arr); $i<$n; $i++) 或直接 foreach。

PHP 陣列是「有序映射」混合體,理解索引行為、鍵值語意、函數副作用,能寫出更簡潔、高效、無 Bug 的代碼。善用 array_* 函數族群與現代語法,讓陣列操作成為你的得力工具而非隱患!

copyright © 萬盛學電腦網 all rights reserved