OPcache: o que é e como ativar no PHP do site
Veja como conferir o OPcache pelo terminal e pelo navegador, ativar no php.ini antes e depois do PHP 8.5.0, ajustar memória e arquivos e evitar código antigo em cache.
Por Redação Eleven Host · @robson.direitodigital · 19 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: OPcache: o que é e como ativar no PHP do site Arte: Eleven Host
OPcache é a extensão do PHP que guarda na memória compartilhada o código dos scripts já compilado, para o PHP não precisar ler e analisar os arquivos a cada acesso. Para ativar, você confere a versão do PHP, ajusta o php.ini, reinicia o serviço e verifica.
Pela tabela de configuração do manual do PHP, o padrão de opcache.enable é 1, ligado. A partir do PHP 8.5.0, o OPcache vem embutido no próprio PHP e já carregado; antes disso, ele era carregado como extensão pela diretiva zend_extension.
O que é o OPcache
Quando um visitante abre uma página feita em PHP, como as de um site WordPress, o PHP lê os arquivos do site, analisa o código e o transforma em bytecode, uma forma intermediária que ele consegue executar. Sem cache, esse trabalho se repete a cada requisição.
Segundo a introdução do OPcache no manual do PHP, a extensão melhora o desempenho do PHP guardando esse bytecode pré-compilado na memória compartilhada. Com isso, o PHP deixa de carregar e analisar os scripts a cada requisição. O manual também registra que o OPcache vem junto com o PHP desde a versão 5.5.0.
O cache do OPcache fica no servidor e vale para o código PHP. O tempo que o servidor leva para começar a responder, por exemplo, depende de várias partes, como explicado em TTFB: o que é e como reduzir no seu site.
Outra forma de ter servidor próprio é uma VPS da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Por que o OPcache importa para o site
Num site WordPress, o núcleo, o tema e os plugins são código PHP. Com o OPcache, a compilação desses arquivos não precisa ser repetida a cada requisição: o bytecode é reaproveitado da memória.
O ganho real depende do site, do servidor e do resto da configuração, por isso recomendamos medir antes e depois em vez de esperar um número fixo. O que o OPcache guarda é o código compilado, e não o resultado de consultas ao banco de dados.
Os passos a seguir valem para quem administra o próprio servidor, como numa VPS; o básico desse tipo de servidor está em O que é servidor VPS: guia simples para iniciantes. Os comandos podem pedir permissão de administrador, com sudo na frente, e os caminhos de arquivos mudam conforme a distribuição e a versão do PHP.
Como ver se o OPcache já está ligado
1. Descubra a versão e os arquivos de configuração
Pelo manual do PHP, a opção -v mostra a versão e a opção --ini mostra os nomes dos arquivos de configuração e as pastas que o PHP lê. Um exemplo de comando:
php -v
php --ini
A versão importa porque, a partir do PHP 8.5.0, o OPcache já vem embutido e carregado. Em versões anteriores, o manual descreve o OPcache como extensão compartilhada, carregada com a diretiva zend_extension.
2. Confira pelo terminal
A opção -i chama a função phpinfo() e imprime o resultado no terminal. Um exemplo de comando para filtrar as linhas que contêm opcache.enable:
php -i | grep opcache.enable
Atenção a um detalhe: o terminal usa o PHP de linha de comando, o CLI. Pela tabela do manual, o OPcache do CLI depende de outra diretiva, a opcache.enable_cli, cujo padrão é 0. Além disso, o PHP do terminal e o PHP que atende o site, como o PHP-FPM ou o módulo do Apache, podem ler arquivos de configuração diferentes.
3. Confira pelo navegador
Para ver o PHP que atende o site, recomendamos um arquivo de teste na pasta dele. Segundo o manual, a função phpinfo() mostra a versão, as extensões e os valores das opções de configuração, e costuma ser usada para conferir configurações num sistema. Um exemplo de arquivo, com nome difícil de adivinhar:
<?php phpinfo();
Abra o endereço do arquivo no navegador e procure a seção do OPcache. O mesmo manual diz que a saída inclui dados do ambiente, da requisição e do servidor. Por isso recomendamos apagar o arquivo logo depois de consultar.
Como ativar o OPcache no php.ini
1. Faça uma cópia da configuração
Recomendamos copiar o arquivo antes de editar, para poder voltar atrás. Um exemplo de comando, dentro da pasta do php.ini indicada pelo php --ini:
cp php.ini php.ini.bak
2. PHP 8.5.0 ou mais novo
Pela página de instalação do manual, a partir do PHP 8.5.0 o OPcache vem sempre embutido no binário e carregado. Uma linha zend_extension=opcache.so nessas versões gera um aviso. Quem controla se o OPcache fica ativo são as diretivas opcache.enable e opcache.enable_cli. Um exemplo de linha no php.ini:
opcache.enable=1
3. Versões anteriores ao PHP 8.5.0
Antes da 8.5.0, segundo o manual, o OPcache só podia ser compilado como extensão compartilhada e era carregado com a diretiva zend_extension, com o caminho completo do arquivo fora do Windows. O exemplo do manual usa um caminho genérico:
zend_extension=/full/path/to/opcache.so
Troque o caminho pelo do seu servidor. Antes de acrescentar a linha, confira nos arquivos e pastas listados pelo php --ini se ela já existe.
4. Reinicie o serviço do PHP
Recomendamos reiniciar o serviço que atende o site, como o PHP-FPM ou o Apache, depois de cada mudança no php.ini. O nome do serviço muda conforme a versão e a distribuição; um exemplo de comando, trocando pelo nome do seu:
systemctl restart php8.3-fpm
Em sites WordPress, ajustes do próprio WordPress ficam em outro arquivo, assunto de wp-config.php: o que é e como editar com segurança. As diretivas do OPcache ficam na configuração do PHP.
Principais ajustes do OPcache
A página de instalação do manual lista estas configurações como geralmente recomendadas por oferecer bom desempenho:
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.revalidate_freq=60
opcache.enable_cli=1
O que cada uma faz, pela tabela de configuração do manual:
opcache.memory_consumption: tamanho da memória compartilhada do OPcache, em megabytes. O padrão é 128 e o mínimo é 8.opcache.interned_strings_buffer: memória, em megabytes, para as strings internadas, textos repetidos que o PHP guarda uma vez só. O padrão é 8.opcache.max_accelerated_files: número máximo de scripts na tabela do OPcache. O padrão é 10000, o mínimo 200 e o máximo 1000000; o PHP arredonda para cima, para um número de uma lista fixa de primos.opcache.revalidate_freq: de quantos em quantos segundos o OPcache confere se os arquivos mudaram. O padrão é 2; com 0, a conferência acontece a cada requisição.opcache.enable_cli: liga o OPcache no PHP de linha de comando. O padrão é 0.
Repare que a lista de recomendados e a tabela de padrões não batem em três pontos: opcache.max_accelerated_files tem padrão 10000 e aparece com 4000 na lista, opcache.revalidate_freq tem padrão 2 e aparece com 60, e opcache.enable_cli tem padrão 0 e aparece com 1. Recomendamos comparar esse número com a quantidade de arquivos PHP do site antes de baixar o valor abaixo do padrão.
A partir do PHP 8.5.0, segundo o manual, mudar opcache.memory_consumption depois que o OPcache já está montado, por exemplo com php_admin_value num pool do PHP-FPM, falha e registra um aviso. Recomendamos fazer esse ajuste no php.ini.
Sobre o JIT: pela tabela do manual, ele é configurado por diretivas do próprio OPcache, como opcache.jit, que vem com o padrão disable desde o PHP 8.4.0.
Cuidado com opcache.validate_timestamps=0
Pela tabela do manual, opcache.validate_timestamps vem ligada, com padrão 1. Assim, o OPcache confere se os arquivos mudaram a cada intervalo definido em opcache.revalidate_freq.
Com a diretiva em 0, o manual diz que as mudanças nos arquivos só passam a valer depois de zerar o OPcache à mão, com opcache_reset() ou opcache_invalidate(), ou de reiniciar o servidor web. Na prática, uma atualização de plugin, de tema ou de um arquivo do site pode continuar com o código antigo até esse passo.
Segundo o manual, opcache_reset() zera todo o cache de opcode em memória, e os scripts são analisados de novo na próxima vez que forem acessados. Recomendamos deixar a diretiva no padrão se o site recebe atualizações com frequência e não existe uma rotina de reinício depois de cada mudança.
Resumo dos passos
- Versão:
php -vephp --inipara saber a versão e os arquivos lidos. - PHP 8.5.0 ou mais novo: o OPcache já vem carregado;
opcache.enable=1no php.ini. - Versões anteriores:
zend_extensioncom o caminho do opcache.so, se ainda não existir. - Ajustes: um por vez, partindo da lista do manual.
- Depois: reiniciar o serviço do PHP e conferir pelo navegador.
Como conferir depois de ativar
Além da seção do OPcache no phpinfo(), o manual descreve a função opcache_get_status(), que devolve o estado do cache em memória como um array, ou false em caso de falha. O parâmetro include_scripts controla se a resposta traz a lista de scripts; com false, ela fica mais curta. Um exemplo de arquivo de teste:
<?php var_dump(opcache_get_status(false));
Como no arquivo do phpinfo(), recomendamos apagar o teste logo depois, abrir as páginas principais do site e olhar o log de erros do PHP se algo mudar. Para voltar atrás, a cópia do php.ini feita no início pode ser restaurada, com um novo reinício do serviço.
Anotações para a próxima revisão
Recomendamos guardar num arquivo de texto a data, a versão do PHP e os valores alterados, para comparar quando a configuração for revista.
Cadastrar um nome de domínio, em centenas de extensões, é possível na Eleven Host. Buscar domínio
Perguntas frequentes
O que é OPcache?
É a extensão do PHP que guarda o bytecode pré-compilado dos scripts na memória compartilhada, para o PHP não carregar e analisar os arquivos a cada requisição. Vem junto com o PHP desde a versão 5.5.0.
O OPcache vem ligado?
Pela tabela do manual, o padrão de opcache.enable é 1. A partir do PHP 8.5.0, ele vem embutido e carregado. Recomendamos conferir a sua instalação pelo phpinfo().
Mudei um arquivo e o site não mudou. Por quê?
Se opcache.validate_timestamps estiver em 0, o manual diz que as mudanças só valem depois de opcache_reset(), opcache_invalidate() ou do reinício do servidor web. Com a diretiva ligada, a conferência segue o intervalo de opcache.revalidate_freq.