# Estático quando possível

Páginas pré-renderizadas e padrões de produção definidos em blockstudio.json.

## Pré-renderize páginas anônimas

A pré-renderização estática vem desativada por padrão. Ative `performance.staticPrerender` para que Blockstudio armazene cada documento HTML completo recebido por um visitante anônimo e responda ao próximo visitante anônimo com essa cópia.

As solicitações que precisam continuar ativas nunca o acessam: solicitações que não sejam GET, strings de consulta, administração, REST, Ajax, cron, feeds, pesquisa, pré-visualizações, páginas com nonce, todos os caminhos sob `dynamicPaths` e visitantes com sessão iniciada, a menos que `serveLoggedIn` esteja ativado.

[Pré-renderização estática](https://blockstudio.dev/pt/docs/production/static-prerendering/)

blockstudio.json

```
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

## Desativado por padrão

Nada muda até que blockstudio.json nomeie o recurso.

## Caminhos dinâmicos

Um caminho dinâmico /account abrange /account/orders, mas não /accounting.

## Marcador de exclusão

Um comentário blockstudio:no-cache mantém qualquer resposta fora do cache.

## Visitantes com sessão iniciada

Com serveLoggedIn, eles leem páginas armazenadas; as páginas deles nunca são armazenadas.

## [Desvio personalizado](https://blockstudio.dev/pt/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

O filtro static_prerender/request_bypass mantém fora das páginas armazenadas qualquer solicitação que você especificar, como uma que contenha um cookie de carrinho.

## Fila de aquecimento

Uma fila persistente renderiza novamente páginas desatualizadas no intervalo definido.

## [Rotas de cauda longa](https://blockstudio.dev/pt/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

As rotas que não estão no mapa implantado também são servidas antecipadamente, assim que WordPress as renderiza e armazena.

## Verificação da folha de estilos

Uma página armazenada cujo arquivo da folha de estilos Tailwind vinculada não existe é renderizada novamente, nunca servida sem estilos.

## Servido antes da inicialização de WordPress

Com `earlyServe` ativado, Blockstudio instala um drop-in de `advanced-cache.php` que transmite uma página armazenada antes do carregamento de WordPress, dos plugins ou do tema. Ele nunca sobrescreve um drop-in, um mapa de rotas ou uma linha de `WP_CACHE` que não tenha escrito.

Este site o utiliza. Em 8 de outubro, 2026, as páginas de blockstudio.dev responderam com `x-blockstudio-static-prerender: HIT-EARLY`, o cabeçalho enviado pelo drop-in.

[Entrega antecipada](https://blockstudio.dev/pt/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Terminal

```
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown
```

## Atualizado após cada alteração

O modo padrão `signature` preenche o cache quando não há correspondência para um visitante anônimo e o renova após alterações no site. Ao salvar ou excluir uma publicação, ela e a página inicial são removidas do cache ou colocadas na fila para renderização novamente quando o aquecimento está ativado.

O modo `graph` é destinado a ferramentas de implantação. Ele registra os arquivos lidos por cada página, para que uma compilação renderize novamente apenas as rotas cujos arquivos foram alterados e, em seguida, ative o novo conjunto como um único artefato. Se um arquivo referenciado falhar na validação, o artefato anterior continua ativo.

A instalação de um artefato compara os bytes e substitui atomicamente os documentos alterados. `last_promotion()` informa quantas rotas foram promovidas, substituídas, ignoradas ou mantidas, para que uma implantação possa registrar esse dado e comparar o ID da compilação ativa.

[Modos de assinatura e grafo](https://blockstudio.dev/pt/docs/production/static-prerendering/#signature-and-graph-modes)

deploy.php

```
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
  $result = render_with_dependencies($url);

  Static_Prerender_Runtime::persist_built_response(
    $url,
    $result['html'],
    $result['files'],
    $result['virtualHashes']
  );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

## Por trás de um CDN

O cabeçalho de pré-renderização já indica quais respostas podem ser compartilhadas com segurança. Associe `HIT` e `HIT-EARLY` a um tempo de vida `Cache-Control` na origem, armazene em cache apenas o que tiver esse tempo e ignore o cache da borda para os cookies `wordpress_logged_in_`, `wp-postpass_` e `comment_author_email_`, seu `dynamicPaths`, `wp-admin` e `wp-json`.

As páginas armazenadas em cache na borda continuam apontando para a folha de estilos com hash de conteúdo usada na renderização. Aumente `cache.namespaceGrace` para o maior tempo que uma cópia dessas pode permanecer ativa, e as folhas de estilo aposentadas ficarão no disco até esse prazo expirar.

[Configuração de CDN](https://blockstudio.dev/pt/guides/static-prerendering/#putting-a-cdn-in-front)

nginx.conf

```
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}
```

## Um bloco ativo em uma página em cache

Defina `blockstudio.island` como `dynamic`, e a página em cache levará um espaço reservado no lugar do bloco. O navegador reúne todas as ilhas dinâmicas da página e busca seus fragmentos em uma única solicitação em lote, cada um assinado com o nome do bloco e seus atributos permitidos.

`hydrate` mantém o HTML completo na página e envia apenas um evento de montagem. As ilhas dinâmicas podem aguardar até ficarem visíveis, atualizar quando um evento da janela for disparado e armazenar fragmentos em cache por usuário ou globalmente.

[Ilhas de blocos](https://blockstudio.dev/pt/docs/blocks/islands/)

block.json

```
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}
```

## Veja onde o tempo de renderização é gasto

Adicione `?blockstudio-perf` a qualquer URL do front-end para exibir em um painel os tempos de renderização por bloco, a quantidade de chamadas e as etapas de transformação, modelo e componente. Os mesmos tempos são enviados como cabeçalhos `Server-Timing`, que continuam funcionando quando um CDN armazena o HTML em cache.

Somente usuários com sessão iniciada e `edit_posts` veem a saída; todas as outras solicitações desativam o criador de perfil em `init`. `performance.measurement` adiciona cabeçalhos de perfil e hash de configuração, além de um `Performance_Measurement::snapshot()` API.

[Criador de perfil](https://blockstudio.dev/pt/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## Uma chave para os padrões de produção

Com `performance.profile` definido como `speed`, são removidas do cabeçalho as saídas do gerador, dos emojis, dos feeds e da descoberta; a descoberta via oEmbed é removida; XML-RPC e os pingbacks são desativados; os recursos genéricos do frontend do núcleo são removidos; o Heartbeat é limitado fora dos editores; e links da mesma origem são pré-carregados ao passar o cursor ou receber foco.

O padrão é `compat`, que não altera nada. Cada valor secundário substitui o perfil, permitindo manter um comportamento e adotar os demais.

[Perfis de desempenho](https://blockstudio.dev/pt/docs/production/performance/#performance-profiles)

blockstudio.json

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

## Imagens que preservam seu espaço

As imagens do tema ficam fora da biblioteca de mídia, então WordPress não conhece suas dimensões. `bs_media_image()` lê as dimensões reais de um `assets/media.json` gerado e reserva a proporção antes de o arquivo carregar.

Ative `performance.media.lazy` e a imagem real de URL ficará atrás de um espaço reservado com o tamanho correto até se aproximar da área visível.

[Mídia](https://blockstudio.dev/pt/docs/production/media/)

index.php

```
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);
```

## [Um único diretório de cache](https://blockstudio.dev/pt/docs/production/caching/)

Todos os arquivos gerados ficam em cache.path, identificados por uma identidade de tempo de execução.

## [Compilações de execução única](https://blockstudio.dev/pt/docs/production/caching/#concurrency-and-retention)

Uma solicitação compila uma chave de cache ainda não carregada. As demais aguardam, reutilizam o último payload válido ou recebem um 503 com Retry-After.

## Payloads compatíveis com OPcache

Payloads pequenos em cache são arrays PHP simples que o OPcache pode reutilizar da memória compartilhada. Os maiores permanecem compactados.

## [Cache de renderização](https://blockstudio.dev/pt/docs/production/performance/#render-cache)

Uma tag de bloco autocontida com os mesmos atributos é renderizada uma vez por solicitação. As repetições vêm da memória.

## Atualização agrupada de opções

Uma série de gravações de conteúdo, como uma importação, resulta em uma única atualização das opções preenchidas de campos armazenadas em cache.

## Caches multi-inquilino

Filtre cache/site_key para definir o limite do seu próprio inquilino e cache/context para variantes de execução do mesmo site.

## [Recursos compilados no cache](https://blockstudio.dev/pt/docs/general/settings/#assets)

Com assets.output definido como cache, os recursos compilados saem da árvore de blocos, permitindo implantar a partir de um checkout imutável.

## Compilações fragmentadas

Static_Prerender_Batch_Renderer divide uma compilação em fragmentos estáveis N/TOTAL, e quem faz a chamada pode calcular a mesma partição.

## [Incorporar folhas de estilo pequenas](https://blockstudio.dev/pt/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit insere em linha as folhas de estilo menores dos blocos, dentro de um limite de bytes e na mesma ordem da cascata.

## [Colocar CSS por último no head](https://blockstudio.dev/pt/docs/blocks/assets/registering/#load-order)

CSS do bloco é adicionado logo antes da tag de fechamento do head, depois das folhas de estilo do tema e dos plugins.

## [Ignorar recursos não utilizados](https://blockstudio.dev/pt/docs/blocks/assets/registering/#disable-enqueuing)

Um modelo que não retorna nada não enfileira recursos. assets.enqueue false deixa todos os recursos sob seu controle.

## [Comandos de cache](https://blockstudio.dev/pt/docs/dev/cli/)

wp bs cache status, cleanup e clear inspecionam, esvaziam e limpam o cache de execução. wp bs prerender purge remove as páginas armazenadas.

## Remoção limpa

wp bs teardown remove apenas o estado pertencente a esta instalação.

## Hooks de resultado

cache/outcome e static_prerender/outcome reportam ocorrências, compilações, falhas de cache e erros às suas métricas.

## [Hooks de erro](https://blockstudio.dev/pt/docs/blocks/hooks/php/#error-handling)

error/logged e error/exception encaminham erros Blockstudio para um logger ou rastreador externo.

## [Renderização em lote](https://blockstudio.dev/pt/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() limpa o estado da solicitação entre documentos no mesmo processo. render/dependencies lista os arquivos de cada bloco.

Plus

## O kit oficial de extensões

Modelos premium de site, instruções de sistema para IA e uma comunidade privada Discord. Compra única, atualizações vitalícias.

- 500+ modelos de sites
- Instruções de sistema para IA
- Atualizações vitalícias
- Comunidade privada de Discord

[Obter Plus](https://blockstudio.dev/pt/plus/)
