Pular para o conteúdo

Armazenamento em cache

Blockstudio inclui caches persistentes baseados em arquivos. Eles são ativados por padrão pela configuração cache.enabled e gravados em:

Código
wp-content/blockstudio/cache/

Essa única raiz configurada contém cargas de build do runtime, dados pré-compilados de registro de blocos, recursos do editor, Tailwind CSS, documentos renderizados, fragmentos de ilhas, HTML estáticos, índices de grafo, filas aquecidas e diagnósticos de cache. Isso evita repetir tarefas de descoberta, análise, compilação e renderização, mantendo todo o estado de runtime gerado sob um limite gerenciável pelo host.

O padrão fica deliberadamente fora de uploads, onde hosts com segurança reforçada podem bloquear cargas de cache PHP. Altere o local com cache.path; caminhos relativos são resolvidos a partir de WP_CONTENT_DIR, enquanto caminhos absolutos permitem volumes de cache graváveis dedicados:

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Para configuração específica do ambiente, use o filtro de configuração ou o filtro do diretório resolvido:

PHP
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';
});

Alterar o caminho inicia com um cache frio. Os arquivos antigos em wp-content/uploads/blockstudio/cache deixam de ser lidos e podem ser removidos.

Identidade e invalidação

Cada escopo fica aninhado sob uma identidade de rede/blog e uma identidade completa de runtime. As entradas de cache mudam quando suas entradas mudam, incluindo arquivos de bloco monitorados, arquivos de campo, dependências de recursos, configurações, o tema ativo, plugins ativos, inventários de descoberta lógica, WordPress, PHP e versões de Blockstudio. Hashes de dependências específicos de cada item isolam builds que incluem apenas alterações de objetos não relacionados.

Fontes de descoberta lógica também fornecem seu ID de origem, impressão digital do conteúdo e entradas monitoradas. Seleções alternativas de ambiente de execução podem adicionar um valor blockstudio/cache/context para isolar todos os escopos de cache. Hosts cujo limite do locatário difere dos IDs de rede/blog WordPress podem filtrar blockstudio/cache/site_key; o resultado é sanitizado antes de se tornar um segmento do caminho.

Em uma solicitação aquecida do frontend, Blockstudio hidrata o registro do runtime antes de construir as fontes de descoberta. Assim, um acerto válido no cache ignora a descoberta recursiva de fontes, a construção de blocos, a análise de campos e as repetidas percorridas da árvore de chaves de cache.

A carga útil do ambiente de execução também armazena caminhos resolvidos dos recursos de blocos, tamanhos, registros de data e hora e listas de folhas de estilo dos módulos. Solicitações aquecidas reutilizam esses metadados em vez de repetir as consultas à saída de recursos e as varreduras de diretórios de módulos para cada bloco renderizado. Os filtros de URL de recursos e de desativação ainda são executados na solicitação atual, e assets.inlineLimit mantém seu orçamento para toda a página e a ordem em cascata. Nenhum metadado da saída de recursos é coletado quando assets.enqueue ou o cache persistente está desativado. Uma compilação antiga da última versão válida resolve os recursos novamente no disco.

Configurações resolvidas que não foram alteradas também reutilizam sua impressão digital durante a solicitação. Recarregar ou alterar as configurações a invalida; valores de objetos ou referências mutáveis são recalculados, em vez de reutilizar uma impressão digital potencialmente desatualizada.

Em production e staging, um instantâneo validado de monitoramento é confiável por 20 segundos antes que Blockstudio verifique novamente os arquivos e diretórios. Os ambientes local e development usam zero por padrão para que as edições nas fontes sejam percebidas imediatamente. Altere esse intervalo com:

PHP
add_filter('blockstudio/cache/watch_debounce', function () {
    return 30;
});

