چرا داده قدیمی در سایت شما باقی می‌ماند؟ راهنمای تخصصی delete_transient

چرا پاک‌سازی کش حیاتی است؟

تابع delete_transient چیست؟

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

function delete_transient( $transient ) {
    if ( wp_using_ext_object_cache() ) {
        $result = wp_cache_delete( $transient, 'transient' );
    } else {
        do_action( 'delete_transient', $transient );
        delete_option( '_transient_timeout_' . $transient );
        $result = delete_option( '_transient_' . $transient );
    }

    return $result;
}

سازوکار داخلی تابع

زمان صحیح پاک‌سازی

function myplugin_save_settings( $settings ) {
    update_option( 'myplugin_settings', $settings );

    delete_transient( 'myplugin_settings_cache' );
    delete_transient( 'myplugin_settings_frontend' );
}

add_action( 'save_post', 'myplugin_invalidate_post_cache' );
function myplugin_invalidate_post_cache( $post_id ) {
    delete_transient( 'myplugin_latest_posts' );
    delete_transient( 'myplugin_post_' . $post_id );
}

add_action( 'woocommerce_order_status_changed', 'myplugin_invalidate_order_cache' );
function myplugin_invalidate_order_cache() {
    delete_transient( 'myplugin_top_products' );
    delete_transient( 'myplugin_sales_stats' );
}

ترکیب با هوک‌های وردپرس

add_action( 'delete_transient', 'myplugin_log_deletion', 10, 1 );
function myplugin_log_deletion( $transient_name ) {
    if ( 0 === strpos( $transient_name, 'myplugin_' ) ) {
        if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
            error_log( sprintf( 'Transient deleted: %s', $transient_name ) );
        }
    }
}

function myplugin_flush_all_transients() {
    $prefix = 'myplugin_';
    global $wpdb;

    if ( wp_using_ext_object_cache() ) {
        // در حالت Object Cache، بهتر است از الگوی کشینگ استاندارد استفاده کنید
        return;
    }

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

    foreach ( $rows as $row ) {
        $key = str_replace(
            array( '_transient_', '_transient_timeout_' ),
            '',
            $row
        );
        delete_transient( $key );
    }
}

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

add_action( 'wp_ajax_myplugin_flush_cache', 'myplugin_flush_cache_handler' );
function myplugin_flush_cache_handler() {
    check_ajax_referer( 'myplugin_flush_nonce', 'nonce' );

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

    $transients_to_flush = array(
        'myplugin_latest_posts',
        'myplugin_top_products',
        'myplugin_category_stats',
        'myplugin_site_stats',
    );

    foreach ( $transients_to_flush as $key ) {
        delete_transient( $key );
    }

    wp_send_json_success( array(
        'message' => 'کش با موفقیت پاک شد',
        'count'   => count( $transients_to_flush ),
    ) );
}

add_action( 'transition_post_status', 'myplugin_invalidate_on_publish', 10, 3 );
function myplugin_invalidate_on_publish( $new_status, $old_status, $post ) {
    if ( 'publish' !== $new_status ) {
        return;
    }

    if ( ! in_array( $post->post_type, array( 'post', 'product' ), true ) ) {
        return;
    }

    delete_transient( 'myplugin_latest_' . $post->post_type );
    delete_transient( 'myplugin_featured_content' );
    delete_transient( 'myplugin_sitemap_cache' );
}

add_action( 'woocommerce_update_product', 'myplugin_invalidate_product_cache', 10, 1 );
function myplugin_invalidate_product_cache( $product_id ) {
    delete_transient( 'myplugin_product_' . $product_id );
    delete_transient( 'myplugin_related_' . $product_id );
    delete_transient( 'myplugin_price_range' );
}

الگوهای Cache Invalidation

function myplugin_get_versioned_cache( $base_key ) {
    $version = (int) get_option( $base_key . '_version', 1 );
    $cache_key = $base_key . '_v' . $version;

    $cached = get_transient( $cache_key );
    if ( false !== $cached ) {
        return $cached;
    }

    $data = myplugin_fetch_data();
    set_transient( $cache_key, $data, HOUR_IN_SECONDS );

    return $data;
}

function myplugin_bump_cache_version( $base_key ) {
    $version = (int) get_option( $base_key . '_version', 1 );
    update_option( $base_key . '_version', $version + 1 );
}

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

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

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

نتیجه و مسیر ادامه