Pular para o conteúdo

Desempenho

O desempenho em produção em Blockstudio depende de uma única opção de perfil, de um conjunto de ferramentas de medição para verificar o que ela faz e de duas técnicas de renderização que evitam trabalho repetido na página.

Sobrecarga do editor e das solicitações

O editor renderiza blocos comuns sem montar uma árvore extra de campos ocultos. Novas linhas do repetidor são inicializadas com os padrões registrados, incluindo linhas mínimas aninhadas. Os valores existentes são preservados. Os campos de recursos do editor e os controles personalizados mantêm a inicialização necessária.

A inspeção da marcação do editor usa o analisador inerte de fragmentos do navegador, reduzindo o pacote inicial de JavaScript. As propriedades dos componentes mantêm os nomes escritos em camelCase, e valores entre aspas, propriedades JSON e fragmentos de tabela continuam sendo compatíveis.

Os editores de código, classes, atributos e campos WYSIWYG são carregados quando seus controles aparecem pela primeira vez, em vez de junto com o script inicial do editor. Blocos não selecionados não baixam esses editores. As bibliotecas compartilhadas do editor são reutilizadas, e mudar um campo WYSIWYG para o modo de código carrega o editor de código somente nesse momento. O primeiro uso pode demorar mais em uma conexão lenta; os valores armazenados e os padrões dos campos ficam disponíveis antes de esses editores serem carregados. Não é necessária nenhuma configuração. Campos de código que fornecem recursos do editor ainda inicializam seus estilos ou scripts sem esperar pelo download do editor de código.

A formatação de código de HTML e CSS também é carregada sob demanda. Uma solicitação mais recente de pré-visualização de um único bloco cancela a solicitação anterior do navegador, mas mantém a pré-visualização exibida. O cancelamento não garante que PHP interrompa uma renderização que já tenha começado no servidor.

No servidor, os campos de arquivos preparam juntos seus caches de anexos, e blocos sem extensões correspondentes ignoram transformações de extensões não utilizadas. Opções comuns de solicitação são preparadas em conjunto; solicitações comuns do frontend não consultam o transient de captura de recursos do editor. Essas alterações não exigem um cache de objetos persistente nem um perfil de desempenho.

Quando o conteúdo de um post contém valores salvos de campos Blockstudio, os caches de anexos são preparados em todos os blocos antes de WordPress renderizá-los, incluindo blocos aninhados, repetidores e extensões correspondentes. Os IDs são deduplicados e carregados em lotes de até 500. Blocos individuais ainda preparam seus próprios anexos quando renderizados fora de the_content, quando usam valores padrão ou ao renderizar referências de blocos. Caches aquecidos não acionam outra consulta de anexos.

Modelos que não precisam de todos os tamanhos de imagem podem optar por uma lista menor com blockstudio/blocks/attributes/files/sizes. A saída padrão do campo de arquivos permanece inalterada, e os filtros WordPress image URL continuam sendo aplicados aos tamanhos solicitados.

Leituras repetidas das configurações reutilizam a verificação do arquivo JSON por um segundo durante uma solicitação. Processos de longa duração ainda detectam alterações nos arquivos, enquanto leituras Settings::reload() explícitas os leem imediatamente. Configurações somente no banco de dados e alterações no caminho configurado das configurações continuam valendo na leitura seguinte.

O tratamento de useBlockProps no frontend compartilha a passagem existente de limpeza de componentes, em vez de reescrever primeiro seu marcador. O tratamento de marcadores do editor permanece inalterado.

Perfis de desempenho

performance.profile ativa os padrões do frontend para produção em um só lugar:

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

compat é o padrão e não altera nada. speed e strict ativam o mesmo conjunto: removem do head a saída de gerador, emoji, feed, descoberta e posts adjacentes; descartam a descoberta oEmbed e scripts do host; desativam XML-RPC, pingbacks e a descoberta remota do editor; removem recursos genéricos do frontend do core; aplicam padrões à saída de imagens; limitam o Heartbeat fora dos editores; pré-carregam por hover ou intenção de foco documentos da mesma origem; e usam o carregador de imagens de Blockstudio.

Cada valor filho substitui o perfil, como preload.links faz acima. Remover os recursos principais do frontend é o primeiro caso a testar, pois uma página que dependa deles apresentará falhas visíveis. Runtime_Settings::current() mostra o perfil resolvido, e a tabela completa de opções está na referência de configurações.

