| 方法 | 適用場景 | 索引重排 | 返回值 | 效能 |
|---|---|---|---|---|
unset($arr[$key]) | 已知鍵名刪除單/多個元素 | ❌ 保留原鍵名(會產生「洞」) | void | O(1) 最快 |
array_splice($arr, $offset, $length) | 按位置刪除、切片替換 | ✅ 數字索引重排(0 起),關聯鍵保留 | 被刪除元素陣列 | O(n) 需移動元素 |
array_filter($arr, $callable) | 按條件批量刪除 | ✅ 數字索引重排(PHP 8.0+ 保留關聯鍵需 ARRAY_FILTER_USE_KEY) | 新陣列 | O(n) 遍歷全陣列 |
<?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) 重建。
<?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...)重排。
<?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
<?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);
<?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 是「篩子篩一遍」。根據資料結構與業務語義選擇最貼切的工具。