¿Cómo funciona el almacenamiento en caché de objetos?

WordPress, por defecto, realiza una forma de "Caché de Objetos" pero su duración es solo para una carga de página.

Las opciones son realmente un buen ejemplo de esto. Consulta esta respuesta para más información. El resumen:

1. Comienza una página
2. Todas las opciones se cargan con una simple sentencia SELECT option_name, option_value from $wpdb->options
3. Solicitudes posteriores para esas opciones (por ejemplo, una llamada a get_option) no acceden a la base de datos porque se almacenan con la API de caché de WP.

Las opciones siempre "viven" en la base de datos y siempre se persisten allí — esa es su fuente "canónica". Dicho esto, las opciones se cargan en la caché de objetos, por lo que cuando solicitas una opción hay un 99% de probabilidad de que esa solicitud nunca llegue a la base de datos.

Los transitorios son un poco diferentes.

WordPress te permite reemplazar la API de caché con un drop-in — un archivo que se coloca directamente en tu carpeta wp-content. Si creas tu propio drop-in de caché o usas un plugin existente, puedes hacer que la caché de objetos persista más allá de una sola carga de página. Cuando haces eso, los transitorios cambian un poco.

Echemos un vistazo a la función set_transient en wp-includes/option.php.

<?php
/**
 * Establece/actualiza el valor de un transitorio.
 *
 * No necesitas serializar valores. Si el valor necesita ser serializado, entonces
 * se serializará antes de ser establecido.
 *
 * @since 2.8.0
 * @package WordPress
 * @subpackage Transient
 *
 * @uses apply_filters() Llama al hook 'pre_set_transient_$transient' para permitir sobrescribir el
 *  valor transitorio a almacenar.
 * @uses do_action() Llama a los hooks 'set_transient_$transient' y 'setted_transient' en caso de éxito.
 *
 * @param string $transient Nombre del transitorio. Se espera que no esté escapado para SQL.
 * @param mixed $value Valor del transitorio. Se espera que no esté escapado para SQL.
 * @param int $expiration Tiempo hasta la expiración en segundos, por defecto 0
 * @return bool False si el valor no se estableció y true si se estableció.
 */
function set_transient( $transient, $value, $expiration = 0 ) {
    global $_wp_using_ext_object_cache;

    $value = apply_filters( 'pre_set_transient_' . $transient, $value );

    if ( $_wp_using_ext_object_cache ) {
        $result = wp_cache_set( $transient, $value, 'transient', $expiration );
    } else {
        $transient_timeout = '_transient_timeout_' . $transient;
        $transient = '_transient_' . $transient;
        if ( false === get_option( $transient ) ) {
            $autoload = 'yes';
            if ( $expiration ) {
                $autoload = 'no';
                add_option( $transient_timeout, time() + $expiration, '', 'no' );
            }
            $result = add_option( $transient, $value, '', $autoload );
        } else {
            if ( $expiration )
                update_option( $transient_timeout, time() + $expiration );
            $result = update_option( $transient, $value );
        }
    }
    if ( $result ) {
        do_action( 'set_transient_' . $transient );
        do_action( 'setted_transient', $transient );
    }
    return $result;
}

Hmmm ¿$_wp_using_ext_object_cache? Si es verdadero, WordPress usa la caché de objetos en lugar de la base de datos para almacenar transitorios. Entonces, ¿cómo se establece como verdadero? Es hora de explorar cómo WP configura su propia API de caché.

Puedes rastrear casi todo hasta wp-load.php o wp-settings.php — ambos son cruciales para el proceso de arranque de WordPress. En nuestro caso, hay algunas líneas relevantes en wp-settings.php.

// Inicia la caché de objetos de WordPress, o una caché de objetos externa si el drop-in está presente.
wp_start_object_cache();

¿Recuerdas lo del drop-in mencionado antes? Veamos wp_start_object_cache en wp-includes/load.php.

<?php
/**
 * Inicia la caché de objetos de WordPress.
 *
 * Si existe un archivo object-cache.php en el directorio wp-content,
 * lo usa como una caché de objetos externa.
 *
 * @access private
 * @since 3.0.0
 */
