許多開發者誤以為 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
)
*/
<?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) | ❌ 否 (保留鍵名) | 條件式過濾、保留關聯鍵名 | 過濾後陣列 |
function removeAt(array &$arr, int $index): bool {
if ($index < 0 || $index >= count($arr)) return false;
array_splice($arr, $index, 1);
return true;
}
function removeValue(array &$arr, $value): bool {
$key = array_search($value, $arr, true);
if ($key === false) return false;
array_splice($arr, $key, 1);
return true;
}
function removeMultiple(array &$arr, array $indices): void {
rsort($indices); // 從大到小刪除,避免索引位移影響後續刪除
foreach ($indices as $idx) {
if (isset($arr[$idx])) array_splice($arr, $idx, 1);
}
}
$user = ['id' => 1, 'name' => 'John', 'email' => 'john@example.com'];
unset($user['email']); // 正確,關聯鍵名無順序性要求
$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。