Base de Conhecimento

OPcache: o que é e como ativar no PHP do site

  • opcache, php, php.ini, php-fpm, wordpress
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: OPcache: o que é e como ativar no PHP do site

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 -v e php --ini para saber a versão e os arquivos lidos.
  • PHP 8.5.0 ou mais novo: o OPcache já vem carregado; opcache.enable=1 no php.ini.
  • Versões anteriores: zend_extension com 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.

Esta resposta lhe foi útil?

Artigos Relacionados