Almacenamiento en caché
Blockstudio incluye cachés persistentes basadas en archivos. Están habilitadas de forma predeterminada mediante el ajuste cache.enabled y se escriben en:
wp-content/blockstudio/cache/
Esta única raíz configurada contiene las cargas de compilación del entorno de ejecución, los datos precompilados de registro de bloques, los recursos del editor, Tailwind CSS, los documentos renderizados, los fragmentos de islas, los HTML estáticos, los índices de grafos, las colas de calentamiento y los diagnósticos de caché. Así se evita repetir el trabajo de descubrimiento, análisis, compilación y renderizado, y se mantiene todo el estado generado del entorno de ejecución dentro de un límite que el host puede administrar.
El valor predeterminado se encuentra deliberadamente fuera de uploads, donde los hosts reforzados pueden bloquear las cargas de caché de PHP. Cambia la ubicación con cache.path; las rutas relativas se resuelven desde WP_CONTENT_DIR, mientras que las rutas absolutas permiten usar volúmenes de caché dedicados con permisos de escritura:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Para una configuración específica del entorno, usa el filtro de ajuste o el filtro del directorio resuelto:
add_filter('blockstudio/settings/cache/path', function () {
return '/srv/wordpress-cache/blockstudio';
});
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Al cambiar la ruta, la caché empieza en frío. Ya no se leen los archivos antiguos de wp-content/uploads/blockstudio/cache y se pueden eliminar.
Identidad e invalidación
Cada ámbito está anidado bajo una identidad de red/blog y una identidad completa del entorno de ejecución. Las entradas de caché cambian cuando cambian sus datos de entrada, incluidos los archivos de bloque supervisados, los archivos de campos, las dependencias de recursos, los ajustes, el tema activo, los plugins activos, los inventarios lógicos de descubrimiento, WordPress, PHP y las versiones de Blockstudio. Los hashes de dependencias específicos de cada elemento aíslan las compilaciones que solo incluyen cambios de los objetos no relacionados.
Las fuentes de descubrimiento lógico también aportan su ID de origen, la huella digital del contenido y las entradas supervisadas. Las selecciones alternativas del entorno de ejecución pueden añadir un valor de blockstudio/cache/context para aislar todos los ámbitos de caché.
Los hosts cuyo límite de inquilino difiere de los ID de red/blog de WordPress pueden filtrar blockstudio/cache/site_key; el resultado se depura antes de convertirse en un segmento de ruta.
En una solicitud activa del frontend, Blockstudio hidrata el registro del entorno de ejecución antes de construir las fuentes de descubrimiento. Por tanto, un acierto válido de caché omite el descubrimiento recursivo de fuentes, la construcción de bloques, el análisis de campos y los recorridos repetidos del árbol de claves de caché.
La carga útil del entorno de ejecución también guarda las rutas resueltas de los recursos de bloques, sus tamaños, marcas de tiempo y listas de hojas de estilo de módulos. Las solicitudes posteriores reutilizan esos metadatos, en lugar de repetir las búsquedas de salida de recursos y los análisis de directorios de módulos para cada bloque renderizado. Los filtros de URL de recursos y de desactivación siguen ejecutándose en la solicitud actual, y assets.inlineLimit mantiene su presupuesto para toda la página y el orden en cascada. No se recopilan metadatos de salida de recursos cuando assets.enqueue o el almacenamiento en caché persistente están desactivados. Una compilación válida anterior pero obsoleta recurre a resolver sus recursos desde el disco.
La configuración resuelta que no ha cambiado también reutiliza su huella digital durante la solicitud. Al recargar o cambiar la configuración, esta se invalida; los valores mutables de objetos o referencias se vuelven a calcular en lugar de reutilizar una huella que podría estar desactualizada.
En production y staging, se confía durante 20 segundos en una instantánea de supervisión validada antes de que Blockstudio vuelva a consultar las estadísticas de sus archivos y directorios. Los entornos local y development usan cero de forma predeterminada para que las modificaciones en el código fuente se vean de inmediato. Cambia ese intervalo con:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
La espera puede retrasar la detección automática de cambios en el código fuente como máximo el número de segundos configurado. Los recursos compilados necesarios, los recursos sin procesar en caché que no estén vacíos y las hojas de estilo de los módulos se siguen comprobando en cada acierto de caché. Al borrar uno, la carga útil del entorno de ejecución se invalida de inmediato, en lugar de servir metadatos de recursos desactualizados hasta que venza el intervalo. Establezca la espera en 0 si también se usa un entorno similar al de producción para editar archivos activamente.
Las cargas útiles de la caché están protegidas por archivos PHP. Las cargas pequeñas usan matrices simples cuando el proceso de escritura tiene memoria compartida de OPcache activa y el destino no está excluido. Así, OPcache puede reutilizar la matriz compilada en inclusiones posteriores; modificar los datos devueltos sigue usando el comportamiento normal de copia en escritura de PHP.
Sin OPcache de memoria compartida, las cargas útiles siguen siendo datos serializados comprimidos. Esto también se aplica cuando OPcache está lleno, su API no está disponible o tiene restricciones, o su lista de exclusión o opcache.max_file_size excluye el archivo. El OPcache que solo almacena archivos en caché no selecciona el formato de matriz simple. Consulte la configuración de OPcache PHP para ver esos controles del host.
El formato de matriz simple predeterminado tiene un límite de 1 MiB, calculado tanto sobre los datos serializados como sobre el código fuente PHP generado. Las cargas útiles mayores siguen comprimidas para evitar los costes de compilación de matrices grandes cuando un proceso CLI sin OPcache lee una caché preparada por procesos de trabajo web.
Los archivos simples pequeños siguen necesitando análisis en ese tipo de lector, y puede que los archivos recién escritos necesiten compilación durante opcache.file_update_protection.
El filtro blockstudio/cache/compress anula el formato por ámbito, por ejemplo, cuando WP-CLI prepara archivos de caché para procesos de trabajo web con OPcache habilitado. Devolver false también anula el límite de tamaño: hágalo solo si todos los lectores pueden manejar el archivo PHP generado. Si zlib no está disponible, PHP simple sigue siendo la alternativa.
Concurrencia y retención
Las claves de caché en frío usan un bloqueo de ejecución única. Una solicitud crea la carga mientras las solicitudes simultáneas esperan el resultado publicado de forma atómica, en lugar de repetir el mismo trabajo de descubrimiento o compilación. La publicación atómica evita objetos parciales. Si falla una actualización, el último objeto válido sigue disponible, el error queda visible y la siguiente solicitud puede recuperarse.
Los ámbitos del entorno de ejecución conservan 20 cargas publicadas de forma predeterminada. Ajusta el límite por ámbito si una integración crea intencionalmente más contextos de caché:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
La retención nunca expulsa un archivo al que haga referencia el mapa instalado de servicio anticipado, y el filtro blockstudio/cache/protected_paths marca las rutas adicionales que la depuración debe conservar.
Los espacios de nombres sin usar se recopilan automáticamente, en lugar de acumularse con cada activación de plugin y cada actualización de PHP o WordPress. Un fragmento de implementación que antes buscaba archivos con comodines en el antiguo directorio de caché Tailwind debería llamar a Blockstudio\Runtime_Cache::purge('tailwind').
Un espacio de nombres se retira cuando cambia la identidad del entorno de ejecución, por ejemplo, tras una actualización del núcleo de WordPress. La primera tarea de limpieza que lo detecta como retirado escribe en él un marcador .retired, y el árbol se elimina una vez transcurridos cache.namespaceGrace segundos desde entonces (un día de forma predeterminada). Si se vuelve a escribir en el árbol durante ese periodo, el plazo de espera se reinicia; no se elimina ni el espacio de nombres actual de un ámbito ni uno desde el que el mapa de servicio anticipado siga sirviendo un artefacto activado. El periodo de espera de este último comienza cuando la siguiente activación mueve la entrada del mapa a otro sitio. Las páginas almacenadas en caché fuera de WordPress siguen enlazando a las hojas de estilo con hash de contenido con las que se generaron. Por tanto, si un sitio sirve páginas tailwind.output: "link" a través de una CDN o con una caché larga del navegador, aumenta el periodo de espera para que dure tanto como pueda existir una copia de este tipo:
{
"cache": {
"namespaceGrace": 777600
}
}
Cuando una instalación actualizada contiene el directorio plano cache/runtime anterior a la versión 7.6, Blockstudio lo cambia de nombre de forma atómica para sacarlo de la ruta activa. A continuación, una tarea WP-Cron elimina como máximo 500 entradas del sistema de archivos en cada ciclo. Así se evita que las antiguas cargas y los árboles de .build.lock ocupen espacio en el disco, sin hacer que la solicitud que detecta un directorio grande lo elimine de forma recursiva. La limpieza solo se ejecuta cuando cache.enabled está activo; cambia el tamaño del lote con blockstudio/cache/legacy_cleanup_batch_size si el host necesita ciclos más pequeños o más grandes.
Desactiva las cachés persistentes en blockstudio.json:
{
"cache": {
"enabled": false
}
}
O mediante un filtro:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
La caché de renderizado en memoria por solicitud descrita en Rendimiento es deliberadamente independiente, pero sus artefactos persistentes usan este mismo límite del sistema de archivos.
Vaciar una acumulación de bloqueos antiguos
Las versiones anteriores a 7.6.14 dejaban un archivo .build.lock por cada cambio de contenido, y un sitio con mucho tráfico puede tener cientos de miles. Tras la actualización, WP-Cron los elimina automáticamente en lotes limitados. Para vaciar la acumulación de inmediato e informar al host de la cantidad, ejecuta el CLI:
wp bs cache status
wp bs cache cleanup
status cuenta los bloqueos antiguos restantes e indica cuándo se ejecutará el siguiente lote. cleanup ejecuta lotes hasta que no quede ningún bloqueo inactivo y, después, recopila los espacios de nombres de caché cuyo periodo de espera haya pasado. Los bloqueos de menos de una hora o que aún mantenga una solicitud en ejecución se dejan para el siguiente ciclo. Nunca elimines archivos de bloqueo manualmente mientras el sitio atiende tráfico: un bloqueo activo es lo que evita que solicitudes simultáneas compilen en paralelo.
wp bs cache clear purga toda la caché del entorno de ejecución del sitio actual, o un ámbito en todos los espacios de nombres con --scope=runtime. La siguiente solicitud la reconstruye en frío, así que ejecútalo cuando haya poco tráfico.
Caché de Tailwind
La caché Tailwind compilada de CSS usa la raíz de ejecución compartida en su espacio de nombres network/site/runtime y ámbito tailwind. Almacena hasta 1,000 entradas durante 30 días de forma predeterminada, suficiente para conservar las claves de nivel de página de un sitio completo en lugar de expulsarlas tras unas pocas rutas.
Tailwind también reutiliza un compilador activo para la misma entrada CSS en procesos de larga duración y conserva el estado de construcción del compilador entre procesos. Los conjuntos de candidatos de página en frío se compilan de forma independiente, pero no es necesario reconstruir el analizador del framework cada vez.
Usa estos filtros para cambiar la retención:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
La antigüedad mínima es de una hora.
Los archivos de caché tienen hashes de contenido, y una página almacenada en caché enlaza a uno por URL, por lo que la expulsión y la página guardada pueden diferir sobre qué archivos siguen siendo necesarios. Antes de servirlos, se comprueba que los documentos prerenderizados coincidan con la hoja de estilo enlazada. Así, un archivo expulsado requiere volver a renderizar la página en lugar de mostrarla sin estilos. Si aumentas cache_max_files por encima del número de claves de página distintas, evitarás por completo ese nuevo renderizado.
La caché HTML anónima que se encuentra bajo esta misma raíz.