چرا به‌روزرسانی داده بدون wpdb::update فاجعه است؟ راهنمای عملی

چرا به‌روزرسانی امن حیاتی است؟

متد wpdb::update چیست؟

امضای متد و پارامترها

public function update( $table, $data, $where, $format = null, $where_format = null ) {
    // ...
}

نقش حیاتی where

global $wpdb;

$wpdb->update(
    $wpdb->prefix . 'myplugin_items',
    array( 'status' => 'approved' ),
    array( 'id' => 42 ),
    array( '%s' ),
    array( '%d' )
);

// اشتباه — بدون where، همه رکوردها به‌روزرسانی می‌شوند
$wpdb->update(
    $wpdb->prefix . 'myplugin_items',
    array( 'status' => 'approved' ),
    array()
);

پارامترهای format

$data = array(
    'title'      => 'عنوان جدید',
    'priority'   => 5,
    'updated_at' => current_time( 'mysql' ),
);

$where = array(
    'id'      => 42,
    'user_id' => get_current_user_id(),
);

$format       = array( '%s', '%d', '%s' );
$where_format = array( '%d', '%d' );

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

مقدار بازگشتی و تفسیر آن

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

if ( false === $result ) {
    error_log( 'Update failed: ' . $wpdb->last_error );
    return false;
}

if ( 0 === $result ) {
    // هیچ رکوردی تغییر نکرد
    return 'unchanged';
}

return 'updated';

کاربردهای عملی در افزونه

function myplugin_update_order_status( $order_id, $new_status ) {
    global $wpdb;

    $allowed_statuses = array( 'pending', 'processing', 'completed', 'cancelled' );

    if ( ! in_array( $new_status, $allowed_statuses, true ) ) {
        return false;
    }

    $result = $wpdb->update(
        $wpdb->prefix . 'myplugin_orders',
        array(
            'status'     => $new_status,
            'updated_at' => current_time( 'mysql' ),
        ),
        array( 'id' => absint( $order_id ) ),
        array( '%s', '%s' ),
        array( '%d' )
    );

    return $result;
}

function myplugin_update_user_item( $item_id, $data, $user_id ) {
    global $wpdb;

    $sanitized = array(
        'title'   => sanitize_text_field( $data['title'] ),
        'content' => wp_kses_post( $data['content'] ),
    );

    $result = $wpdb->update(
        $wpdb->prefix . 'myplugin_items',
        $sanitized,
        array(
            'id'      => absint( $item_id ),
            'user_id' => absint( $user_id ),
        ),
        array( '%s', '%s' ),
        array( '%d', '%d' )
    );

    return $result;
}

add_action( 'wp_ajax_myplugin_update_item', 'myplugin_update_item_handler' );
function myplugin_update_item_handler() {
    check_ajax_referer( 'myplugin_update_nonce', 'nonce' );

    if ( ! current_user_can( 'edit_posts' ) ) {
        wp_send_json_error( array( 'message' => 'دسترسی غیرمجاز' ), 403 );
    }

    $item_id = isset( $_POST['item_id'] ) ? absint( $_POST['item_id'] ) : 0;
    $title   = isset( $_POST['title'] )
        ? sanitize_text_field( wp_unslash( $_POST['title'] ) )
        : '';

    if ( ! $item_id || empty( $title ) ) {
        wp_send_json_error( array( 'message' => 'داده ناقص' ), 400 );
    }

    global $wpdb;

    $result = $wpdb->update(
        $wpdb->prefix . 'myplugin_items',
        array(
            'title'      => $title,
            'updated_at' => current_time( 'mysql' ),
        ),
        array( 'id' => $item_id ),
        array( '%s', '%s' ),
        array( '%d' )
    );

    if ( false === $result ) {
        wp_send_json_error( array( 'message' => 'خطا در به‌روزرسانی' ), 500 );
    }

    wp_send_json_success( array(
        'updated' => $result,
        'message' => 'با موفقیت به‌روزرسانی شد',
    ) );
}

به‌روزرسانی انبوه

function myplugin_batch_update_status( $ids, $new_status ) {
    global $wpdb;

    $table = $wpdb->prefix . 'myplugin_items';
    $count = 0;

    foreach ( $ids as $id ) {
        $result = $wpdb->update(
            $table,
            array( 'status' => $new_status ),
            array( 'id' => absint( $id ) ),
            array( '%s' ),
            array( '%d' )
        );

        if ( false !== $result ) {
            $count++;
        }
    }

    return $count;
}

function myplugin_bulk_approve( $ids ) {
    global $wpdb;

    $sanitized_ids = array_map( 'absint', (array) $ids );
    $sanitized_ids = array_filter( $sanitized_ids );

    if ( empty( $sanitized_ids ) ) {
        return 0;
    }

    $placeholders = implode( ',', array_fill( 0, count( $sanitized_ids ), '%d' ) );

    $sql = $wpdb->prepare(
        "UPDATE {$wpdb->prefix}myplugin_items
         SET status = %s, updated_at = %s
         WHERE id IN ($placeholders)",
        array_merge(
            array( 'approved', current_time( 'mysql' ) ),
            $sanitized_ids
        )
    );

    return $wpdb->query( $sql );
}

نکات امنیتی و اشتباهات رایج

تحلیل فنی پیشرفته

پرسش‌های پرتکرار

ادامه مسیر