Como personalizar a configuração PHP da hospedagem

Revisão técnica: 08/09/2026. Texto atualizado; a data original de publicação foi preservada.

Uma configuração PHP personalizada precisa ser aplicada no ambiente que executa o site. Criar um php.ini em qualquer pasta não garante que o servidor vai utilizá-lo. Primeiro identifique a versão PHP do domínio e o mecanismo de configuração oferecido pela hospedagem.

Escolha o local correto

No cPanel, o MultiPHP INI Editor permite selecionar o domínio e editar opções disponíveis. Antes de salvar, copie os valores atuais e leia a ajuda de cada diretiva. A hospedagem pode impor limites que não podem ser substituídos pela conta.

Em ambientes CGI/FastCGI, o PHP também pode ler arquivos .user.ini. Apenas diretivas permitidas nesse contexto são aceitas, e a releitura pode depender do intervalo de cache configurado. Esse mecanismo não é equivalente a colocar um php.ini ao lado do script em qualquer servidor.

Altere somente o que o problema exige

Use texto simples, uma diretiva por linha, e valores documentados para sua versão. Não reutilize arquivos antigos que habilitam register_globals ou configuram safe_mode e magic_quotes_gpc: essas opções pertencem a versões antigas e foram removidas do PHP.

Para upload, consulte o diagnóstico de limites que não surtiram efeito. Para memória esgotada, siga o procedimento de investigação do memory_limit. Aumentar vários parâmetros ao mesmo tempo dificulta saber qual deles estava envolvido.

Confira o valor efetivo

Valide a configuração no PHP que atende à página. O executável do terminal pode usar outro arquivo e outra versão. Prefira as informações do painel ou um diagnóstico protegido; não deixe páginas de phpinfo públicas.

Repita a operação que falhava e confira os logs. Se o valor não mudou, verifique o contexto da diretiva, a seleção do domínio e os limites do provedor. Reverta a alteração que não resolveu o problema antes de testar outra hipótese.

Referências: MultiPHP INI Editor e arquivos .user.ini no PHP.