Title: WP Super Cache
Author: Automattic
Published: <strong>5 novembro, 2007</strong>
Last modified: 14 abril, 2026

---

Pesquisar plugins

![](https://ps.w.org/wp-super-cache/assets/banner-772x250.png?rev=3506220)

![](https://ps.w.org/wp-super-cache/assets/icon-256x256.png?rev=3506220)

# WP Super Cache

 Por [Automattic](https://profiles.wordpress.org/automattic/)

[Baixar](https://downloads.wordpress.org/plugin/wp-super-cache.3.1.0.zip)

 * [Detalhes](https://br.wordpress.org/plugins/wp-super-cache/#description)
 * [Avaliações](https://br.wordpress.org/plugins/wp-super-cache/#reviews)
 *  [Instalação](https://br.wordpress.org/plugins/wp-super-cache/#installation)
 * [Desenvolvimento](https://br.wordpress.org/plugins/wp-super-cache/#developers)

 [Suporte](https://wordpress.org/support/plugin/wp-super-cache/)

## Descrição

Este plugin gera arquivos html estáticos do seu blog dinâmico do WordPress. Depois
que um arquivo html é gerado, o seu servidor servirá esse arquivo em vez de processar
os scripts PHP do WordPress, que são comparativamente mais pesados e mais custosos.

Os arquivos estáticos em HTML serão exibidos para a grande maioria dos seus usuários:

 * Usuários que não estão conectados.
 * Usuários que não deixaram um comentário no seu blog.
 * Ou usuários que não visualizaram um post protegido por senha.

99% de seus visitantes receberão arquivos html estáticos. Um arquivo em cache pode
ser servido milhares de vezes. Outros visitantes receberão arquivos em cache personalizados,
adaptados à sua visita. Se estiverem conectados ou tiverem deixado comentários, 
esses detalhes serão exibidos e armazenados em cache para eles.

O plugin serve arquivos em cache de 3 maneiras (classificadas por velocidade):

 1. Avançado. O método mais rápido é usar o Apache mod_rewrite (ou qualquer outro módulo
    semelhante suportado pelo servidor web) para servir arquivos html estáticos “supercached”.
    Isso ignora completamente o PHP e é extremamente rápido. Se o seu servidor for 
    atingido por um dilúvio de tráfego, é mais provável que ele atenda, pois as solicitações
    são “mais leves”. Isso requer o módulo mod_rewrite do Apache (que provavelmente
    está instalado se você tiver links permanentes personalizados) e uma modificação
    do seu arquivo .htaccess que é arriscado e pode derrubar o seu site se modificado
    incorretamente.
 2. Simples. Arquivos estáticos do supercache podem ser servidos pelo PHP e esta é 
    a maneira recomendada de usar o plugin. O plugin servirá um arquivo em supercache
    se existir e é quase tão rápido quanto o método mod_rewrite. É mais fácil de configurar,
    pois o arquivo .htaccess não precisa ser alterado. Você ainda precisa de um link
    permanente personalizado. Você pode manter partes dinâmicas da sua página neste
    modo de cache.
 3. Cache pelo WP-Cache. Usado principalmente para armazenar em cache páginas de usuários
    conhecidos, URLs com parâmetros e feeds. Usuários conhecidos são usuários logados,
    visitantes que deixam comentários ou aqueles que devem receber dados personalizados
    por usuário. É o método de cache mais flexível e um pouco mais lento. Ele também
    armazenará em cache as visitas de usuários desconhecidos se o supercache estiver
    desativado. Você também pode ter partes dinâmicas em sua página neste modo. Esse
    modo está sempre ativado, mas você pode desativar o cache de usuários conhecidos,
    URLs com parâmetros ou feeds separadamente. Defina a constante “DISABLE_SUPERCACHE”
    como 1 no seu wp-config.php se você quiser usar apenas o cache do WP-Cache.

Se você não está confortável com a edição de arquivos PHP, use o modo simples. É
fácil de configurar e muito rápido.

### Configurações recomendadas

 1. Cache simples.
 2. Compactar páginas.
 3. Não fazer cache de páginas para usuários conhecidos.
 4. Reconstrução de cache.
 5. Suporte a CDN.
 6. Verificações extras na página inicial.

Coleta de lixo é o ato de limpar arquivos de cache que estão desatualizados e obsoletos.
Não há valor correto para o tempo de expiração, mas um bom ponto de partida é de
1800 segundos.

Considere a exclusão do conteúdo da caixa de texto “Agentes de usuário rejeitados”
e permita que os mecanismos de pesquisa armazenem arquivos em cache para você.

Pré-carregue o máximo de posts possível e ative o “Modo de pré-carregamento”. A 
coleta de lixo de arquivos antigos em cache será desativada. Se você não se importa
com a atualizações frequentes de widgets da barra lateral, defina o intervalo de
pré-carregamento para 2880 minutos (2 dias), assim todos os seus posts não são recarregadas
com muita frequência. Quando o pré-carregamento ocorre, os arquivos de cache do 
post que está sendo atualizado são excluídos e depois regenerados. Depois, é realizada
uma coleta de lixo com o objetivo de limpar os arquivos obsoletos ainda em cache.

Mesmo com o modo de pré-carregamento ativado, os arquivos em cache ainda serão excluídos
quando posts forem modificados ou forem feitos comentários.

### Desenvolvimento

 * O desenvolvimento ativo deste plugin é tratado [no GitHub](https://github.com/Automattic/wp-super-cache).
 * A tradução do plugin para diferentes idiomas está na [página de tradução](https://translate.wordpress.org/projects/wp-plugins/wp-super-cache).

### Documentação

If you need more information than the following, you can have a look at [the wiki](https://github.com/Automattic/wp-super-cache/wiki)
or the [Developer documentation](https://odd.blog/wp-super-cache-developers/).

#### Pré-carregamento

Você pode gerar arquivos em cache para os posts, categorias e tags do seu site através
de pré-carregamento. O pré-carregamento visitará cada página do seu site, gerando
uma página em cache à medida que avança, como qualquer outro visitante do site. 
Devido à natureza sequencial dessa função, pode levar algum tempo para pré-carregar
um site completo, se houver muitos posts.
 Para tornar o pré-carregamento mais eficaz,
pode ser útil desativar a coleta de lixo para que os arquivos de cache mais antigos
não sejam excluídos. Isso é feito ativando o “Modo de pré-carregamento” nas configurações.
No entanto, esteja ciente de que as páginas ficarão eventualmente desatualizadas,
mas que as atualizações enviando comentários ou editando posts limparão partes do
cache.

#### Coleta de lixo

Com o passar do tempo, seu diretório de cache é preenchido, o que ocupa espaço no
seu servidor. Se o espaço for limitado ou cobrado por capacidade ou se você se preocupar
de que as páginas em cache do seu site fiquem obsoletas, a coleta de lixo deverá
ser realizada. A coleta de lixo ocorre regularmente e exclui arquivos antigos no
diretório de cache. Na página de configurações avançadas, você pode especificar:

1. Tempo limite do cache. Por quanto tempo os arquivos de cache são considerados
atualizados. Após esse período, eles ficam obsoletos e podem ser excluídos. 2. Agendador.
Configure com que frequência a coleta de lixo deve ser feita. 3. E-mails de notificação.
Você pode ser informado sobre o andamento do trabalho de coleta de lixo. Não há 
configurações certas ou erradas para a coleta de lixo. Depende do seu próprio site.
Se o seu site receber atualizações ou comentários regulares, defina o tempo limite
para 1800 segundos e o temporizador para 600 segundos. Se o seu site é principalmente
estático, você pode desativar a coleta de lixo digitando 0 como tempo limite ou 
usar um valor de tempo limite muito grande.

O diretório de cache, geralmente wp-content/cache/, é apenas para arquivos temporários.
Nunca coloque arquivos importantes ou links simbólicos pra arquivos ou diretórios
importantes nesse diretório. Eles serão excluídos se o plugin tiver acesso de gravação
a eles.

#### CDN

Uma rede de entrega de conteúdo (CDN) é geralmente uma rede de computadores localizados
em todo o mundo que servirá o conteúdo do seu site mais rapidamente usando servidores
próximos a você. Arquivos estáticos, como imagens, arquivos JavaScript e CSS, podem
ser veiculados por essas redes para acelerar a velocidade de carregamento do site.
Você também pode criar uma “CDN mais simples” usando um subdomínio do seu domínio
para servir também arquivos estáticos.

[OSSDL CDN off-linker](https://wordpress.org/plugins/ossdl-cdn-off-linker/) foi 
integrado ao WP Super Cache para fornecer suporte básico à CDN. Ele funciona reescrevendo
os URLs dos arquivos (exceto arquivos .php) em wp-content e wp-includes no servidor,
para que eles apontem para um nome de host diferente. Muitos CDNs suportam [origin pull](https://www.google.com/search?hl=en&q=%22origin+pull%22).
Isso significa que a CDN baixará automaticamente o arquivo do seu servidor quando
for solicitado pela primeira vez e continuará a servi-lo por um período configurável
antes de baixá-lo novamente do seu servidor.

Configure isso na aba “CDN” da página de configurações do plugin. Essa é uma técnica
avançada e requer um entendimento básico de como seu servidor web ou CDNs funcionam.
Certifique-se de limpar o cache de arquivos depois de configurar o CDN.

#### API REST

Agora, existem endpoints da API REST para acessar as configurações deste plugin.
Para fazer uso, você precisará ser autenticado como um usuário administrador com
permissão para visualizar a página de configurações. Isso ainda não foi documentado,
mas você pode encontrar todo o código que lida com isso no diretório “rest”.

#### Cache personalizado

Agora é possível conectar-se ao processo de armazenamento em cache usando a função
add_cacheaction().

Três ganchos estão disponíveis:

 1. ‘wp_cache_get_cookies_values’ – modifica a chave usada pelo WP Cache.
 2. ‘add_cacheaction’ – é executado na fase2. Permite que um plugin adicione ganchos
    do WordPress.
 3. ‘cache_admin_page’ – é executado na página de administrador. Use-o para modificar
    essa página, talvez adicionando novas opções de configuração.

Também existe um filtro comum do WordPress. Use o filtro “do_createsupercache”
 
para personalizar as verificações feitas antes do armazenamento em cache. O filtro
aceita um parâmetro. A saída da função wp_cache_get_cookies_values() do WP-Cache.

WP Super Cache has its own plugin system, loaded before most of WordPress. Add your
own plugin either by putting it in the wp-content/plugins/wp-super-cache-plugins
directory, or by calling wpsc_add_plugin( $name ) with the full path to the plugin.

The cookies used to identify “known users” can be modified with wpsc_add_cookie(
$name ) and wpsc_delete_cookie( $name ). See [plugins/searchengine.php](https://github.com/Automattic/wp-super-cache/blob/4cda5c0f2218e40e118232b5bf22d227fb3206b7/plugins/searchengine.php)
as an example.

### Resolução de problemas

Se as coisas não funcionam quando você instalou o plugin, aqui estão algumas coisas
para verificar:

 1.  O wp-content é gravável pelo servidor web?
 2.  Existe um wp-content/wp-cache-config.php? Caso contrário, copie o arquivo wp-super-
     cache/wp-cache-config-sample.php para wp-content/wp-cache-config.php e verificar
     se WPCACHEHOME aponta pro lugar certo.
 3.  Existe um wp-content/advanced-cache.php? Caso contrário, você deve copiar wp-super-
     cache/advanced-cache.php para wp-content/. Você deve editar o arquivo e alterar
     o caminho para que ele aponte para a pasta wp-super-cache.
 4.  Se as páginas não estiverem em cache, remova wp-content/advanced-cache.php e recrie-
     o, seguindo os conselhos acima.
 5.  Certifique-se de que a seguinte linha existe em seu arquivo wp-config.php e que
     ela está ACIMA da linha “require_once(ABSPATH.’wp-settings.php’);”:
 6.      ```
         define( 'WP_CACHE', true );
         ```
     
 7.  Tente a página Configurações->WP Super Cache novamente e ative o cache.
 8.  Olhe em wp-content/cache/supercache/. Existem diretórios e arquivos lá?
 9.  Algo em seu error_log do php?
 10. Se o seu navegador continuar pedindo que você salve o arquivo após a instalação
     do super cache, desative a compactação do Super Cache. Vá para a página Configurações-
     >WP Super Cache e desative-a lá.
 11. Erros de bloqueio de arquivo como “falha ao adquirir a chave 0x152b: permissão
     negada em …” ou “Página não armazenada em cache pelo WP Super Cache. Não foi possível
     obter o bloqueio mutex”. são um sinal de que talvez você precise usar o bloqueio
     de arquivos. Edite wp-content/wp-cache-config.php e remova o comentário de “$use_flock
     = true” ou defina $sem_id com um valor diferente. Como último recurso, você também
     pode desativar o bloqueio de arquivos na tela administrativa.
 12. Se estiver usando bloqueio grosseiro de arquivos, certifique-se de que o arquivo
     cache/wp_cache_mutex.lock seja gravável pelo servidor web.
 13. A pasta de cache não pode ser colocada em um compartilhamento NFS, Samba ou NAS.
     Tem que estar em um disco local. O bloqueio e a exclusão de arquivos expirados
     não funcionarão corretamente, a menos que a pasta de cache esteja na máquina local.
 14. Garbage collection of old cache files won’t work if WordPress can’t find wp-cron.
     php. Check your access_logs for wp-cron.php entries and that your hostname resolves
     to the external IP address other servers on the network/Internet use.
 15. Se páginas antigas estiverem sendo servidas a seus visitantes por meio do supercache,
     você poderá estar perdendo os módulos do Apache (ou seus equivalentes, se você
     não usar o Apache). São necessários 3 módulos: mod_mime, mod_headers e mod_expires.
     Os dois últimos são especialmente importantes para garantir que os navegadores
     carreguem novas versões das páginas existentes no seu site.
 16. A mensagem de erro “WP Super Cache está instalado, mas está quebrado. O caminho
     para wp-cache-phase1.php em wp-content/advanced-cache.php deve ser corrigido!”
     aparece no final de cada página. Abra o arquivo wp-content/advanced-cache.php 
     no seu editor favorito. O caminho para wp-cache-phase1.php está correto? Este 
     arquivo normalmente estará em wp-content/plugins/wp-super-cache/. Se não estiver
     correto, o mecanismo de armazenamento em cache não será carregado.
 17. O armazenamento em cache não funciona. A impressão de horário no meu blog continua
     mudando quando eu recarrego. Verifique se o caminho nas regras .htaccess corresponde
     ao local do diretório supercache. Pode ser necessário codificá-lo. Tente desativar
     o modo supercache.
 18. Se os arquivos do supercache forem gerados, mas não servidos, verifique as permissões
     em todas as suas pastas wp-content/cache/supercache (e em cada uma das pastas 
     cache, supercache e wp-content) e wp-content/cache/.htaccess. Se o seu PHP for
     executado como um usuário diferente do Apache e as permissões forem estritas, 
     o Apache poderá não conseguir ler os arquivos de cache gerados pelo PHP. Para 
     corrigir, você deve adicionar a seguinte linha ao seu wp-config.php (adicione-
     a acima da definição WP_CACHE.) Em seguida, limpe seu cache.
 19.     ```
         umask( 0022 );
         ```
     
 20. Caso veja lixo no navegador após ativar a compactação no plugin, talvez a compactação
     já esteja ativada no seu servidor web. No Apache, você deve desativar o mod_deflate
     ou, no PHP, a compactação zlib pode estar ativada. Você pode desativar isso de
     três maneiras. Se você tiver acesso root, edite seu php.ini e localize a configuração
     zlib.output_compression e verifique se está “Off” ou adicione esta linha ao seu.
     htaccess:
 21.     ```
         php_flag zlib.output_compression off
         ```
     
 22. Se isso não funcionar, adicione esta linha ao seu arquivo wp-config.php:
 23.     ```
         ini_set('zlib.output_compression', 0);
         ```
     
 24. Após a desinstalação, seus links permanentes podem quebrar se você remover as 
     regras mod_rewrite do WordPress também. Regenere essas regras, visitando a página
     Configurações->Link permanente e salvando esse formulário novamente.
 25. Se o seu blog se recusar a carregar, verifique se o seu wp-config.php está correto.
     Será que não está faltando uma tag de abertura ou fechamento do PHP?
 26. Sua página inicial está ok, mas as postagens e páginas retornam 404? Acesse Configurações-
     >links permanentes e clique em “Salvar” depois de selecionar uma estrutura de 
     link permanente personalizada. Pode ser necessário atualizar manualmente o arquivo.
     htaccess.
 27. Se determinados caracteres não aparecerem corretamente no seu site, seu servidor
     pode não estar configurado corretamente. Você precisa informar aos visitantes 
     qual conjunto de caracteres é usado. Acesse Configurações->Leitura e copie o valor
     de ‘Codificação para páginas e feeds’. Edite o arquivo .htaccess com todas as 
     suas regras de reescrita do Supercache e WordPress e adicione isso na parte superior,
     substituindo CHARSET pelo valor copiado. (por exemplo, ‘UTF-8’)
 28.     ```
         AddDefaultCharset CHARSET
         ```
     
 29. A mensagem de erro “WP Super Cache está instalado, mas está quebrado. A constante
     WPCACHEHOME deve ser definida no arquivo wp-config.php e apontar para o diretório
     do plugin WP Super Cache.” aparece no final de cada página. Você pode excluir 
     o wp-content/advanced-cache.php e recarregar a página de configurações do plugin
     ou editar o wp-config.php, procurar WPCACHEHOME e garantir que ela aponte para
     a pasta wp-super-cache. Normalmente, será wp-content/plugins/wp-super-cache/ mas
     provavelmente você precisará do caminho completo para esse arquivo (por isso é
     mais fácil deixar a página de configurações corrigi-lo). Se não estiver correto,
     o mecanismo de armazenamento em cache não será carregado.
 30. Se o seu servidor estiver com problemas devido ao número de semáforos usados pelo
     plugin, é porque seus usuários estão usando o bloqueio de arquivos, o que não 
     é recomendado (mas é necessário para poucos usuários). Você pode desativar globalmente
     o bloqueio de arquivo definindo a constante WPSC_DISABLE_LOCKING ou definindo 
     a constante WPSC_REMOVE_SEMAPHORE para que a função sem_remove() seja chamada 
     após cada página ser armazenada em cache, mas isso parece causar problemas para
     outros processos que solicitam o mesmo semáforo. Melhor desativá-lo.
 31. Defina a variável $htaccess_path em wp-config.php ou wp-cache-config.php como 
     o caminho do seu .htaccess global caso o plugin esteja procurando esse arquivo
     no diretório errado. Isso pode acontecer se você tiver o WordPress instalado de
     alguma maneira incomum.

## Instalação

Instale como qualquer outro plugin, diretamente da sua página de plugins, mas certifique-
se de ter os links permanentes personalizados ativados. Vá para a página de configurações
do plugin em Configurações->WP Super Cache e ative o armazenamento em cache.

### Como desinstalar o WP Super Cache

Praticamente tudo que você precisa fazer é desativar o plugin na página de plugins.
O plugin deve limpar a maioria dos arquivos que criou e modificou, mas ainda não
remove as regras do mod_rewrite do arquivo .htaccess. Procure a seção nesse arquivo
marcada pelas tags SuperCache BEGIN e END. O plugin não as remove porque algumas
pessoas adicionam as regras do WordPress nesse bloco também.

Para desinstalar manualmente:

 1. Desative o armazenamento em cache na página de configurações do plugin e limpe 
    o cache.
 2. Desative o plugin na página de plugins.
 3. Remova a definição WP_CACHE do arquivo wp-config.php. Se parece com `define( 'WP_CACHE',
    true );`
 4. Remova as regras do mod_rewrite do Super Cache do seu arquivo .htaccess.
 5. Remova os arquivos wp-content/advanced-cache.php e wp-content/wp-cache-config.php
 6. Remova o diretório wp-content/cache/
 7. Remova o diretório wp-super-cache do seu diretório de plugins.

### Se tudo mais falhar e seu site estiver corrompido

 1. Remova a definição WP_CACHE do arquivo wp-config.php. Se parece com `define( 'WP_CACHE',
    true );`
 2. Remova as regras (veja acima) que o plugin escreveu no arquivo .htaccess em seu
    diretório raiz.
 3. Exclua a pasta wp-super-cache na pasta plugins.
 4. Opcionalmente, exclua o advanced-cache.php, wp-cache-config.php e a pasta cache
    em wp-content/.

## Perguntas frequentes

### Como saber se meu blog está sendo armazenado em cache?

Acesse Configurações->WP Super Cache e procure o formulário “Testar cache” na página
de configurações fáceis. Clique em “Testar cache” e o plugin solicitará a primeira
página do site duas vezes, comparando a impressão de horário em cada uma para garantir
que correspondam.

Se você quiser fazer isso manualmente, ative a depuração na página de configurações
do plugin e carregue o arquivo de registro em uma nova guia do navegador. Em seguida,
visualize seu blog enquanto estiver conectado e desconectado. Você deve ver a atividade
no registro. Veja a fonte de qualquer página do seu site. Quando uma página é criada,
você verá o texto “Página dinâmica gerada em XXXX segundos.” e “Página em cache 
gerada pelo WP-Super-Cache em AAAA-MM-DD HH: MM: SS” no final do código-fonte. Ao
recarregar, uma página em cache mostrará o mesmo registro de data e hora; portanto,
aguarde alguns segundos antes de verificar.
 Se o Supercaching estiver desativado
e a compactação ativada, o texto “Compactação = gzip” será adicionado. Se a compactação
estiver desativada e a página for exibida como um arquivo html estático, o texto“
super cache” será adicionado. A única outra maneira de verificar se o arquivo em
cache foi servido pelo script PHP ou pelo cache estático é observando os cabeçalhos
HTTP. As páginas em cache do PHP terão o cabeçalho “WP-Super-Cache: arquivo supercache
servido pelo PHP”. Os arquivos em cache do WPCache terão o cabeçalho “WP-Super-Cache:
arquivo de cache do WPCache servido”. Você também deve verificar seu diretório de
cache em wp-content/cache/supercache/hostname/ por arquivos de cache estáticos. 
Se as regras do plugin estiverem ausentes no seu arquivo .htaccess, o plugin tentará
servir a página em supercache, se for encontrada. O cabeçalho será “WP-Super-Cache:
arquivo supercache servido pelo PHP” se isso acontecer. O módulo de velocidade da
página do Apache pode causar problemas durante o teste. Desative-o se notar algum
problema ao executar o testador de cache.

### Como faço para desativar o Supercaching?

Se você quiser apenas usar o mecanismo WP-Cache, edite seu wp-config.php ou crie
um mu-plugin que defina a constante ‘DISABLE_SUPERCACHE’ como 1.

### Arquivos WP-Cache vs Supercache

Todos os arquivos de cache são armazenados em wp-content/cache/supercache/HOSTNAME/
onde HOSTNANE é o seu nome de domínio. Os arquivos são armazenados em diretórios
correspondentes à estrutura de link permanente do seu site. Os arquivos Supercache
são index.html ou alguma variante disso, dependendo do tipo de visitante que acessa
no blog. Outros arquivos são nomeados wp-cache-XXXXXXXXXXXXXXXXX.php. Os nomes de
arquivos meta associados começam com “meta”. Esses arquivos contêm informações sobre
o arquivo em cache, e são gerados pelo mecanismo “WPCache caching” do plugin.

### Os comentários e outras partes dinâmicas do meu blog serão atualizados imediatamente?

Os comentários serão exibidos assim que forem moderados, dependendo da política 
de comentários do proprietário do blog. Outros elementos dinâmicos em uma página
podem não ser atualizados, a menos que sejam escritos em JavaScript, Flash, Java
ou outra linguagem do navegador do cliente. O plugin realmente produz páginas estáticas
em html. Nenhum PHP é executado quando essas páginas são exibidas. O plugin “Popularity
Contest” é um exemplo de plugin que não funcionaria.

### A compactação do Super Cache causará lentidão em meu servidor?

Não, fará o contrário. Os arquivos do Super Cache são compactados e armazenados 
de modo que a compactação pesada seja feita apenas uma vez. Esses arquivos geralmente
são muito menores e são enviados ao navegador do visitante muito mais rapidamente
do que o html descompactado. Como resultado, seu servidor gasta menos tempo conversando
na rede, economizando tempo de CPU e largura de banda e também pode atender à próxima
solicitação muito mais rapidamente.

### Como faço para que certas partes da página permaneçam dinâmicas?

Nota: esta funcionalidade está desativada por padrão. Você terá que ativá-la na 
página de configurações avançadas.

Existem 2 maneiras de fazer isso. Você pode usar o JavaScript para manipular a parte
da página que deseja manter dinâmica. É isso que o Google AdSense e muitos widgets
de sites externos fazem e é a maneira recomendada. Ou você pode usar um filtro WP
Super Cache para fazer o trabalho, mas não poderá usar o cache do modo mod_rewrite.
Você precisa usar o método de entrega “simples” ou desativar o supercaching.

O WP Super Cache 1.4 introduziu um filtro de ação de cache chamado wpsc_cachedata.
A página em cache a ser exibida passa por esse filtro e permite a modificação da
página. Se a página contiver uma tag de espaço reservado, o filtro poderá ser usado
para substituir essa tag pelo seu html gerado dinamicamente.
 A função conectada
ao filtro wpsc_cachedata deve ser colocada em um arquivo na pasta de plugins do 
WP Super Cache, a menos que você use o recurso late_init. Um plugin de exemplo está
incluído. Edite [dynamic-cache-test.php](http://svn.wp-plugins.org/wp-super-cache/trunk/plugins/dynamic-cache-test.php)
para ver o código de exemplo. Existem duas funções de exemplo lá. Há uma função 
simples que substitui uma string (ou tag) que você define quando a página em cache
é servida. A outra função de exemplo usa um buffer de saída para gerar o conteúdo
dinâmico. Devido a uma limitação no funcionamento do PHP, o código do buffer de 
saída DEVE ser executado antes de chegar no filtro wpsc_cachedata, ao menos quando
uma página é armazenada em cache. Ele não interfere a exibição de páginas em cache.
Veja [este post](https://odd.blog/y/6j) para obter uma explicação mais técnica e
mais longa. Para executar as funções do WordPress, você deve ativar o recurso ‘Início
tardio’ na página de configurações avançadas.

### Como faço para atrasar a exibição do cache até que a ação “init” seja acionada?

Os arquivos em cache são servidos antes que praticamente todo o WordPress seja carregado.
Embora isso seja ótimo para o desempenho, é uma dor quando você deseja estender 
o plugin usando uma parte central do WordPress. Nesse caso basta ativar o modo ‘
Início tardio’ na página de configurações avançadas e os arquivos em cache serão
exibidos quando a função “init” for acionada. WordPress e seus plugins serão carregados
agora.

### Por que os plugins WP UserOnline, o Popularity Contest, o WP Postratings ou o plugin X não funcionam ou não atualizam no meu blog agora?

Este plugin armazena páginas inteiras em cache, mas alguns plugins acham que podem
executar o código PHP toda vez que uma página é carregada. Para corrigir isso, o
plugin precisa usar os métodos JavaScript/AJAX ou o filtro wpsc_cachedata descrito
na resposta anterior para atualizar ou exibir informações dinâmicas.

### Por que meus plugins WP Super Cache desaparecem quando eu atualizo o plugin?

O WordPress exclui a pasta do plugin quando atualiza um plugin. É assim também com
o WP Super Cache, então todos os arquivos modificados no wp-super-cache/plugins/
serão excluídos. Você pode colocar seus plugins personalizados em um diretório diferente
de várias maneiras. Você pode definir a variável $wp_cache_plugins_dir em wp-config.
php ou wp-content/wp-cache-config.php e apontá-la para um diretório fora da pasta
wp-super-cache. O plugin procurará lá por seus plugins. Ou, se você distribuir um
plugin que precisa ser carregado com antecedência, use a função `wpsc_add_plugin(
$filename)` para adicionar um novo plugin onde quer que esteja. Use `wpsc_delete_plugin(
$filename)` para remover o arquivo de plugin. Consulte [#574](https://github.com/Automattic/wp-super-cache/pull/574/)
ou [este post](https://odd.blog/2017/10/25/writing-wp-super-cache-plugins/) sobre
como escrever plugins WP Super Cache.

### O que o recurso de reconstrução de cache faz?

Quando um visitante deixa um comentário, o arquivo em cache dessa página é excluído
e o próximo visitante recria a página em cache. Quando uma página demora para carregar,
o que acontece se receber 100 visitantes durante esse período? Não haverá uma página
em cache; portanto, o WordPress exibirá uma nova página para cada usuário e o plugin
tentará criar uma página em cache para cada um desses 100 visitantes, causando uma
enorme carga no servidor. Esse recurso impede que isso aconteça. A página em cache
não é renovada quando um comentário é deixado, mas sim é marcada para reconstrução.
O próximo visitante nos 10 segundos seguintes vai regenerar a página em cache enquanto
a página antiga é veiculada para os outros 99 visitantes. Eventualmente, a página
é carregada pelo primeiro visitante e a página em cache é atualizada. Consulte [este post](https://odd.blog/2009/01/23/wp-super-cache-089/)
para obter mais informações.

### Por que o plugin não faz por padrão o cache das solicitações de robôs dos mecanismos de pesquisa?

Esses bots normalmente só visitam cada página uma vez e, se a página não é popular,
não faz sentido criar um arquivo de cache que ficará inativo em seu servidor. No
entanto, você pode permitir que essas visitas sejam armazenadas em cache, removendo
a lista de bots de “Agentes de usuário rejeitados” na página de configurações avançadas.

### Uma página de categoria está sendo exibida em vez da minha página inicial

Uma pequena proporção de sites terá problemas com a seguinte configuração:

 1. Usa uma página estática para a página inicial.
 2. Usa a estrutura de link permanente /%category%/%postname%/.

Às vezes, uma página de categoria é armazenada em cache como a página inicial do
site em vez da página estática. Não posso [replicar o problema](https://wordpress.org/support/topic/237415/page/2?replies=38),
mas uma solução simples é usar o modo “Simples”. Você também pode ativar “Verificações
extras da página inicial” na página Configurações avançadas.

### Por que recebo avisos sobre o armazenamento em cache de http://ismyblogworking.com/

“O seu blog não suporta o cache do cliente (sem resposta a 304 if-modified-since).”
“
O seu feed não suporta armazenamento em cache (sem resposta a 304 if-modified-since)”

O supercache não suporta verificações de cabeçalho 304 no modo avançado, mas suporta
no modo simples. Esse cache é feito pelo seu navegador, não pelo servidor. É uma
verificação em que navegador pergunta ao servidor se uma versão atualizada da página
atual está disponível. Caso contrário, ele não fará o download da versão antiga 
novamente. A página ainda é armazenada em cache pelo servidor, mas não pelos navegadores
dos visitantes.
 Experimente o Cacheability Engine em http://www.ircache.net/cgi-
bin/cacheability.py ou https://redbot.org/ para obter mais análises.

### Como devo usar melhor as ferramentas de acompanhamento utm_source no Google Analytics com este plugin?

Esse rastreamento adiciona uma string de consulta a cada URL vinculado de várias
fontes, como Twitter e leitores de feed. Infelizmente, isso impede que as páginas
sejam supercacheadas. Veja o [comentário do Joost aqui](https://odd.blog/remove-unused-utmsource-urls/#comment-672813)
para saber como transformá-lo em uma tag de âncora que pode ser armazenada no cache
do supercache.

### O plugin reclama que wp-content é gravável! O htdocs é gravável!

Não é bom quando o servidor web pode gravar nesses diretórios, mas às vezes as contas
de hospedagem compartilhada são configuradas dessa maneira para facilitar a administração.
Use o `chmod 755 diretório` para corrigir as permissões ou use a seção de permissões
do seu cliente ftp. Esta [pesquisa no Google](https://www.google.com/search?sourceid=chrome&ie=UTF-8&q=ftp+fix+directory+permissions+755)
tem mais informações sobre este tópico e [esta página do codex](https://codex.wordpress.org/Changing_File_Permissions)
também. Infelizmente, alguns hosts exigem que esses diretórios sejam graváveis. 
Se for esse o caso, ignore este aviso.

### Como excluo a definição de WP_CACHE do wp-config.php?

Carregue seu cliente ftp preferido e conecte-se ao seu site. Navegue até a raiz (
ou o diretório abaixo) do seu site, onde você encontrará wp-config.php. Faça o download
desse arquivo e edite-o em um editor de texto. Exclua a linha `define ('WP_CACHE',
true);` e salve o arquivo. Agora faça o upload, substituindo o wp-config.php no 
seu servidor.

### Como excluo as regras do Super Cache do arquivo .htaccess?

Execute seu cliente ftp preferido e conecte-se ao seu site. Pode ser necessário 
ativar “Mostrar arquivos ocultos” nas preferências do cliente ftp. Navegue até a
raiz do seu site, onde encontrará o arquivo .htaccess. Faça o download desse arquivo
e edite-o em um editor de texto. Exclua as linhas entre “# BEGIN WPSuperCache” e“#
END WPSuperCache” e salve o arquivo. Agora faça o upload, substituindo o arquivo.
htaccess no seu servidor.

### Como eu altero as permissões de arquivo?

Esta [página](https://codex.wordpress.org/Changing_File_Permissions) no WordPress
Codex explica tudo o que você precisa saber sobre permissões de arquivo em seu servidor
e várias maneiras de alterá-las.

### Por que tenho picos de carga quando novos posts são feitos?

Você pode ter a opção “limpar todos os arquivos em cache ao criar novos posts”. 
A limpeza desses arquivos pode demorar, e seus visitantes agora visitarão páginas
não armazenadas em cache. Você está usando o acompanhamento de campanhas do Google
Analytics com utm_source no URL? Essas páginas não são armazenadas em cache. Consulte
a pergunta “Como devo usar melhor as ferramentas de rastreamento utm_source no Google
Analytics com este plugin” acima para saber como usá-las corretamente.
 As páginas
em cache precisam ser atualizadas ao criar posts. Talvez seu servidor não esteja
preparado para atender à quantidade de tráfego que você recebe. Ative o recurso “
reconstruir cache”, pois isso pode ajudar.

### Quantas páginas posso armazenar em cache?

O único limite real são os limites definidos pelo seu servidor. Por exemplo, EXT2
e EXT3 permitem um máximo de 31.999 subdiretórios, portanto, se você tiver uma estrutura
de permalink plana (como /%POSTNAME%/) e mais de 32.000 posts, poderá encontrar 
problemas. Da mesma forma, se você executar uma rede multisite e tiver mais de 31.999
sites (blogs), não poderá armazenar todos eles em cache. Se você realmente tivesse
tantos sites ativos, não estaria executando em um único servidor.

### Percebo que a versão www do meu site está em cache separadamente. Como eu paro isso?

O WordPress deve redirecionar para o URL canônico do seu site, mas se isso não acontecer,
adicione isso ao seu .htaccess acima das regras do Supercache e do WordPress. Mude
example.com para o seu próprio domínio.
 RewriteCond %{HTTP_HOST} www.example.com
$ [NC] RewriteRule ^(.*)$ https://example.com/$1 [L,R=301]

### Como faço para exibir páginas em cache para dispositivo móvel aos clientes que usam telas pequenas, como telefones e tablets?

Seu tema provavelmente é responsivo, o que significa que ele redimensiona a página
para se adequar ao dispositivo que está exibindo a página. Se não for responsivo,
você precisará usar um plugin para dispositivo móvel em separado para renderizar
uma página formatada para esses visitantes. Os seguintes plugins foram testados,
mas podem ter um comportamento diferente de acordo com o dispositivo móvel do cliente.
Você também precisará ativar o suporte ao navegador de dispositivo móvel na página
Configurações avançadas.

 * [Módulo de tema para dispositivo móvel do Jetpack](https://wordpress.org/plugins/jetpack/)
 * [WPTouch](https://wordpress.org/plugins/wptouch/)
 * [WordPress Mobile Edition](https://wordpress.org/plugins/wordpress-mobile-edition/)
 * [WordPress Mobile Pack](https://wordpress.org/plugins/wordpress-mobile-pack/)(
   não pode ter “Não armazenar em cache páginas para usuários conhecidos” ativado)

## Avaliações

![](https://secure.gravatar.com/avatar/633d6648b4863489f2901372e5876313549c6555bc7cca74372930db0d2a7691?
s=60&d=retro&r=g)

### 󠀁[Best solution for ultra speed!](https://wordpress.org/support/topic/best-solution-for-ultra-speed/)󠁿

 [maca8291](https://profiles.wordpress.org/maca8291/) 22 abril, 2026 1 resposta

I’ve been using WP Super Cache for a while now and it has made a huge difference
in my website performance. When properly configured, it turned out to be the best
caching solution I’ve tried for WordPress. Page load times are significantly faster,
server load is noticeably lower, and everything feels much more responsive overall.
What I also really appreciate is that it’s completely free, yet still delivers performance
that easily competes with many paid caching plugins. In my experience, it’s one 
of the most reliable and efficient caching systems available for WordPress. If set
up correctly, WP Super Cache can seriously improve both speed and stability — definitely
worth using.

![](https://secure.gravatar.com/avatar/9baca37a1265a07562741a6fe4651f1544888fde59cc70d21abdbfe9e2e7d6b1?
s=60&d=retro&r=g)

### 󠀁[ok](https://wordpress.org/support/topic/they-removed-support-for-cloudflare-and-sold-out-to-jetpack-ads/)󠁿

 [Winston](https://profiles.wordpress.org/anarchoi/) 9 março, 2026 3 respostas

ok

![](https://secure.gravatar.com/avatar/4dff700137868df94de01aac57af6b1978ea17a87b8dd044d9b125abd6f90ac3?
s=60&d=retro&r=g)

### 󠀁[Nice Speed Boost](https://wordpress.org/support/topic/nice-speed-boost-3/)󠁿

 [auroramella](https://profiles.wordpress.org/auroramella/) 6 março, 2026 1 resposta

Tried this to improve my site speed and it actually helped. Pages load faster now
and setup wasn’t too hard. Settings need a bit understanding at first, but once 
done it works nicely. pretty useful plugin.

![](https://secure.gravatar.com/avatar/465eee5a5168d359fb28d06c5ec5d589cc05790ae56020fe5aaec0dd171e0665?
s=60&d=retro&r=g)

### 󠀁[Does not work with Astra Pro’s Color Switcher](https://wordpress.org/support/topic/does-not-work-with-astra-pros-color-switcher/)󠁿

 [bawman](https://profiles.wordpress.org/bawman/) 25 fevereiro, 2026 1 resposta

Everything seems to work well until I started using Astra Pro’s “Color Switcher”
to implement “dark mode.” With “WP Super Cache” activated, my Color Switcher site
appears unable to correctly “remember” whether the user has switched to the “normal”
or “dark” mode. (E.g., load a webpage, toggle Color Switcher, navigate away to a
different page on the same site, toggle Color Switcher again, then come back to 
the initial webpage … the page will load with the unexpected color palette; clearing
browser cache and reloading/refreshing webpages in the browser do not help.) The
issue goes away and “Color Switcher” works as expected as soon as I deactivated “
WP Super Cache.”

![](https://secure.gravatar.com/avatar/a8c37596e7404ae656847f379a58b471a1d7a52f2d4fdc270f283aa48c6949c1?
s=60&d=retro&r=g)

### 󠀁[Fast, Simple, and Effective](https://wordpress.org/support/topic/fast-simple-and-effective-2/)󠁿

 [Willem Jurka](https://profiles.wordpress.org/jurka/) 12 outubro, 2025 1 resposta

First experience is very positive. WP Super Cache works immediately and makes the
site noticeably faster. The plugin is straightforward, simple to use, and does exactly
what it should without any hassle. Hopefully, it will stay this way.

![](https://secure.gravatar.com/avatar/4b029e27d256788d9bcdcac1018c841082ad8adf77e8fe9e75141fa25e501cf4?
s=60&d=retro&r=g)

### 󠀁[A good functional plugin](https://wordpress.org/support/topic/a-good-functional-plugin/)󠁿

 [weboosteg](https://profiles.wordpress.org/weboosteg/) 5 agosto, 2025

the plugin works good and the team of it answer questions and support whenever needed.
Keep it up!

 [ Leia todas as 1.342 avaliações ](https://wordpress.org/support/plugin/wp-super-cache/reviews/)

## Colaboradores e desenvolvedores

“WP Super Cache” é um programa de código aberto. As seguintes pessoas contribuíram
para este plugin.

Colaboradores

 *   [ Automattic ](https://profiles.wordpress.org/automattic/)
 *   [ Donncha O Caoimh (a11n) ](https://profiles.wordpress.org/donncha/)
 *   [ Adnan Haque (a11n) ](https://profiles.wordpress.org/adnan007/)
 *   [ Pete (a11n) ](https://profiles.wordpress.org/dilirity/)
 *   [ Mike Stott ](https://profiles.wordpress.org/mikemayhem3030/)
 *   [ Nauris ](https://profiles.wordpress.org/pyronaur/)
 *   [ Mark (a11n) ](https://profiles.wordpress.org/thingalon/)

WP Super Cache” foi traduzido para 32 localidades. Agradecemos aos [tradutores](https://translate.wordpress.org/projects/wp-plugins/wp-super-cache/contributors)
por suas contribuições.

[Traduzir o “WP Super Cache” para seu idioma.](https://translate.wordpress.org/projects/wp-plugins/wp-super-cache)

### Interessado no desenvolvimento?

[Navegue pelo código](https://plugins.trac.wordpress.org/browser/wp-super-cache/),
consulte o [repositório SVN](https://plugins.svn.wordpress.org/wp-super-cache/) 
ou assine o [registro de desenvolvimento](https://plugins.trac.wordpress.org/log/wp-super-cache/)
por [RSS](https://plugins.trac.wordpress.org/log/wp-super-cache/?limit=100&mode=stop_on_copy&format=rss).

## Registro de alterações

### 3.1.0 – 2026-04-14

 * Disable caching for wp_die() error pages
 * Harden the plugin in various ways.
 * Fix: use fileperms() instead of stat() and fix escaping
 * Add WordPress.org Live Preview Blueprint.
 * Minimum WordPress version bumped to 6.8.
 * Device Detection: use an embedded version instead of the Composer dependency.
 * Fix: str_starts_with() null deprecation on PHP 8.1+.
 * Fix: handle array type for supercache_last_cached option.

[See previous releases on GitHub.](https://github.com/Automattic/wp-super-cache/releases)

## Meta

 *  Versão **3.1.0**
 *  Última atualização **3 semanas atrás**
 *  Instalações ativas **Mais de 1 milhão**
 *  Versão do WordPress ** 6.8 ou superior **
 *  Testado até **6.9.4**
 *  Versão do PHP ** 7.4 ou superior **
 *  Idiomas
 * [Bosnian](https://bs.wordpress.org/plugins/wp-super-cache/), [Catalan](https://ca.wordpress.org/plugins/wp-super-cache/),
   [Chinese (China)](https://cn.wordpress.org/plugins/wp-super-cache/), [Croatian](https://hr.wordpress.org/plugins/wp-super-cache/),
   [Czech](https://cs.wordpress.org/plugins/wp-super-cache/), [Dutch](https://nl.wordpress.org/plugins/wp-super-cache/),
   [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/wp-super-cache/), [English (Australia)](https://en-au.wordpress.org/plugins/wp-super-cache/),
   [English (Canada)](https://en-ca.wordpress.org/plugins/wp-super-cache/), [English (New Zealand)](https://en-nz.wordpress.org/plugins/wp-super-cache/),
   [English (South Africa)](https://en-za.wordpress.org/plugins/wp-super-cache/),
   [English (UK)](https://en-gb.wordpress.org/plugins/wp-super-cache/), [English (US)](https://wordpress.org/plugins/wp-super-cache/),
   [French (Belgium)](https://fr-be.wordpress.org/plugins/wp-super-cache/), [French (France)](https://fr.wordpress.org/plugins/wp-super-cache/),
   [Galician](https://gl.wordpress.org/plugins/wp-super-cache/), [German](https://de.wordpress.org/plugins/wp-super-cache/),
   [Italian](https://it.wordpress.org/plugins/wp-super-cache/), [Japanese](https://ja.wordpress.org/plugins/wp-super-cache/),
   [Korean](https://ko.wordpress.org/plugins/wp-super-cache/), [Persian](https://fa.wordpress.org/plugins/wp-super-cache/),
   [Portuguese (Brazil)](https://br.wordpress.org/plugins/wp-super-cache/), [Romanian](https://ro.wordpress.org/plugins/wp-super-cache/),
   [Russian](https://ru.wordpress.org/plugins/wp-super-cache/), [Spanish (Argentina)](https://es-ar.wordpress.org/plugins/wp-super-cache/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/wp-super-cache/), [Spanish (Colombia)](https://es-co.wordpress.org/plugins/wp-super-cache/),
   [Spanish (Ecuador)](https://es-ec.wordpress.org/plugins/wp-super-cache/), [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/wp-super-cache/),
   [Spanish (Spain)](https://es.wordpress.org/plugins/wp-super-cache/), [Spanish (Venezuela)](https://ve.wordpress.org/plugins/wp-super-cache/),
   [Swedish](https://sv.wordpress.org/plugins/wp-super-cache/) e [Ukrainian](https://uk.wordpress.org/plugins/wp-super-cache/).
 *  [Traduzir para seu idioma](https://translate.wordpress.org/projects/wp-plugins/wp-super-cache)
 * Tags
 * [cache](https://br.wordpress.org/plugins/tags/cache/)[caching](https://br.wordpress.org/plugins/tags/caching/)
   [performance](https://br.wordpress.org/plugins/tags/performance/)[WP Cache](https://br.wordpress.org/plugins/tags/wp-cache/)
   [WP Super Cache](https://br.wordpress.org/plugins/tags/wp-super-cache/)
 *  [Visualização avançada](https://br.wordpress.org/plugins/wp-super-cache/advanced/)

## Classificações

 4.3 de 5 estrelas.

 *  [  990 avaliações com 5 estrelas     ](https://wordpress.org/support/plugin/wp-super-cache/reviews/?filter=5)
 *  [  108 avaliações com 4 estrelas     ](https://wordpress.org/support/plugin/wp-super-cache/reviews/?filter=4)
 *  [  47 avaliações com 3 estrelas     ](https://wordpress.org/support/plugin/wp-super-cache/reviews/?filter=3)
 *  [  24 avaliações com 2 estrelas     ](https://wordpress.org/support/plugin/wp-super-cache/reviews/?filter=2)
 *  [  173 avaliações com 1 estrelas     ](https://wordpress.org/support/plugin/wp-super-cache/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wp-super-cache/reviews/#new-post)

[Ver todas avaliações](https://wordpress.org/support/plugin/wp-super-cache/reviews/)

## Colaboradores

 *   [ Automattic ](https://profiles.wordpress.org/automattic/)
 *   [ Donncha O Caoimh (a11n) ](https://profiles.wordpress.org/donncha/)
 *   [ Adnan Haque (a11n) ](https://profiles.wordpress.org/adnan007/)
 *   [ Pete (a11n) ](https://profiles.wordpress.org/dilirity/)
 *   [ Mike Stott ](https://profiles.wordpress.org/mikemayhem3030/)
 *   [ Nauris ](https://profiles.wordpress.org/pyronaur/)
 *   [ Mark (a11n) ](https://profiles.wordpress.org/thingalon/)

## Suporte

Problemas resolvidos nos últimos dois meses:

     7 de 8

 [Ver fórum de suporte](https://wordpress.org/support/plugin/wp-super-cache/)