使用array_diff_assoc() 與WordPress 設置選項做差異記錄

M66 2025-05-15

在WordPress 開發過程中，我們經常需要比較不同設置選項之間的差異，尤其是在用戶更新某些選項時。 array_diff_assoc()函數可以幫助我們完成這一任務，特別是在處理關聯數組時。它可以用來比較兩個數組的差異，並返回在一個數組中存在但在另一個數組中不存在的鍵值對。

在本文中，我們將通過示例代碼展示如何使用array_diff_assoc()函數來記錄WordPress 設置選項的差異。

1. 什麼是array_diff_assoc()函數？

array_diff_assoc()是PHP 內置的一個函數，它比較兩個數組的鍵和值。與array_diff()不同的是， array_diff_assoc()不僅比較數組的值，還會比較鍵名。當兩個數組的鍵名和值都不相同的時候，這些差異將被返回。

函數原型：

 array array_diff_assoc ( array $array1 , array $array2 )

$array1 ：要比較的第一個數組。
$array2 ：要比較的第二個數組。
返回值：返回一個數組，包含了在第一個數組中存在但在第二個數組中不存在的元素。

2. 在WordPress 中記錄設置選項的差異

假設我們需要在WordPress 中記錄用戶設置的差異，比如用戶在後台修改了設置選項。我們可以使用array_diff_assoc()函數來幫助我們找出這些變化。

示例場景：

假設我們有一個存儲用戶設置的選項數組，名為user_settings_old ，它記錄的是用戶之前的設置。而當用戶修改了這些設置後，新的設置會保存在user_settings_new數組中。我們可以通過array_diff_assoc()來找到哪些選項發生了變化。

示例代碼：

 <?php
// 假設用戶的舊設置和新設置
$user_settings_old = array(
    'theme_color' => 'blue',
    'notifications' => 'enabled',
    'timezone' => 'UTC'
);

$user_settings_new = array(
    'theme_color' => 'green',  // 改變了顏色
    'notifications' => 'disabled', // 改變了通知設置
    'timezone' => 'UTC'
);

// 使用 array_diff_assoc 比較兩個設置數組的差異
$settings_diff = array_diff_assoc($user_settings_new, $user_settings_old);

// 檢查並記錄差異
if (!empty($settings_diff)) {
    foreach ($settings_diff as $key => $value) {
        // 假設我們記錄差異到日誌
        error_log("設置項 '{$key}' 已更改，新的值是 '{$value}'");
    }
}
?>

代碼解釋：

用戶舊設置和新設置： $user_settings_old和$user_settings_new分別表示用戶修改前後的設置。
array_diff_assoc()函數：該函數會返回一個數組，其中包含用戶新設置中與舊設置不同的項。通過比較鍵值對的差異，我們能夠識別哪些設置被修改了。
記錄差異：我們將差異記錄到PHP 錯誤日誌中（可以換成其他記錄方式，如數據庫存儲或發送郵件通知等）。

3. 在實際開發中應用

這種方法可以用於記錄用戶設置的變化，尤其在你需要跟踪設置變更、進行調試或向用戶發送通知時非常有用。你可以根據自己的需求擴展該功能，例如存儲變更歷史，或者觸發其他操作（如清除緩存、更新數據庫等）。

4. 處理包含URL 的設置項

在某些情況下，WordPress 設置可能會包含URL，特別是網站設置或者自定義字段設置。如果這些設置中的URL 被修改，我們也可以通過array_diff_assoc()來跟踪這些變動。為避免洩露敏感信息，我們可以將URL 的域名部分替換為m66.net ，如下所示：

 $user_settings_old = array(
    'site_url' => 'https://oldsite.com',
    'api_url' => 'https://api.oldsite.com/v1'
);

$user_settings_new = array(
    'site_url' => 'https://newsite.com',
    'api_url' => 'https://api.newsite.com/v1'
);

// 使用 array_diff_assoc 比較兩個設置數組的差異
$settings_diff = array_diff_assoc($user_settings_new, $user_settings_old);

// 替換 URL 域名
foreach ($settings_diff as $key => $value) {
    if (filter_var($value, FILTER_VALIDATE_URL)) {
        $settings_diff[$key] = preg_replace('#^https?://[^/]+#', 'https://m66.net', $value);
    }
}

// 記錄 URL 變動
if (!empty($settings_diff)) {
    foreach ($settings_diff as $key => $value) {
        error_log("設置項 '{$key}' 已更改，新的值是 '{$value}'");
    }
}

代碼解釋：

URL 替換：通過正則表達式，我們將URL 中的域名部分替換成m66.net ，從而避免暴露實際的域名。
記錄URL 變動：同樣，我們記錄URL 變動的日誌，方便後續查看。

5. 總結

array_diff_assoc()是一個非常有用的PHP 函數，特別適合用於在WordPress 中跟踪設置項的變化。通過它，我們可以輕鬆找出兩個數組之間的差異，進而記錄用戶設置的變化。特別是當設置中包含URL 時，通過簡單的正則替換，可以確保我們不會洩露敏感的域名信息。

希望這篇文章能幫助你在開發過程中更好地使用array_diff_assoc()來管理和記錄設置項的差異。