چرا یک کوئری اشتباه کل داده‌های شما را پاک می‌کند؟ راهنمای wpdb::delete

چرا حذف امن حیاتی است؟

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

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

public function delete( $table, $where, $where_format = null ) {
    // ...
}

نقش حیاتی where

global $wpdb;

$wpdb->delete(
    $wpdb->prefix . 'myplugin_logs',
    array( 'id' => 42 ),
    array( '%d' )
);

$wpdb->delete(
    $wpdb->prefix . 'myplugin_items',
    array(
        'user_id' => get_current_user_id(),
        'id'      => absint( $item_id ),
    ),
    array( '%d', '%d' )
);

مقدار بازگشتی

$result = $wpdb->delete( $table, $where, $where_format );

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

if ( 0 === $result ) {
    return 'not_found';
}

return 'deleted';

حذف نرم به‌جای حذف دائمی

function myplugin_soft_delete_item( $item_id, $user_id ) {
    global $wpdb;

    return $wpdb->update(
        $wpdb->prefix . 'myplugin_items',
        array(
            'status'     => 'deleted',
            'deleted_at' => current_time( 'mysql' ),
        ),
        array(
            'id'      => absint( $item_id ),
            'user_id' => absint( $user_id ),
        ),
        array( '%s', '%s' ),
        array( '%d', '%d' )
    );
}

function myplugin_purge_soft_deleted() {
    global $wpdb;

    $cutoff = gmdate( 'Y-m-d H:i:s', strtotime( '-30 days' ) );

    return $wpdb->query( $wpdb->prepare(
        "DELETE FROM {$wpdb->prefix}myplugin_items
         WHERE status = %s AND deleted_at < %s",
        'deleted',
        $cutoff
    ) );
}

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

function myplugin_delete_old_logs( $days = 30 ) {
    global $wpdb;

    $cutoff = gmdate( 'Y-m-d H:i:s', strtotime( '-' . absint( $days ) . ' days' ) );

    return $wpdb->query( $wpdb->prepare(
        "DELETE FROM {$wpdb->prefix}myplugin_events
         WHERE created_at < %s",
        $cutoff
    ) );
}

function myplugin_delete_user_item( $item_id ) {
    global $wpdb;

    $user_id = get_current_user_id();

    if ( ! $user_id ) {
        return false;
    }

    $item = $wpdb->get_row( $wpdb->prepare(
        "SELECT id, user_id FROM {$wpdb->prefix}myplugin_items WHERE id = %d",
        absint( $item_id )
    ) );

    if ( ! $item ) {
        return 'not_found';
    }

    if ( (int) $item->user_id !== $user_id && ! current_user_can( 'manage_options' ) ) {
        return 'forbidden';
    }

    return $wpdb->delete(
        $wpdb->prefix . 'myplugin_items',
        array( 'id' => absint( $item_id ) ),
        array( '%d' )
    );
}

add_action( 'wp_ajax_myplugin_delete_item', 'myplugin_delete_item_handler' );
function myplugin_delete_item_handler() {
    check_ajax_referer( 'myplugin_delete_nonce', 'nonce' );

    if ( ! is_user_logged_in() ) {
        wp_send_json_error( array( 'message' => 'ابتدا وارد شوید' ), 401 );
    }

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

    if ( ! $item_id ) {
        wp_send_json_error( array( 'message' => 'شناسه نامعتبر' ), 400 );
    }

    $result = myplugin_delete_user_item( $item_id );

    if ( 'not_found' === $result ) {
        wp_send_json_error( array( 'message' => 'رکورد پیدا نشد' ), 404 );
    }

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

    if ( false === $result ) {
        wp_send_json_error( array( 'message' => 'خطا در حذف' ), 500 );
    }

    wp_send_json_success( array( 'message' => 'با موفقیت حذف شد' ) );
}

پاک‌سازی دوره‌ای داده

add_action( 'myplugin_daily_cleanup', 'myplugin_run_daily_cleanup' );

function myplugin_schedule_cleanup() {
    if ( ! wp_next_scheduled( 'myplugin_daily_cleanup' ) ) {
        wp_schedule_event( time(), 'daily', 'myplugin_daily_cleanup' );
    }
}
register_activation_hook( __FILE__, 'myplugin_schedule_cleanup' );

function myplugin_run_daily_cleanup() {
    global $wpdb;

    // حذف لاگ‌های قدیمی‌تر از ۳۰ روز
    $cutoff = gmdate( 'Y-m-d H:i:s', strtotime( '-30 days' ) );

    $deleted = $wpdb->query( $wpdb->prepare(
        "DELETE FROM {$wpdb->prefix}myplugin_events
         WHERE created_at < %s",
        $cutoff
    ) );

    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( sprintf(
            '[myplugin] Daily cleanup: %d rows deleted',
            (int) $deleted
        ) );
    }
}

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

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

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

ادامه مسیر