Central de Ajuda

Guia da Central de Ajuda

php.ini no cPanel: como alterar limites e descobrir qual configuração PHP está ativa

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

  1. Abra Software > MultiPHP Manager e confirme a versão do domínio.
  2. Abra MultiPHP INI Editor.
  3. Selecione o mesmo domínio.
  4. Registre os valores atuais.
  5. Altere somente as diretivas necessárias.
  6. 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

FonteUso comum
configuração global/pooldefinida pelo administrador do servidor
MultiPHP INI Editorajustes permitidos por domínio
.user.inidiretivas por diretório em CGI/FastCGI, com cache
ini_set()somente diretivas alteráveis em runtime
CLIarquivo 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_time e max_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_errors e log_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

  1. Registre problema e valor atual.
  2. Faça uma mudança pequena no escopo correto.
  3. Teste a operação que falhava.
  4. Monitore memória, CPU, tempo e log.
  5. Reverta se não houver benefício.
  6. 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.

Este guia resolveu sua dúvida? Seu retorno ajuda a priorizar as próximas revisões.
Atendimento técnico

Não encontrou o resultado esperado?

Abra um chamado e envie a mensagem de erro completa, o domínio ou serviço afetado, o horário do teste e capturas de tela sem senhas.