注意：array_diff_key() 只比較鍵名，不比較鍵值

M66 2025-05-15

在PHP 中，數組操作是非常常見的任務，其中有許多內置函數可以幫助我們高效地處理數組。 array_diff_key()是一個非常實用的函數，它可以幫助我們根據鍵名比較數組，並返回差異數組。很多時候開發者會對這個函數有一些誤解，認為它會比較鍵名對應的值，實際上它只會比較數組的，而不會比較鍵值。今天我們就來詳細解析一下這個函數的用法，澄清一些常見的誤解。

1. 函數簡介

array_diff_key()函數用於比較兩個（或更多）數組，返回一個包含第一個數組中那些在其他數組中沒有出現的鍵名的元素。也就是說，它會返回一個差集，包含在第一個數組中存在但在其他數組中沒有的鍵名。

函數原型如下：

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

$array1 ：需要進行比較的第一個數組。
$array2, ...$arrays ：需要與$array1進行比較的數組（可以傳入多個數組）。

2. 示例代碼

為了更清楚地理解這個函數，我們來看一個實際的代碼示例：

 <?php
$array1 = [
    'a' => 1,
    'b' => 2,
    'c' => 3
];

$array2 = [
    'b' => 5,
    'c' => 3,
    'd' => 7
];

$result = array_diff_key($array1, $array2);
print_r($result);
?>

輸出結果是：

 Array
(
    [a] => 1
)

在這個示例中， array_diff_key()函數比較了$array1和$array2中的鍵名。它返回了一個包含鍵名'a'的新數組，因為'a'在$array2中沒有對應的鍵。

3. 關鍵點：只比較鍵名，不比較鍵值

array_diff_key()函數的一個重要特點是：它只會比較鍵名，而不會考慮鍵名對應的值。在上面的例子中，我們看到鍵名'b'和'c'在兩個數組中都有出現，但是它們的值不同：在$array1中'b'對應的值是2 ，在$array2中'b'對應的值是5 。但是， array_diff_key()並沒有比較值，它只比較鍵名，因此'b'和'c'都沒有出現在返回結果中。

4. 比較多個數組

array_diff_key()也可以接受多個數組作為參數，比較多個數組中的鍵名。以下是一個包含多個數組的示例：

 <?php
$array1 = [
    'a' => 1,
    'b' => 2,
    'c' => 3
];

$array2 = [
    'b' => 5,
    'c' => 3,
    'd' => 7
];

$array3 = [
    'c' => 3,
    'd' => 7,
    'e' => 8
];

$result = array_diff_key($array1, $array2, $array3);
print_r($result);
?>

輸出結果是：

 Array
(
    [a] => 1
)

這裡， array_diff_key()比較了$array1與$array2和$array3的鍵名，返回的結果依然只有鍵名'a' ，因為'b'和'c'都在其他數組中找到了對應的鍵名。

5. 注意事項

只比較鍵名：正如之前所提到的， array_diff_key()只會比較鍵名，不會比較鍵值。
多個數組比較：你可以傳入多個數組， array_diff_key()會根據所有數組中的鍵名，返回第一個數組中獨有的鍵名。
原數組不變：該函數不會修改原數組，而是返回一個新數組。

6. 常見誤解

有時候，開發者可能會誤以為array_diff_key()會比較數組的鍵值。例如，以下代碼：

 <?php
$array1 = [
    'a' => 10,
    'b' => 20,
    'c' => 30
];

$array2 = [
    'a' => 10,
    'b' => 25,
    'c' => 30
];

$result = array_diff_key($array1, $array2);
print_r($result);
?>

輸出結果：

 Array
(
)

在這個例子中，儘管數組$array1和$array2中鍵'b'的值不同（分別為20和25 ），但是array_diff_key()依然返回了空數組，因為它只比較了鍵名，鍵名'a'和'c'在兩個數組中都有，所以沒有被返回。

7. 總結

array_diff_key()是一個非常有用的PHP 函數，它幫助我們輕鬆地比較數組的鍵名，找出那些在第一個數組中存在但在其他數組中不存在的鍵。記住，它只會比較鍵名，而不會比較鍵值。這個特性在處理多維數組或者需要僅根據鍵名篩選數據時，尤其有用。

額外閱讀

array_diff_key