O debounce pode atrasar a detecção automática de alterações na origem em até o número configurado de segundos. Os recursos compilados necessários, os recursos brutos não vazios em cache e as folhas de estilo dos módulos ainda são verificados em cada acerto de cache. Excluir um deles invalida imediatamente a carga útil do runtime, em vez de servir metadados de recursos desatualizados até o fim do intervalo. Defina o debounce como 0 quando um ambiente semelhante ao de produção também for usado para editar arquivos ativamente.

As cargas úteis do cache são arquivos protegidos por PHP. Cargas pequenas usam arrays simples quando o processo de gravação tem memória compartilhada ativa do OPcache e o destino não está excluído. Assim, o OPcache pode reutilizar o array compilado em inclusões posteriores; modificar os dados retornados continua usando o comportamento normal de cópia na gravação de PHP.

Sem OPcache com memória compartilhada, as cargas úteis continuam sendo dados serializados compactados. Isso também se aplica quando o OPcache está cheio, seu API não está disponível ou tem restrições, ou quando sua lista de bloqueio ou opcache.max_file_size exclui o arquivo. O OPcache somente para cache de arquivos não seleciona o formato de array simples. Consulte a configuração do OPcache no nível do host PHP para esses controles.

O formato padrão de array simples tem um limite de 1 MiB, medido tanto em relação aos dados serializados quanto ao código-fonte PHP gerado. Cargas maiores continuam compactadas para evitar custos de compilação de arrays grandes quando um processo CLI sem OPcache lê um cache aquecido por workers da Web. Arquivos simples pequenos ainda precisam ser analisados por esse leitor, e arquivos recém-gravados podem precisar ser compilados durante opcache.file_update_protection.

O filtro blockstudio/cache/compress substitui o formato por escopo, por exemplo, quando WP-CLI aquece arquivos de cache para workers da Web com OPcache ativado. Retornar false também substitui o limite de tamanho: faça isso somente quando todos os leitores puderem lidar com o arquivo PHP gerado. Se zlib não estiver disponível, PHP simples continuará sendo a alternativa.

Concorrência e retenção

As chaves de cache frio usam um bloqueio de execução única. Uma solicitação cria a carga enquanto as solicitações simultâneas aguardam o resultado publicado atomicamente, em vez de repetir o mesmo trabalho de descoberta ou compilação. A publicação atômica impede objetos parciais. Quando uma atualização falha, um objeto válido da última execução bem-sucedida continua disponível, a falha pode ser observada e a próxima solicitação pode se recuperar.

Os escopos de runtime retêm 20 cargas publicadas por padrão. Ajuste o limite por escopo quando uma integração criar intencionalmente mais contextos de cache:

PHP
add_filter(
    'blockstudio/cache/max_files_per_scope',
    function (int $maximum, string $scope): int {
        return 'runtime' === $scope ? 50 : $maximum;
    },
    10,
    2
);

A retenção nunca remove um arquivo referenciado pelo mapa instalado de disponibilização antecipada, e o filtro blockstudio/cache/protected_paths marca caminhos adicionais que a limpeza deve preservar.

Namespaces não usados são coletados automaticamente, em vez de se acumularem a cada ativação de plugin e atualização de PHP ou WordPress. Um trecho de implantação que antes usava um padrão glob para o antigo diretório de cache Tailwind deve chamar Blockstudio\Runtime_Cache::purge('tailwind').

