用array_udiff() 實現自定義比較邏輯

M66 2025-06-06

在PHP中， array_udiff()是一個非常強大的函數，它允許我們使用自定義的比較函數來比較兩個或多個數組之間的差異。這意味著我們可以根據具體的業務需求，靈活定義“相等”或“不相等”的判斷邏輯，而不僅僅依賴於簡單的值或鍵的比較。

array_udiff() 的基本語法

array_udiff(array $array1, array $array2, callable $value_compare_func): array

$array1 ：需要比較的第一個數組。
$array2 ：需要和第一個數組進行比較的第二個數組。
$value_compare_func ：一個用戶自定義的比較函數。

函數返回在$array1中但不在$array2中的值，用用戶自定義的函數進行比較。

實際應用場景

假設我們有兩個用戶列表，分別是今天登錄過的用戶和過去一個月內活躍的用戶。每個用戶信息是一個包含id和email的數組。我們希望找出今天登錄的用戶中有哪些“新用戶”，即過去從未活躍過的。

示例代碼

// 今天登錄的用戶
$todayUsers = [
    ['id' => 101, 'email' => 'alice@m66.net'],
    ['id' => 102, 'email' => 'bob@m66.net'],
    ['id' => 103, 'email' => 'carol@m66.net'],
];

// 過去一個月活躍的用戶
$pastActiveUsers = [
    ['id' => 102, 'email' => 'bob@m66.net'],
    ['id' => 104, 'email' => 'dan@m66.net'],
];

// 自定義比較函數：通過 email 判斷用戶是否相同
function compareUsersByEmail($a, $b) {
    return strcmp($a['email'], $b['email']);
}

// 找出“新用戶”
$newUsers = array_udiff($todayUsers, $pastActiveUsers, 'compareUsersByEmail');

// 輸出結果
echo "新用戶列表：\n";
foreach ($newUsers as $user) {
    echo "- {$user['email']} (ID: {$user['id']})\n";
}

輸出結果：

 新用戶列表：
- alice@m66.net (ID: 101)
- carol@m66.net (ID: 103)

小貼士：自定義比較函數的注意事項

array_udiff()中的比較函數必須返回整數：
- 負數：表示第一個參數小於第二個；
- 0：表示兩個值相等；
- 正數：表示第一個參數大於第二個。
自定義比較函數中，確保對數組元素的結構有清晰認知，避免訪問未定義的鍵。

實戰擴展：多條件比較

如果我們希望不僅根據email，還要根據id 一起比較，可以將比較函數寫成這樣：

 function compareUsersByIdAndEmail($a, $b) {
    $emailCompare = strcmp($a['email'], $b['email']);
    if ($emailCompare !== 0) {
        return $emailCompare;
    }
    return $a['id'] <=> $b['id'];
}

將該函數用於array_udiff()中，就可以實現更精細的差異對比。

總結

array_udiff()提供了非常靈活的數組差集比較方式，尤其適用於結構化數據的處理場景。通過自定義比較函數，我們可以實現對任意複雜邏輯的判斷，極大地提升了數組處理的自由度和表現力。

在處理用戶信息、產品列表、日誌記錄等複雜業務數據時，掌握array_udiff()的使用方法無疑是一個重要的技能。