PHP 關聯數組按值刪除元素的兩種高效方法

場景

需從關聯數組中移除所有值等於指定值的元素，並保持鍵名不變。

方法一：array_diff() (推薦，簡潔)

<?php
$array1 = ["a" => "green", "red", "blue", "red"]; // 索引: a, 0, 1, 2
$array2 = ["b" => "green"]; // 要刪除的值

$result = array_diff($array1, $array2);
print_r($result);
/*
Array
(
    [0] => red
    [1] => blue
    [2] => red
)
*/
// 注意：array_diff 重新索引數字鍵，字符串鍵保持
?>

特點：
• 對比值，返回差集
• 保持字符串鍵名，數字鍵重新索引 (0,1,2...)
• 可一次傳入多個對比數組

方法二：自定義函數保持所有鍵名 (精確控制)

<?php
function removeArrayElementByValue(array &$array, $value): void {
    foreach ($array as $key => $val) {
        if ($val === $value) {
            unset($array[$key]);
        }
    }
    // 無需重新索引，鍵名完全保持
}

// 測試
$arr = ["a" => "green", 0 => "red", 1 => "blue", 2 => "red"];
removeArrayElementByValue($arr, "red");
print_r($arr);
/*
Array
(
    [a] => green
    [1] => blue
)
*/
?>

優勢：
• 保持**所有**鍵名 (含數字鍵)
• 嚴格類型比較 `===`
• 內存效率高 (原地修改)

方法三：array_filter() (函數式風格)

<?php
$arr = ["a" => "green", 0 => "red", 1 => "blue", 2 => "red"];
$filtered = array_filter($arr, function($v) { return $v !== "red"; });
// 鍵名保持
print_r($filtered);
?>

性能對比 (10萬元素數組)

多維數組遞歸刪除

<?php
function deepRemoveByValue(&$array, $value) {
    foreach ($array as $key => &$val) {
        if (is_array($val)) {
            deepRemoveByValue($val, $value);
            if (empty($val)) unset($array[$key]); // 可選：清理空子數組
        } elseif ($val === $value) {
            unset($array[$key]);
        }
    }
}
?>

總結建議

1. 簡單場景、不介意數字鍵重排 → array_diff($arr, [$val])
2. 需完全保持鍵名、追求性能 → foreach + unset
3. 函數式風格、鏈式調用 → array_filter()
4. 嚴格類型比較 (`===`) 避免 `"0" == 0` 等隱式轉換陷阱