使用array_diff_key() 實現數組“減法”操作

M66 2025-06-06

在PHP 中， array_diff_key()函數是一個非常有用的數組函數，它允許我們從一個數組中去除指定的鍵值對。這個函數通過比較兩個數組的鍵，返回一個數組，該數組包含了在第一個數組中但不在第二個數組中的鍵值對。

函數原型

array_diff_key(array $array1, array $array2, array ...$arrays): array

參數解釋

$array1 : 要進行“減法”操作的數組。
$array2 : 需要排除的數組，即將會移除$array1中與$array2具有相同鍵的元素。
...$arrays : 可以傳入多個數組，用於進一步排除多個數組中的鍵。

返回值

該函數返回一個新的數組，其中包含了$array1中的元素，這些元素的鍵在$array2或其他數組中不存在。

示例：去除不需要的鍵值對

假設我們有以下數組，我們想從中移除一些不需要的鍵值對。

 $array1 = [
    'name' => 'John',
    'age' => 25,
    'city' => 'New York',
    'country' => 'USA'
];

$array2 = [
    'age' => 0,
    'city' => ''
];

// 使用 array_diff_key 去除數組 $array1 中的 'age' 和 'city' 鍵值對
$result = array_diff_key($array1, $array2);

print_r($result);

輸出：

 Array
(
    [name] => John
    [country] => USA
)

在這個示例中，我們通過array_diff_key()函數從$array1中去除了'age'和'city'鍵。這個函數比較$array1和$array2中的鍵，只保留$array1中那些不在$array2中的鍵。

多個數組的比較

array_diff_key()函數也支持多個數組作為參數，以下是一個示例，展示瞭如何使用多個數組來去除鍵值對。

 $array1 = [
    'name' => 'Alice',
    'age' => 30,
    'gender' => 'female',
    'email' => 'alice@m66.net'
];

$array2 = [
    'age' => 0,
    'gender' => ''
];

$array3 = [
    'email' => ''
];

// 使用 array_diff_key 去除多個數組中的鍵
$result = array_diff_key($array1, $array2, $array3);

print_r($result);

輸出：

 Array
(
    [name] => Alice
)

在這個例子中，我們同時從$array1中去除了'age' 、 'gender'和'email'鍵。函數會檢查$array1中的鍵是否在$array2和$array3中，如果在，則將該鍵值對移除。

注意事項

保持數組鍵的一致性： array_diff_key()僅比較數組的鍵，而不考慮值。如果你需要比較值，可以使用array_diff()或array_diff_assoc() 。
空數組處理：如果傳入的數組為空，則返回原數組，因為沒有可以比較的元素。
多維數組： array_diff_key()函數僅對數組的第一層鍵進行比較，若數組為多維數組，則必須逐層應用array_diff_key() 。

結語

通過array_diff_key()函數，PHP 提供了一種簡潔且高效的方式來進行數組的“減法”操作，去除不需要的鍵值對。你可以使用這個函數對數組進行精細的控制，移除不必要的元素，讓代碼更加簡潔和可維護。