PHP 陣列刪除元素後重新索引：unset vs array_splice vs array_values

現象：unset() 不會重建索引

<?php
$arr = ['a', 'b', 'c', 'd'];
unset($arr[1]); // 刪除 'b'
print_r($arr);
/*
Array
(
    [0] => a
    [2] => c  <-- 索引跳號！
    [3] => d
)
*/

PHP 陣列底層是有序雜湊表，unset 僅移除該鍵值，不改變其他鍵。

方案一：array_splice() 原地刪除並重建索引 (推薦)

<?php
$arr = ['a', 'b', 'c', 'd'];
array_splice($arr, 1, 1); // 從索引 1 刪除 1 個
print_r($arr);
/*
Array
(
    [0] => a
    [1] => c
    [2] => d
)
*/

語法：array_splice(&$array, $offset, $length, $replacement = [])
優點：直接修改原陣列、效能好、語意明確。

方案二：array_values() 取得值並重新索引 (通用)

<?php
$arr = ['a', 'b', 'c', 'd'];
unset($arr[1]);
$arr = array_values($arr); // 重新建立 0..N 索引
print_r($arr); // [0=>a, 1=>c, 2=>d]

適用：已用 unset、array_filter、array_diff 等產生斷層索引後，統一整理。

方案三：依「值」刪除並重建索引

<?php
$arr = ['a', 'b', 'c', 'd', 'b'];
$val = 'b';

// 方法 A：array_search 只找第一個
if (($key = array_search($val, $arr)) !== false) {
    unset($arr[$key]);
    $arr = array_values($arr);
}

// 方法 B：刪除所有匹配值
$arr = array_values(array_diff($arr, [$val])); // ['a', 'c', 'd']
// 或
$arr = array_values(array_filter($arr, fn($v) => $v !== $val));

關鍵差異比較表

實務建議

1. 知道位置刪除 → array_splice($arr, $pos, 1)
2. 知道鍵值刪除 → unset($arr[$key]); $arr = array_values($arr);
3. 條件過濾 → $arr = array_values(array_filter($arr, fn($v) => $v !== $target));
4. 大量資料：考慮 SplFixedArray 或資料庫操作，避免 PHP 陣列記憶體開銷。

進階：保留關聯鍵名的「刪除」

若陣列為關聯式 (['id'=>1, 'name'=>'A'])，通常不需重建索引，直接 unset($arr['name']) 即可。若需重排數字索引但保留關聯鍵，請轉為物件或重新建構陣列。