As medições estão disponíveis programaticamente:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Quando measurement.headers está ativado, Blockstudio envia X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config e, opcionalmente, X-Blockstudio-Performance-Time. A ação blockstudio/performance/measurement_enabled recebe as configurações resolvidas do runtime.

Criador de perfil

Blockstudio inclui um criador de perfil leve que acompanha o desempenho da renderização em todo o pipeline. Ele mostra os tempos por bloco, a divisão por fase e as taxas de acerto no cache.

Ativação

Adicione ?blockstudio-perf a qualquer URL do frontend:

Código
https://example.com/my-page/?blockstudio-perf

Ou ative-o permanentemente em blockstudio.json:

JSON
{
  "dev": {
    "perf": true
  }
}

Ou por meio de um filtro:

PHP
add_filter('blockstudio/settings/dev/perf', '__return_true');

O profiler só gera dados para usuários conectados com a capacidade edit_posts. Solicitações que não receberão a saída desativam o profiler em init, para que o parâmetro de consulta ou a configuração não adicione trabalho de medição para elas.

Saída

Painel de depuração

Um painel fixo aparece na parte inferior da página com uma tabela de todas as métricas monitoradas, sua duração e o número de chamadas.

Cabeçalhos Server-Timing

Os dados de tempo também são enviados em cabeçalhos Server-Timing HTTP, visíveis na aba Network das DevTools do navegador, na seção “Timing”. Isso funciona mesmo quando a página HTML está em cache por um CDN.

Métricas monitoradas

Métrica Descrição
total Tempo total de processamento de Blockstudio
block-tags Analisador de tags de bloco (substituição de <bs:> e <block>)
assets Descoberta e injeção de recursos
tailwind Compilação de Tailwind CSS
phase:transform Transformação de atributos (por renderização de bloco)
phase:template Compilação de modelo PHP/Twig (por renderização de bloco)
phase:twig Compilação específica de Twig (por renderização de bloco)
phase:components Substituição de componentes: InnerBlocks, RichText, useBlockProps (por renderização de bloco)
block:{name} Tempo de renderização de cada tipo de bloco, com número de chamadas

Renderização em lote no processo

Exportadores de longa duração e geradores de sites estáticos podem renderizar vários documentos WordPress em um único processo PHP sem reconstruir os registros de Blockstudio. Redefina os contadores por solicitação, os recursos, o estado das ilhas, o estado do layout da página e a geração por documento de Tailwind entre documentos:

PHP
foreach ($routes as $route) {
    Blockstudio\Batch_Render::reset();
    $html = render_route($route);

    write_static_page($route, $html);
}

Batch_Render::reset() mantém aquecidos os dados de descoberta e os blocos registrados. Isso não limpa o cache.

Para coletar dependências de origem de cada bloco renderizado, observe blockstudio/render/dependencies:

PHP
$dependencies = [];

add_filter(
    'blockstudio/render/dependencies',
    function (
        array $paths,
        string $name,
        array $block,
        bool $is_editor,
        bool $is_preview
    ) use (&$dependencies): array {
        $dependencies[$name] = array_values(array_unique([
            ...($dependencies[$name] ?? []),
            ...$paths,
        ]));

        return $paths;
    },
    10,
    5
);

Os caminhos informados incluem o modelo de renderização selecionado, os arquivos de modelo encontrados e os arquivos de recursos de blocos registrados. Um coletor pode adicionar arquivos carregados separadamente ao próprio grafo de dependências. Os caminhos adicionados por um filtro também são registrados por compilações de pré-renderização estática, então um bloco que lê um arquivo de dados pode listá-lo aqui, e suas rotas serão renderizadas novamente quando o arquivo mudar.

Cache de renderização

Tags de bloco autocontidas (sem conteúdo interno) são armazenadas em cache na memória durante a renderização da página. Quando o mesmo bloco, com atributos idênticos, aparece várias vezes, as renderizações seguintes são servidas do cache. O cache é por solicitação e é limpo depois que a renderização da página termina.

O profiler mostra uma redução no número de chamadas de renderização quando o cache está ativo, facilitando verificar se o cache está funcionando.

Pré-renderização estática

Sirva páginas anônimas como conteúdo estático HTML, opcionalmente antes da inicialização de WordPress.

Cache

Os caches persistentes baseados em arquivos usados em cada solicitação.