چرا کش شما هرگز اعتبارسنجی نمی‌شود؟ راهنمای تابع get_transient

چرا Transient API یک ابزار حیاتی است؟

تابع get_transient چیست؟

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

function get_transient( $transient ) {
    if ( wp_using_ext_object_cache() ) {
        $value = wp_cache_get( $transient, 'transient' );
    } else {
        $value = get_option( '_transient_' . $transient );
    }

    if ( false !== $value ) {
        // بررسی انقضا برای حالت دیتابیس
        return $value;
    }

    return false;
}

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

تله مقدار false

function myplugin_get_data() {
    $cached = get_transient( 'myplugin_data' );

    if ( ! $cached ) {
        // این شرط اگر $cached برابر false یا آرایه خالی یا صفر باشد، true می‌شود
        $cached = myplugin_fetch_data();
        set_transient( 'myplugin_data', $cached, HOUR_IN_SECONDS );
    }

    return $cached;
}

function myplugin_get_data() {
    $cached = get_transient( 'myplugin_data' );

    if ( false === $cached ) {
        // این شرط تنها در صورت نبود داده یا انقضا، true می‌شود
        $cached = myplugin_fetch_data();
        set_transient( 'myplugin_data', $cached, HOUR_IN_SECONDS );
    }

    return $cached;
}

مدیریت expiration

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

function myplugin_get_exchange_rate( $currency ) {
    $cache_key = 'myplugin_rate_' . strtolower( $currency );
    $cached = get_transient( $cache_key );

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

    $response = wp_remote_get(
        'https://api.exchangerate.com/v1/latest?base=' . rawurlencode( $currency ),
        array( 'timeout' => 10 )
    );

    if ( is_wp_error( $response ) ) {
        return 0;
    }

    $status = wp_remote_retrieve_response_code( $response );
    if ( 200 !== $status ) {
        return 0;
    }

    $body = wp_remote_retrieve_body( $response );
    $data = json_decode( $body, true );

    if ( ! isset( $data['rate'] ) ) {
        return 0;
    }

    $rate = (float) $data['rate'];
    set_transient( $cache_key, $rate, HOUR_IN_SECONDS );

    return $rate;
}

function myplugin_get_top_products() {
    $cached = get_transient( 'myplugin_top_products' );

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

    global $wpdb;
    $rows = $wpdb->get_results(
        'SELECT p.ID, p.post_title, SUM(o.total) AS revenue
         FROM {$wpdb->posts} p
         INNER JOIN {$wpdb->prefix}order_stats o ON p.ID = o.product_id
         WHERE p.post_type = "product"
         GROUP BY p.ID
         ORDER BY revenue DESC
         LIMIT 10',
        ARRAY_A
    );

    $result = is_array( $rows ) ? $rows : array();
    set_transient( 'myplugin_top_products', $result, 6 * HOUR_IN_SECONDS );

    return $result;
}

function myplugin_get_statistics() {
    $cached = get_transient( 'myplugin_stats' );

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

    $stats = array(
        'total_users'     => count_users()['total_users'],
        'active_sessions' => myplugin_count_sessions(),
        'avg_order'       => myplugin_calculate_avg_order(),
    );

    set_transient( 'myplugin_stats', $stats, 15 * MINUTE_IN_SECONDS );

    return $stats;
}

ترکیب با Object Cache

if ( wp_using_ext_object_cache() ) {
    // سایت از Redis یا Memcached استفاده می‌کند
}

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

$cached = get_transient( 'myplugin_data' );
if ( false === $cached || ! is_array( $cached ) ) {
    // بازخوانی داده
}

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

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

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