Um namespace é desativado quando a identidade do runtime muda, por exemplo, após uma atualização do núcleo WordPress. A primeira varredura de limpeza que o encontra desativado grava nele um marcador .retired, e a árvore é coletada quando tiverem passado cache.namespaceGrace segundos (um dia por padrão). Se a árvore for gravada novamente nesse período, o prazo de carência recomeça. O namespace atual de um escopo nunca é coletado, nem aquele do qual o mapa de disponibilização antecipada ainda serve um artefato ativado; nesse último caso, o prazo de carência começa quando a próxima ativação mover a entrada do mapa para outro local. Páginas armazenadas em cache fora de WordPress continuam vinculando as folhas de estilo com hash de conteúdo com as quais foram renderizadas. Portanto, um site que serve páginas tailwind.output: "link" por meio de um CDN ou de um cache longo do navegador deve aumentar o prazo de carência para o maior tempo que uma cópia dessas páginas pode permanecer disponível:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Quando uma instalação atualizada contém o diretório plano cache/runtime anterior à versão 7.6, Blockstudio o renomeia atomicamente, removendo-o do caminho ativo. Um job WP-Cron remove então no máximo 500 entradas do sistema de arquivos por execução. Isso impede que árvores antigas de cargas e de .build.lock consumam espaço em disco sem que a solicitação que detecta um diretório grande precise excluí-lo recursivamente. A limpeza só é executada enquanto cache.enabled estiver ativo; altere o tamanho dos lotes com blockstudio/cache/legacy_cleanup_batch_size quando o host precisar de execuções menores ou maiores.

Desative os caches persistentes em blockstudio.json:

JSON
{
  "cache": {
    "enabled": false
  }
}

Ou por meio de um filtro:

PHP
add_filter('blockstudio/settings/cache/enabled', '__return_false');

O cache de renderização em memória por solicitação, descrito em Desempenho, é intencionalmente separado, mas seus artefatos persistentes usam esse mesmo limite do sistema de arquivos.

Esvaziar uma fila acumulada de bloqueios legados

Versões anteriores a 7.6.14 deixavam um arquivo .build.lock para cada alteração de conteúdo, e um site movimentado pode acumular centenas de milhares deles. Após a atualização, WP-Cron os remove automaticamente em lotes limitados. Para esvaziar a fila imediatamente e informar um número ao seu host, execute o CLI:

Shell
wp bs cache status
wp bs cache cleanup

status conta os bloqueios legados restantes e informa quando o próximo lote será executado. cleanup executa lotes até que não reste nada ocioso e, em seguida, coleta namespaces de cache cujo prazo de carência expirou. Bloqueios com menos de uma hora ou ainda mantidos por uma solicitação em execução são deixados para a próxima execução. Nunca exclua arquivos de bloqueio manualmente enquanto o site estiver recebendo tráfego; um bloqueio ativo é o mecanismo de eleição que impede solicitações simultâneas de compilar em paralelo.

wp bs cache clear limpa todo o cache do runtime do site atual ou um escopo em todos os namespaces com --scope=runtime. A próxima solicitação será recompilada a frio; portanto, execute o comando em um horário de pouco tráfego.

Cache Tailwind

O cache compilado CSS de Tailwind usa a raiz compartilhada do runtime, no namespace rede/site/runtime, e o escopo tailwind. Por padrão, armazena até 1,000 entradas por 30 dias, o suficiente para reter as chaves de página de um site inteiro, em vez de removê-las após poucas rotas.

Tailwind também reutiliza um compilador aquecido para a mesma entrada CSS em processos de longa duração e persiste o estado de construção do compilador entre processos. Conjuntos de candidatos a páginas frios ainda são compilados de forma independente, mas não precisam reconstruir o analisador do framework a cada vez.

Use estes filtros para alterar a retenção:

PHP
add_filter('blockstudio/tailwind/cache_max_files', function () {
    return 1500;
});

add_filter('blockstudio/tailwind/cache_max_age', function () {
    return 14 * DAY_IN_SECONDS;
});

A idade mínima é de uma hora.

Os arquivos de cache têm hash de conteúdo, e uma página em cache vincula um deles por URL; por isso, a remoção de arquivos e uma página armazenada podem divergir sobre quais arquivos ainda são necessários. Antes de servir documentos pré-renderizados, eles são verificados em relação à folha de estilo vinculada. Assim, a remoção de um arquivo custa uma nova renderização, em vez de resultar em uma página sem estilos. Aumentar cache_max_files para um valor superior ao número de chaves distintas no nível da página evita totalmente a nova renderização.

Pré-renderização estática

O cache HTML anônimo que fica sob essa mesma raiz.