萬盛學電腦網

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

PHP 刪除陣列元素完全指南:unset vs array_splice vs array_filter

三大核心方法對比

方法適用場景索引重排返回值效能
unset($arr[$key])已知鍵名刪除單/多個元素❌ 保留原鍵名(會產生「洞」)voidO(1) 最快
array_splice($arr, $offset, $length)按位置刪除、切片替換✅ 數字索引重排(0 起),關聯鍵保留被刪除元素陣列O(n) 需移動元素
array_filter($arr, $callable)按條件批量刪除✅ 數字索引重排(PHP 8.0+ 保留關聯鍵需 ARRAY_FILTER_USE_KEY)新陣列O(n) 遍歷全陣列

詳細範例與陷阱

1. unset() —— 鍵名不變,產生稀疏陣列

<?php
$arr = ['red', 'green', 'blue', 'yellow'];
unset($arr[1]); // 刪除 'green'
var_dump($arr);
/*
array(3) {
  [0]=> string(3) "red"
  [2]=> string(4) "blue"   // 索引跳過 1
  [3]=> string(6) "yellow"
}
*/
echo $arr[1]; // Notice: Undefined array key 1
echo count($arr); // 3(長度正確)

補救:需連續索引時用 array_values($arr) 重建。

2. array_splice() —— 原地修改,重排數字索引

<?php
$arr = ['red', 'green', 'blue', 'yellow'];
$removed = array_splice($arr, 1, 1); // 從索引 1 刪除 1 個
var_dump($removed); // ['green']
var_dump($arr);     // [0=>'red', 1=>'blue', 2=>'yellow'] 索引重排!

// 刪除最後 2 個
array_splice($arr, -2); // $arr = ['red']

// 替換:刪除 1 個並插入新元素
array_splice($arr, 1, 1, ['orange', 'purple']); // 插入陣列會展開

注意:關聯陣列的字串鍵不會重排,只有數字鍵(0,1,2...)重排。

3. array_filter() —— 函數式風格,條件刪除

<?php
$arr = [10, 20, 30, 40, 50];
// 刪除大於 30 的元素
$filtered = array_filter($arr, fn($v) => $v <= 30);
// [0=>10, 1=>20, 2=>30] 索引重排

// 保留鍵名(PHP 8.0+)
$filtered = array_filter($arr, fn($v) => $v <= 30, ARRAY_FILTER_USE_BOTH);
// 鍵名保持原樣,但被刪除的鍵消失

進階場景

按值刪除(不知道鍵名)

<?php
$arr = ['a', 'b', 'c', 'b', 'd'];
$value = 'b';
// 方法 1:array_search 只刪第一個
if (($key = array_search($value, $arr)) !== false) unset($arr[$key]);

// 方法 2:array_keys 刪除所有
foreach (array_keys($arr, $value, true) as $key) {
    unset($arr[$key]);
}
// 方法 3:array_filter(推薦,語意清晰)
$arr = array_filter($arr, fn($v) => $v !== $value);

多維陣列刪除子元素

<?php
$users = [
    ['id'=>1, 'name'=>'Alice', 'role'=>'admin'],
    ['id'=>2, 'name'=>'Bob',   'role'=>'user'],
    ['id'=>3, 'name'=>'Carol', 'role'=>'user'],
];
// 刪除 role=user 的記錄
$users = array_filter($users, fn($u) => $u['role'] !== 'user');
// 結果:只剩 Alice

刪除陣列中所有 null/false/空值

<?php
$arr = [1, 0, '', null, false, 'text', []];
$clean = array_filter($arr); // 使用預設回調:轉換為布林值為 false 的被移除
// 結果:[0=>1, 5=>'text']  注意:0 和 '0' 也會被移除!

// 嚴格模式:只移除 null
$clean = array_filter($arr, fn($v) => $v !== null);

效能微基準(100 萬元素陣列,刪除 10%)

<?php
$arr = range(1, 1_000_000);

// unset 隨機 10 萬鍵
$keys = array_rand($arr, 100_000);
$t = microtime(true);
foreach ($keys as $k) unset($arr[$k]);
echo "unset: " . (microtime(true)-$t) . "s\n"; // ~0.03s

// array_splice 刪除中間 10 萬
$arr = range(1, 1_000_000);
$t = microtime(true);
array_splice($arr, 400_000, 100_000);
echo "array_splice: " . (microtime(true)-$t) . "s\n"; // ~0.08s (需移動後續 50 萬元素)

// array_filter 條件刪除
$arr = range(1, 1_000_000);
$t = microtime(true);
$arr = array_filter($arr, fn($v) => $v % 10 !== 0);
echo "array_filter: " . (microtime(true)-$t) . "s\n"; // ~0.12s (遍歷+建新陣列)

最佳實踐決策樹

需要刪除元素?
├─ 已知精確鍵名(單/少數)          → unset($arr[$key])
├─ 按位置/範圍刪除(如分頁、切片)   → array_splice($arr, $offset, $len)
├─ 按條件/值批量刪除                  → array_filter($arr, $callable)
└─ 多維陣列按欄位值過濾               → array_filter($arr, fn($row) => $row['col'] !== $val)

記住:unset 是「拔掉標籤」,array_splice 是「剪刀剪斷再縫合」,array_filter 是「篩子篩一遍」。根據資料結構與業務語義選擇最貼切的工具。

copyright © 萬盛學電腦網 all rights reserved