چرا داده‌های افزونه شما در پایگاه داده باقی می‌ماند؟ راهنمای delete_option

چرا حذف درست داده اهمیت دارد؟

تابع delete_option چیست؟

امضای تابع و پارامترها

function delete_option( $option ) {
    global $wpdb;

    if ( ! isset( $option ) ) {
        return false;
    }

    $option = trim( $option );
    if ( empty( $option ) ) {
        return false;
    }

    do_action( 'delete_option', $option );

    $row = $wpdb->get_row( $wpdb->prepare(
        "SELECT option_name, option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1",
        $option
    ) );

    if ( ! is_object( $row ) ) {
        return false;
    }

    $value = $row->option_value;

    do_action( "delete_option_{$option}", $option, $value );

    if ( ! wp_installing() ) {
        wp_cache_delete( $option, 'options' );
        wp_cache_delete( 'alloptions', 'options' );
    }

    $result = $wpdb->query( $wpdb->prepare(
        "DELETE FROM $wpdb->options WHERE option_name = %s",
        $option
    ) );

    return $result;
}

سازوکار داخلی و مقدار بازگشتی

چرخه عمر داده افزونه

register_activation_hook( __FILE__, 'myplugin_activate' );
function myplugin_activate() {
    if ( false === get_option( 'myplugin_settings' ) ) {
        add_option( 'myplugin_settings', myplugin_get_default_settings(), '', false );
    }
}

register_deactivation_hook( __FILE__, 'myplugin_deactivate' );
function myplugin_deactivate() {
    delete_transient( 'myplugin_cache' );
    delete_transient( 'myplugin_stats' );
}

// uninstall.php
if ( ! defined( 'WP_UNINSTALL_PLUGIN' ) ) {
    exit;
}

$options = array(
    'myplugin_settings',
    'myplugin_api_key',
    'myplugin_enabled',
    'myplugin_state',
);

foreach ( $options as $option ) {
    delete_option( $option );
}

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

add_action( 'wp_ajax_myplugin_reset_settings', 'myplugin_reset_settings_handler' );
function myplugin_reset_settings_handler() {
    check_ajax_referer( 'myplugin_reset_nonce', 'nonce' );

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

    $options_to_delete = array(
        'myplugin_settings',
        'myplugin_api_key',
        'myplugin_state',
    );

    $deleted = array();
    foreach ( $options_to_delete as $option ) {
        if ( delete_option( $option ) ) {
            $deleted[] = $option;
        }
    }

    delete_transient( 'myplugin_cache' );

    wp_send_json_success( array(
        'message' => 'تنظیمات بازنشانی شد',
        'deleted' => $deleted,
    ) );
}

function myplugin_delete_all_options() {
    global $wpdb;

    $prefix = 'myplugin_';
    $rows = $wpdb->get_col( $wpdb->prepare(
        "SELECT option_name FROM {$wpdb->options}
         WHERE option_name LIKE %s",
        $wpdb->esc_like( $prefix ) . '%'
    ) );

    if ( ! is_array( $rows ) ) {
        return 0;
    }

    $count = 0;
    foreach ( $rows as $option_name ) {
        if ( delete_option( $option_name ) ) {
            $count++;
        }
    }

    return $count;
}

register_deactivation_hook( __FILE__, 'myplugin_deactivate_cleanup' );
function myplugin_deactivate_cleanup() {
    delete_option( 'myplugin_temp_state' );
    delete_option( 'myplugin_runtime_cache' );

    delete_transient( 'myplugin_api_cache' );
    delete_transient( 'myplugin_stats_cache' );
}

هوک‌های مرتبط با حذف

add_action( 'delete_option_myplugin_settings', 'myplugin_on_settings_deleted', 10, 2 );
function myplugin_on_settings_deleted( $option, $value ) {
    delete_transient( 'myplugin_cache' );
    delete_transient( 'myplugin_stats' );

    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( sprintf(
            'Option deleted: %s with size %d bytes',
            $option,
            strlen( maybe_serialize( $value ) )
        ) );
    }
}

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

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

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

ادامه مسیر