如何使用WPDB更新數據

在WordPress 插件或主題開發中，使用wpdb 類的update() 方法可實現數據庫記錄更新，基本結構為：$wpdb->update( $table, $data, $where, $format, $where_format )。 1. $table 指定表名，如$wpdb->prefix . 'my_table'；2. $data 為關聯數組，表示要更新的數據，如['column1' => 'value1']；3. $where 也是關聯數組，指定更新條件，如['id' => 123]；4. $format 和$where_format 可選，用於定義數據類型，如%s、%d、%f。例如：更新用戶郵箱時使用$wpdb->update( $wpdb->prefix . 'users', ['user_email' => 'new@example.com'], ['ID' => 1], ['%s'], ['%d'])。安全方面需注意：1. 雖update() 內部已防SQL 注入，但複雜查詢應使用$wpdb->prepare()；2. 避免手動拼接SQL；3. 對輸入進行驗證和過濾，如intval()、sanitize_email()；4. 使用主鍵或唯一字段作為WHERE 條件，防止誤更新多條記錄；5. 更新前建議先SELECT 查詢確認目標存在。掌握這些方法與規範，即可安全高效地完成數據庫更新操作。

更新數據在WordPress 插件或主題開發中是一個常見需求，而wpdb類是實現這個目標的關鍵工具。使用它可以直接操作數據庫，但也要注意安全和規範。

基本用法：update 方法

wpdb提供了一個專門用於更新記錄的方法： update() 。它的基本結構如下：

 $wpdb->update( $table, $data, $where, $format = null, $where_format = null );

• $table ：要更新的表名（如$wpdb->prefix . 'my_table' ）。
• $data ：要更新的數據，格式為關聯數組（如['column1' => 'value1', ...] ）。
• $where ：更新條件，也是關聯數組（如['id' => 123] ）。
• $format和$where_format是可選參數，用於指定數據類型（%s 字符串，%d 整數，%f 浮點數）。

例如：

 $wpdb->update(
    $wpdb->prefix . 'users',
    ['user_email' => 'new@example.com'],
    ['ID' => 1],
    ['%s'],
    ['%d']
);

安全注意事項

使用wpdb操作數據庫時， SQL 注入是一個潛在風險。雖然update()方法內部已經做了參數綁定處理，但仍需注意以下幾點：

• 始終使用$wpdb->prepare()來構造複雜的查詢語句（雖然update()自帶安全機制，但在其他場景中可能需要）。
• 避免直接拼接SQL 語句字符串。
• 對用戶輸入進行驗證和過濾，比如使用intval() 、 sanitize_email()等函數。

比如，如果手動寫SQL 更新語句，應該這樣：

 $wpdb->query(
    $wpdb->prepare(
        "UPDATE {$wpdb->prefix}users SET user_email = %s WHERE ID = %d",
        'new@example.com',
        1
    )
);

使用主鍵或唯一字段作為條件

更新數據時，確保你的WHERE條件足夠精確，否則可能會誤更新多條記錄。最常見的是使用主鍵（通常是ID ）或者唯一字段（如用戶名、郵箱等）來定位目標行。

建議做法：

• 盡量使用整型主鍵作為條件。
• 如果使用字符串字段作為條件，記得加上引號佔位符%s 。
• 更新前可以先做一次SELECT查詢確認目標是否存在。

示例：

 $user_id = $wpdb->get_var(
    $wpdb->prepare("SELECT ID FROM {$wpdb->prefix}users WHERE user_login = %s", 'admin')
);

if ($user_id) {
    $wpdb->update(
        $wpdb->prefix . 'users',
        ['user_email' => 'new@admin.com'],
        ['ID' => $user_id],
        ['%s'],
        ['%d']
    );
}

基本上就這些。掌握好wpdb::update()的用法，配合安全措施和精確的查詢條件，就能在WordPress 中穩定地更新數據庫內容了。

以上是如何使用WPDB更新數據的詳細內容。更多資訊請關注PHP中文網其他相關文章！