# Cache do Site

Source: https://support.kapsulehost.com/pt-pt/site-cache

A cache é o maior ganho de velocidade isolado disponível para um site WordPress: a cache de página completa serve HTML já pronto sem executar o PHP de todo, e a cache de objetos mantém resultados da base de dados em memória. Este guia aborda ambas, o que ignora a cache automaticamente, e como limpar e aquecer a cache.

## Onde Vive a Cache no KPanel

1. Inicie sessão no [KPanel](https://kpanel.kapsulehost.com).
2. Clique em **Websites** na barra lateral esquerda e depois clique no site.
3. No menu esquerdo do site, abra **WordPress** e depois **Colocação em cache**.

O endereço direto é `/websites/<site-id>/cache`.

![Definições de cache para um site no KPanel](https://support.kapsulehost.com/help/screenshots/site-cache.ebc987e4.webp)

> **Note:** O grupo **WordPress** só aparece para sites WordPress e WooCommerce. A cache aqui é um benefício de plano: a cache de página completa e a cache de objetos estão incluídas no Managed WordPress. Noutros planos, a página mostra um painel de upgrade a descrever o que está disponível em vez dos controlos.

## Cache de Página Completa

A cache de página completa armazena o HTML já pronto de uma página e serve-o diretamente ao visitante seguinte. Para um visitante anónimo, isso significa nenhuma execução de PHP e nenhuma consulta à base de dados: o pedido é respondido antes de o WordPress sequer ser carregado.

O cartão mostra um indicador **On** ou **Off** e, quando está ativo, a data em que foi ativado, se o encaminhamento foi confirmado e a duração da cache.

Para a ativar, clique em **Ativar cache de página completa**. Para a desativar novamente, clique em **Disable**.

A cache é limpa automaticamente quando publica ou atualiza um artigo, pelo que as suas alterações aparecem de imediato em vez de esperar que a duração expire.

> **Tip:** Se o seu site é lido maioritariamente por visitantes anónimos, este é o interruptor de maior valor na página. É comum a diferença ser de uma ordem de grandeza no tempo até ao primeiro byte, porque a parte lenta de um pedido WordPress é precisamente a parte que deixa de acontecer.

## Limpar e Aquecer

Duas ações aparecem assim que a cache de página completa está ativa.

**Limpar a cache** esvazia a cache de imediato. Utilize-a após uma alteração que o WordPress não trata como uma atualização de artigo: editar um ficheiro de tema, alterar um widget, atualizar um menu ou modificar uma definição de plugin que afete o resultado apresentado. O visitante seguinte a cada página recebe uma cópia nova.

**Cache quente** pré-carrega as suas páginas para que já estejam em cache antes de um visitante as pedir. Depois de aquecer, um aviso indica quantas páginas do total foram pré-carregadas e lista os primeiros URLs.

A sequência natural após uma alteração de design é: limpar e depois aquecer. Dessa forma, ninguém tem de ser o visitante azarado que paga pelo primeiro carregamento sem cache.

Para a cache de borda à frente do seu site, que é uma camada separada, consulte [Limpar a Cache do CDN](https://support.kapsulehost.com/pt-pt/cdn-cache-purge).

## O Que Nunca é Colocado em Cache

Alguns URLs têm sempre de executar PHP, porque o seu resultado difere por visitante ou tem efeitos secundários. Estes caminhos são ignorados automaticamente e não precisa de configurar nada:

| Caminho | Motivo |
|---|---|
| `/wp-admin/` | A administração do WordPress é sempre dinâmica |
| `/wp-login.php` | A página de início de sessão nunca é colocada em cache |
| `/cart/` | O carrinho do WooCommerce é específico de cada visitante |
| `/checkout/` | O checkout do WooCommerce é específico de cada visitante |
| `/my-account/` | As páginas de conta do WooCommerce são específicas de cada visitante |
| `/wp-cron.php` | As tarefas agendadas têm de ser executadas de facto |
| `/?wc-ajax=*` | Pontos finais AJAX do WooCommerce |

Para além das regras de caminho, os cookies também importam. Um utilizador do WordPress com sessão iniciada, ou um visitante com um cookie de sessão ativo do WooCommerce, recebe sempre uma resposta dinâmica, mesmo numa página que está em cache para todos os outros. É por isso que o proprietário de uma loja que navega no seu próprio site frequentemente não vê nenhum dos benefícios, enquanto os visitantes anónimos veem.

> **Warning:** Como normalmente está autenticado, testar o comportamento da cache no seu navegador habitual irá induzi-lo em erro. Faça o teste numa janela privada, ou num navegador onde não tenha sessão iniciada.

## Cache de Objetos

A cache de objetos é uma camada diferente. Em vez de armazenar páginas já prontas, mantém em memória os resultados de consultas à base de dados e os transients do WordPress, de modo a que o trabalho repetido não seja repetido.

O cartão mostra um indicador **On** ou **Off** e, quando está ativo, a data em que foi ativado. Utilize **Ativar** e **Desativar** para a alterar.

A cache de objetos ajuda exatamente onde a cache de página completa não consegue: utilizadores com sessão iniciada, ecrãs de administração e páginas específicas de cada visitante, como o carrinho e o checkout. Isso torna-a especialmente valiosa para lojas movimentadas e sites de subscrição, onde grande parte do tráfego está autenticado e, por isso, nunca é colocado em cache de página.

Executar ambas em conjunto é a configuração normal. A cache de página completa trata do tráfego anónimo, e a cache de objetos acelera tudo o que tem de executar PHP de qualquer forma.

## Escolher o Que Ativar

- **Site de conteúdo, maioritariamente leitores anónimos.** A cache de página completa é a prioridade. A cache de objetos acrescenta uma melhoria menor por cima.
- **Loja WooCommerce.** Ative ambas. A cache de página completa continua a cobrir as suas páginas de produtos e categorias para visitantes a navegar, enquanto a cache de objetos trata do carrinho, checkout e páginas de conta que nunca podem ser colocadas em cache.
- **Site de subscrição ou comunidade onde quase todos têm sessão iniciada.** A cache de objetos faz o trabalho pesado, porque a maioria dos pedidos irá ignorar a cache de página por definição.

## Resolução de Problemas

**Atualizei o site mas os visitantes continuam a ver a versão antiga.** Limpe a cache e depois aqueça-a. Se continuar desatualizada, lembre-se de que também pode haver uma cache de borda: consulte [Limpar a Cache do CDN](https://support.kapsulehost.com/pt-pt/cdn-cache-purge).

**A cache não me faz nada.** Quase de certeza que tem sessão iniciada. Verifique numa janela privada.

**O carrinho ou um formulário comporta-se de forma estranha para visitantes anónimos.** Os caminhos de comércio padrão são ignorados automaticamente, mas uma página dinâmica personalizada ou fornecida por um plugin num URL não padrão não é. Se uma página nunca deve ser colocada em cache e não está na lista de exclusões, vale a pena comunicar isso ao suporte para podermos analisar a regra.

**O cartão diz que a cache está incluída no Managed WordPress.** O seu plano atual não a inclui. O aviso tem uma ligação para a página de planos.

**Verificação de encaminhamento pendente.** A cache está ativada e a confirmação de encaminhamento ainda não foi concluída. Aguarde um momento e atualize a página.

**Uma página mostra conteúdo personalizado incorreto.** Tudo o que for personalizado deve ser excluído da cache de página ou apresentado do lado do cliente. Se um plugin personaliza o resultado num URL que de outra forma seria colocado em cache sem definir um cookie de sessão, a cache de página não tem forma de o saber. Faça o teste numa janela privada e comunique ao suporte se encontrar um caso destes.

## Páginas Relacionadas

- [Desempenho do Site e APM](https://support.kapsulehost.com/pt-pt/site-performance) para medir se a cache realmente ajudou.
- [Análise de Tráfego do Site](https://support.kapsulehost.com/pt-pt/site-analytics) para a taxa de acertos da cache de borda.
- [Ativar o CDN](https://support.kapsulehost.com/pt-pt/cdn-enabling) para adicionar uma cache de borda à frente de tudo isto.
- [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup) antes de fazer alterações maiores a um site em produção.
