چرا داده‌های شما با wpdb::insert ذخیره نمی‌شود؟ راهنمای امنیت و دقت

چرا درج امن داده حیاتی است؟

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

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

public function insert( $table, $data, $format = null ) {
    // ...
}

نقش پارامتر format

global $wpdb;

$result = $wpdb->insert(
    $wpdb->prefix . 'myplugin_log',
    array(
        'user_id'    => get_current_user_id(),
        'action'     => 'login',
        'message'    => 'ورود موفق',
        'ip_address' => $_SERVER['REMOTE_ADDR'],
        'created_at' => current_time( 'mysql' ),
    ),
    array( '%d', '%s', '%s', '%s', '%s' )
);

Sanitize پیش از درج

global $wpdb;

$data = array(
    'user_id' => absint( $_POST['user_id'] ),
    'title'   => isset( $_POST['title'] )
        ? sanitize_text_field( wp_unslash( $_POST['title'] ) )
        : '',
    'content' => isset( $_POST['content'] )
        ? wp_kses_post( wp_unslash( $_POST['content'] ) )
        : '',
    'email'   => isset( $_POST['email'] )
        ? sanitize_email( wp_unslash( $_POST['email'] ) )
        : '',
);

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

$wpdb->insert( $wpdb->prefix . 'myplugin_items', $data, $format );

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

$result = $wpdb->insert( $table, $data, $format );

if ( false === $result ) {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( sprintf(
            'Insert failed: %s | Last error: %s',
            $table,
            $wpdb->last_error
        ) );
    }
    return false;
}

$inserted_id = $wpdb->insert_id;

return $inserted_id;

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

function myplugin_log_event( $action, $message, $user_id = 0 ) {
    global $wpdb;

    $table = $wpdb->prefix . 'myplugin_events';

    $data = array(
        'user_id'    => absint( $user_id ),
        'action'     => sanitize_key( $action ),
        'message'    => sanitize_textarea_field( $message ),
        'ip_address' => isset( $_SERVER['REMOTE_ADDR'] )
            ? sanitize_text_field( wp_unslash( $_SERVER['REMOTE_ADDR'] ) )
            : '',
        'user_agent' => isset( $_SERVER['HTTP_USER_AGENT'] )
            ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) )
            : '',
        'created_at' => current_time( 'mysql' ),
    );

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

    $result = $wpdb->insert( $table, $data, $format );

    if ( false === $result ) {
        return false;
    }

    return $wpdb->insert_id;
}

add_action( 'wp_ajax_myplugin_add_item', 'myplugin_add_item_handler' );
function myplugin_add_item_handler() {
    check_ajax_referer( 'myplugin_add_item_nonce', 'nonce' );

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

    global $wpdb;

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

    if ( empty( $title ) ) {
        wp_send_json_error( array( 'message' => 'عنوان الزامی است' ), 400 );
    }

    $data = array(
        'user_id'    => get_current_user_id(),
        'title'      => $title,
        'status'     => 'active',
        'created_at' => current_time( 'mysql' ),
    );

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

    $result = $wpdb->insert( $wpdb->prefix . 'myplugin_items', $data, $format );

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

    wp_send_json_success( array(
        'id'      => $wpdb->insert_id,
        'message' => 'با موفقیت ذخیره شد',
    ) );
}

طراحی جدول سفارشی

function myplugin_create_table() {
    global $wpdb;

    $table_name      = $wpdb->prefix . 'myplugin_events';
    $charset_collate = $wpdb->get_charset_collate();

    $sql = "CREATE TABLE $table_name (
        id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
        user_id BIGINT(20) UNSIGNED NOT NULL DEFAULT 0,
        action VARCHAR(50) NOT NULL,
        message TEXT NULL,
        ip_address VARCHAR(45) NULL,
        user_agent VARCHAR(255) NULL,
        created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
        PRIMARY KEY  (id),
        KEY user_id (user_id),
        KEY action (action),
        KEY created_at (created_at)
    ) $charset_collate;";

    require_once ABSPATH . 'wp-admin/includes/upgrade.php';
    dbDelta( $sql );
}

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

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

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

ادامه مسیر