PHP 删除数组元素：unset、array_splice

要按键删除 PHP 数组中的元素，使用 unset($array[$key])。元素被删除后，其他键保持原样不变，而且 unset 一个不存在的键也不会报错。

<?php
$user = ["name" => "Ada", "email" => "ada@example.com", "password" => "secret"];

unset($user["password"]);
print_r($user);

$colors = ["red", "green", "blue", "yellow"];
unset($colors[1]);
print_r($colors);

看看第二个结果：键现在是 0, 2, 3。unset 从不重新编号。

unset 之后重建数组索引

键中有空缺的列表以后会带来麻烦：for ($i = 0; ...) 循环会碰到缺失的索引，json_encode 会输出一个 JSON 对象而不是数组。array_values() 能让键重新变得整齐。

<?php
$colors = ["red", "green", "blue", "yellow"];
unset($colors[1]);

echo json_encode($colors), "\n";

$colors = array_values($colors);
echo json_encode($colors), "\n";

用 array_splice 按位置删除

array_splice($array, $offset, $length) 从位置 $offset 开始删除 $length 个元素，重新编号键，并返回被删除的元素。负的偏移量从末尾开始计数。它还可以在同一次调用中插入替换元素。

<?php
$queue = ["a", "b", "c", "d", "e"];

$removed = array_splice($queue, 1, 2);
print_r($removed);
print_r($queue);

// Remove the second to last element
array_splice($queue, -2, 1);
print_r($queue);

// Replace one element with two
$letters = ["x", "y", "z"];
array_splice($letters, 1, 1, ["Y1", "Y2"]);
print_r($letters);

array_splice 作用于位置，而不是键：对关联数组，它按元素在顺序中的位置删除，并保留字符串键。array_slice 页面把它和 array_slice 做了比较，后者只复制一部分，不修改原数组。

按值删除元素

array_diff($array, [$value]) 返回去掉所有等于 $value 的元素之后的数组，其余元素的键保持不变。只删除第一个匹配时，先用 array_search 找到它的键，再 unset。

<?php
$tags = ["php", "draft", "arrays", "draft", "tips"];

// Every "draft"
print_r(array_diff($tags, ["draft"]));

// Several values at once
print_r(array_values(array_diff($tags, ["draft", "tips"])));

// Only the first "draft"
$key = array_search("draft", $tags);
if ($key !== false) {
    unset($tags[$key]);
}
print_r($tags);

array_diff 把值当作字符串比较，所以 array_diff([1, "1", 2], [1]) 会同时删除整数和字符串。当条件不只是“等于某个值”时，使用带回调的 array_filter。

删除第一个或最后一个元素

array_shift() 删除第一个元素，array_pop() 删除最后一个元素。两者都返回被删除的元素，用来实现队列和栈很方便。

<?php
$tasks = ["write", "test", "deploy"];

$first = array_shift($tasks);
$last = array_pop($tasks);

echo "First: $first\n";
echo "Last: $last\n";
print_r($tasks);

array_shift 会把数字键从 0 开始重新编号。array_pop 不需要这样做，因为空缺在末尾。

一次删除多个键

unset 可以在一次调用中删除多个元素。如果要删除的键名放在一个数组里，先用 array_flip() 翻转它，让键名变成键，再传给 array_diff_key()。

<?php
$row = ["id" => 7, "name" => "Ada", "token" => "x1", "salt" => "y2", "role" => "admin"];

$copy = $row;
unset($copy["token"], $copy["salt"]);
print_r($copy);

$hidden = ["token", "salt", "role"];
print_r(array_diff_key($row, array_flip($hidden)));

常见错误：值不存在时用 array_search 配合 unset

array_search 什么都没找到时返回 false，而 false 用作数组键时会变成 0。所以只要值不在数组中，下面这行就会删除第一个元素：

<?php
$fruits = ["apple", "banana", "cherry"];

// "grape" is not there, array_search returns false, false becomes key 0
unset($fruits[array_search("grape", $fruits)]);
print_r($fruits); // apple is gone

// Correct: check the result with !== false
$fruits = ["apple", "banana", "cherry"];
$key = array_search("grape", $fruits);
if ($key !== false) {
    unset($fruits[$key]);
}
print_r($fruits);

一定要先保存 array_search 的结果，用 !== false 比较之后再把它当作键使用。单纯写 if ($key) 也不够：在索引 0 处找到的匹配同样是假值。