php.ini reúne diretivas do PHP, mas um site cPanel pode receber valores de configuração global, MultiPHP INI Editor, PHP-FPM, .user.ini, pool, aplicação ou linha de comando. Editar o arquivo errado é a causa mais comum de uma alteração “não funcionar”. Primeiro identifique versão, SAPI, domínio e valor efetivo.
Verificar no cPanel
- Abra Software > MultiPHP Manager e confirme a versão do domínio.
- Abra MultiPHP INI Editor.
- Selecione o mesmo domínio.
- Registre os valores atuais.
- Altere somente as diretivas necessárias.
- Salve, teste e consulte o log.
O provedor pode bloquear diretivas de sistema ou impor tetos do plano. Não contorne uma restrição repetindo o valor em vários arquivos.
CLI e site podem usar arquivos diferentes
php -v
php --ini
php -r "echo php_ini_loaded_file(), PHP_EOL;"Esses comandos mostram a linha de comando. Um cron também pode chamar outra versão. Para o site, use informações do painel ou um script temporário e protegido com php_ini_loaded_file() e ini_get(). Remova-o depois; não deixe phpinfo() público.
Ordem e escopo
| Fonte | Uso comum |
|---|---|
| configuração global/pool | definida pelo administrador do servidor |
| MultiPHP INI Editor | ajustes permitidos por domínio |
.user.ini | diretivas por diretório em CGI/FastCGI, com cache |
ini_set() | somente diretivas alteráveis em runtime |
| CLI | arquivo e opções próprios do comando |
A classe de cada diretiva (INI_SYSTEM, INI_PERDIR, INI_USER ou INI_ALL) define onde ela pode ser alterada. Uma diretiva aceita no editor pode ainda ser limitada pela infraestrutura.
Diretivas frequentes
memory_limit: memória máxima por processo PHP;upload_max_filesize: tamanho de um arquivo enviado;post_max_size: corpo total da requisição, que deve comportar o upload;max_execution_timeemax_input_time: tempos com significados diferentes;max_input_vars: quantidade de variáveis de entrada;date.timezone: fuso usado quando a aplicação não define outro;display_errorselog_errors: apresentação e registro de falhas.
Valores seguros para produção
Mantenha display_errors=Off e logs em local não público. Não use memory_limit=-1 ou tempo ilimitado para esconder código ineficiente. allow_url_include deve permanecer desativado. register_globals foi removido do PHP há muitos anos e não pode nem deve ser reativado.
PHP-FPM e aplicação
Recarregar uma página nem sempre atualiza imediatamente o cache de .user.ini. PHP-FPM também pode aplicar valores administrativos que o script não substitui. Frameworks e CMS podem mostrar limites próprios. Compare o valor efetivo dentro da mesma SAPI e diretório em que ocorre o erro.
Como alterar sem causar indisponibilidade
- Registre problema e valor atual.
- Faça uma mudança pequena no escopo correto.
- Teste a operação que falhava.
- Monitore memória, CPU, tempo e log.
- Reverta se não houver benefício.
- Corrija a causa no código quando o consumo continuar crescendo.
Quando abrir chamado
Informe domínio, versão PHP, diretiva, valor atual/esperado, horário, URL ou cron afetado e mensagem completa. Não anexe um phpinfo() público nem credenciais. Algumas mudanças exigem VPS ou análise de compatibilidade porque afetam capacidade e segurança.
Referências: arquivos .user.ini e lista de diretivas PHP. Veja MultiPHP Manager, memory_limit e uso seguro do phpinfo.
Recursos relacionados
Continue com materiais e serviços relacionados ao tema deste guia.