function wp_start_object_cache() {
    global $_wp_using_ext_object_cache, $blog_id;

    $first_init = false;
    if ( ! function_exists( 'wp_cache_init' ) ) {
        if ( file_exists( WP_CONTENT_DIR . '/object-cache.php' ) ) {
            require_once ( WP_CONTENT_DIR . '/object-cache.php' );
            $_wp_using_ext_object_cache = true;
        } else {
            require_once ( ABSPATH . WPINC . '/cache.php' );
            $_wp_using_ext_object_cache = false;
        }
        $first_init = true;
    } else if ( !$_wp_using_ext_object_cache && file_exists( WP_CONTENT_DIR . '/object-cache.php' ) ) {
        // A veces advanced-cache.php puede cargar object-cache.php antes de que se cargue aquí.
        // Esto rompe la verificación function_exists de arriba y puede resultar en que $_wp_using_ext_object_cache
        // se establezca incorrectamente. Verifica nuevamente si existe una caché externa.
        $_wp_using_ext_object_cache = true;
    }

    // Si la caché soporta resetear, resetea en lugar de iniciar si ya está inicializada.
    // Resetear indica a la caché que los IDs globales han cambiado y puede necesitar actualizar claves
    // y limpiar cachés.
    if ( ! $first_init && function_exists( 'wp_cache_switch_to_blog' ) )
        wp_cache_switch_to_blog( $blog_id );
    else
        wp_cache_init();

    if ( function_exists( 'wp_cache_add_global_groups' ) ) {
        wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'site-transient', 'site-options', 'site-lookup', 'blog-lookup', 'blog-details', 'rss', 'global-posts', 'blog-id-cache' ) );
        wp_cache_add_non_persistent_groups( array( 'comment', 'counts', 'plugins' ) );
    }
}

Las líneas relevantes de la función (las que se relacionan con $_wp_using_ext_object_cache que altera cómo se almacenan los transitorios).

if ( file_exists( WP_CONTENT_DIR . '/object-cache.php' ) ) {
    require_once ( WP_CONTENT_DIR . '/object-cache.php' );
    $_wp_using_ext_object_cache = true;
} else {
    require_once ( ABSPATH . WPINC . '/cache.php' );
    $_wp_using_ext_object_cache = false;
}

Si object-cache.php existe en tu directorio de contenido, se incluye y WP asume que estás usando una caché externa persistente — establece $_wp_using_ext_object_cache como verdadero.

Si estás usando una caché de objetos externa, los transitorios la usarán. Lo que lleva a la pregunta de cuándo usar opciones versus transitorios.

Simple. Si necesitas que los datos persistan indefinidamente, usa opciones. Se "cachéan", pero su fuente canónica es la base de datos y nunca desaparecerán a menos que un usuario lo solicite explícitamente.

Para datos que deben almacenarse por un período de tiempo determinado, pero que no necesitan persistir más allá de un tiempo de vida especificado, usa transitorios. Internamente, WP intentará usar una caché de objetos externa persistente si puede; de lo contrario, los datos irán a la tabla de opciones y se recolectarán como basura a través del pseudo-cron de WordPress cuando expiren.

Otras preocupaciones/preguntas:

1. ¿Está bien hacer muchas llamadas a get_option? Probablemente. Incurren en la sobrecarga de llamar a una función, pero es probable que no accedan a la base de datos. La carga de la base de datos es a menudo una preocupación mayor en la escalabilidad de aplicaciones web que el trabajo que hace tu lenguaje de elección generando una página.
2. ¿Cómo sé cuándo usar transitorios vs. la API de Caché? Si esperas que los datos persistan por un período establecido, usa la API de transitorios. Si no importa si los datos persisten (ej. no lleva mucho tiempo calcular/obtener los datos, pero no debería suceder más de una vez por carga de página), usa la API de caché.
3. ¿Se cacachéan realmente todas las opciones en cada carga de página? No necesariamente. Si llamas a add_option con su último argumento opcional como no, no se cargan automáticamente. Dicho esto, una vez que las obtienes una vez, van a la caché y las llamadas posteriores no accederán a la base de datos.