萬盛學電腦網

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

PHP 陣列刪除元素陷阱:unset() 不重新索引 vs array_splice() 正確用法

核心問題

許多開發者誤以為 unset($arr[$key]) 會自動重新排列數字索引,實際上 unset 保留原鍵名,造成索引斷層。這在後續 foreach、json_encode、array_values 轉換時容易產生邏輯錯誤。

行為對比實測

關聯陣列 (字串鍵名)

<?php
$arr = ['a', 'b', 'c', 'd']; // 索引 0,1,2,3
unset($arr[1]);
print_r($arr);
/* 輸出:
Array
(
    [0] => a
    [2] => c    // 索引 1 消失,非連續
    [3] => d
)
*/

數字索引陣列

<?php
$arr = range(5, 10); // [5,6,7,8,9,10] 索引 0-5
unset($arr[1]);      // 移除 6
print_r($arr);
/* 輸出:
Array
(
    [0] => 5
    [2] => 7        // 索引斷層
    [3] => 8
    [4] => 9
    [5] => 10
)
*/

正確重新索引:array_splice()

<?php
$arr = ['a', 'b', 'c', 'd'];
array_splice($arr, 1, 1); // 從索引 1 刪除 1 個元素
print_r($arr);
/* 輸出:
Array
(
    [0] => a
    [1] => c    // 索引重新連續 0,1,2
    [2] => d
)
*/

函數對照表

函數是否重新索引適用場景回傳值
unset($arr[$key])❌ 否刪除特定鍵名、釋放記憶體、關聯陣列void
array_splice($arr, $offset, $length)✅ 是 (數字索引)需保持索引連續、切片替換、佇列操作被移除元素陣列
array_values($arr)✅ 是 (重建 0..n)事後重新索引、輸出 JSON 陣列前重新索引陣列
array_filter($arr, fn($v,$k)=>$k!==$key)❌ 否 (保留鍵名)條件式過濾、保留關聯鍵名過濾後陣列

實務最佳模式

模式 1:明確知道索引位置 → array_splice

function removeAt(array &$arr, int $index): bool {
    if ($index < 0 || $index >= count($arr)) return false;
    array_splice($arr, $index, 1);
    return true;
}

模式 2:根據值刪除 (首次出現) → array_search + array_splice

function removeValue(array &$arr, $value): bool {
    $key = array_search($value, $arr, true);
    if ($key === false) return false;
    array_splice($arr, $key, 1);
    return true;
}

模式 3:批次刪除多個索引 → 由大到小排序後 array_splice

function removeMultiple(array &$arr, array $indices): void {
    rsort($indices); // 從大到小刪除,避免索引位移影響後續刪除
    foreach ($indices as $idx) {
        if (isset($arr[$idx])) array_splice($arr, $idx, 1);
    }
}

模式 4:關聯陣列刪除鍵名 → unset (不需重新索引)

$user = ['id' => 1, 'name' => 'John', 'email' => 'john@example.com'];
unset($user['email']); // 正確,關聯鍵名無順序性要求

JSON 輸出陷阱

$arr = ['a', 'b', 'c'];
unset($arr[1]);
echo json_encode($arr); // {"0":"a","2":"c"} → 物件非陣列!

// 修正:輸出前重新索引
echo json_encode(array_values($arr)); // ["a","c"] → 正確陣列

效能考量

  • unset:O(1) 極快,適合大陣列單點刪除
  • array_splice:O(n) 需搬移後續元素,百萬級陣列慎用
  • 大量刪除時:考慮 array_filter 重建陣列或使用 SplFixedArray/Ds\Vector

總結口訣

關聯陣列用 unset,數字索引要連續用 array_splice,輸出 JSON 前記得 array_values。

copyright © 萬盛學電腦網 all rights reserved