PHP是否有内置数组函数可移除指定键并返回被移除元素？

云原生阿岚

2026-5-20

实现指定键移除并返回元素的array_remove()函数

嘿，这个需求太实用了！你完全可以自己封装一个array_remove()函数，来实现像array_pop()/array_shift()那样“移除+返回”的效果，还能指定键操作。

核心实现代码

首先，这个函数的关键是通过引用传递数组（不然原数组不会被修改），同时先检查键是否存在避免警告：

function array_remove(&$array, $key) {
    // 先检查键是否存在，避免访问不存在的键抛出警告
    if (!array_key_exists($key, $array)) {
        return null; // 键不存在时返回null，你也可以改成返回false或抛出异常
    }
    
    // 先保存要移除的值
    $removedValue = $array[$key];
    // 从原数组中删除该键
    unset($array[$key]);
    
    // 返回被移除的元素
    return $removedValue;
}

使用示例

完全符合你想要的效果：

$arr = ['a' => 1, 'b' => 2, 'c' => 3];
$removed = array_remove($arr, 'b');

print_r($arr);
// 输出: Array ( [a] => 1 [c] => 3 )

print_r($removed);
// 输出: 2

进阶优化（可选）

如果想要更严谨的参数校验，可以加个类型检查，防止传入非数组的参数：

function array_remove(&$array, $key) {
    if (!is_array($array)) {
        throw new InvalidArgumentException('第一个参数必须是数组类型');
    }
    
    if (!array_key_exists($key, $array)) {
        return null;
    }
    
    $removedValue = $array[$key];
    unset($array[$key]);
    
    return $removedValue;
}