php.ini: o que é e como editar no servidor
Entenda onde o PHP procura o arquivo, como saber qual está em uso, o que significam as diretivas mais comuns e como mudar um limite com cuidado.
Por Redação Eleven Host · @robson.direitodigital · 20 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: php.ini: o que é e como editar no servidor Arte: Eleven Host
O php.ini é o arquivo de configuração que o PHP lê ao iniciar. Nele ficam limites como memória, tamanho de upload e tempo de execução. Para editar, descubra qual php.ini está em uso, faça uma cópia, mude a diretiva e recarregue o PHP.
O servidor web e a linha de comando podem ler arquivos de configuração diferentes; isso é dedução nossa, não afirmação do manual. Antes de editar, confira com php --ini e com o phpinfo() no navegador qual arquivo cada um usa, e faça uma cópia dele.
O que é o php.ini
O manual do PHP descreve o php.ini como o arquivo de configuração lido quando o PHP inicia. Texto depois de um ponto e vírgula, fora de aspas, é comentário, e marcadores de seção como [php] são ignorados.
O momento da leitura muda conforme a forma como o PHP roda. Pelo manual, na versão módulo do servidor web, como o módulo do Apache, o arquivo é lido uma vez, quando o servidor inicia. Nas versões CGI e CLI (esta última, a linha de comando), ele é lido a cada execução. No site, recomendamos recarregar o PHP depois de mudar o arquivo.
Quem administra o próprio servidor, como numa VPS, pode precisar editar esse arquivo. O que é um servidor virtual e como ele funciona está em O que é servidor VPS: guia simples para iniciantes.
Contratação de servidor virtual privado (VPS) também é feita na Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Onde o PHP procura o php.ini
O manual do PHP lista uma ordem de procura. Primeiro vale o caminho indicado pela própria forma de execução, como a diretiva PHPIniDir no Apache 2 ou a opção -c na linha de comando. Sem isso, o PHP procura nestes lugares:
- na variável de ambiente PHPRC;
- no diretório de trabalho atual, menos na linha de comando;
- no diretório do executável ou do módulo do PHP;
- no diretório definido na compilação.
Em cada um desses lugares, pelo manual, o PHP tenta primeiro um arquivo com o nome da forma de execução, como php-cli.ini, e só depois o php.ini. O nome da forma de execução sai da função php_sapi_name().
Além do arquivo principal, pode existir um diretório extra de configuração, definido na compilação ou pela variável PHP_INI_SCAN_DIR. O manual explica que os arquivos terminados em .ini dessa pasta são carregados em ordem alfabética.
Como descobrir qual php.ini está em uso
Pelo manual, a opção --ini da linha de comando mostra os nomes dos arquivos de configuração e os diretórios verificados. Um exemplo de comando, para conferir no seu servidor:
php --ini
A opção php -i chama o phpinfo() e mostra o resultado no terminal, em texto puro.
Esses comandos mostram a configuração da linha de comando. É possível que o site use outro arquivo, por dedução nossa a partir da ordem de procura do manual; por isso, recomendamos não supor que seja o mesmo. Para ver o do site, crie na pasta pública do site (a raiz de documentos) um arquivo de teste, por exemplo info.php, com uma linha, e abra-o pelo endereço do site seguido de /info.php. Um exemplo, para conferir no seu site:
<?php phpinfo(INFO_GENERAL);
Pelo manual, a opção INFO_GENERAL traz, entre outras informações, a localização do php.ini. Abra o arquivo pelo navegador, anote o caminho mostrado e apague o arquivo de teste em seguida.
Onde cada diretiva pode ser mudada
A lista de diretivas do manual tem a coluna Modificável, com quatro modos:
- INI_USER: em scripts, por exemplo com ini_set(), no registro do Windows e no .user.ini;
- INI_PERDIR: no php.ini, no .htaccess, no httpd.conf ou no .user.ini;
- INI_SYSTEM: só no php.ini ou no httpd.conf;
- INI_ALL: em todos os lugares acima.
Pela página da função ini_set(), o valor novo vale durante a execução do script e volta ao original no fim. O manual avisa que nem todas as opções podem ser mudadas assim. Uma diretiva INI_PERDIR, como upload_max_filesize, não muda por ini_set(); fica no php.ini, no .user.ini ou, com o PHP como módulo do Apache, no .htaccess.
Diretivas mais comuns do php.ini
Os valores abaixo são os padrões do manual do PHP. O php.ini da sua instalação pode trazer outros; confira o valor em uso antes de mudar.
- memory_limit: padrão 128M, modo INI_ALL. Quantidade máxima de memória que um script pode alocar; o valor -1 tira o limite.
- upload_max_filesize: padrão 2M, modo INI_PERDIR. Tamanho máximo de um arquivo enviado.
- post_max_size: padrão 8M, modo INI_PERDIR. Tamanho máximo dos dados enviados por formulário, uploads incluídos.
- max_execution_time: padrão 30 segundos, e 0 (sem limite) na linha de comando, modo INI_ALL. Tempo máximo que um script roda antes de ser encerrado.
- date.timezone: padrão UTC, modo INI_ALL. Fuso horário padrão das funções de data e hora.
O post_max_size precisa ser maior que o upload_max_filesize, e, de maneira geral, o memory_limit deve ser maior que o post_max_size. Se os dados enviados passarem do post_max_size, as variáveis $_POST e $_FILES chegam vazias ao script.
Os limites de tempo do servidor web, pelo manual, são à parte do max_execution_time e também podem interromper o PHP.
O mesmo arquivo recebe as diretivas das extensões. Um caso é o cache de código do PHP, explicado em OPcache: o que é e como ativar no PHP do site.
Como editar o php.ini no servidor
Com o caminho anotado, são quatro passos. Confira no seu servidor o caminho do arquivo e o nome do serviço.
1. Faça uma cópia do arquivo
Recomendamos guardar o arquivo original antes de mudar. Um exemplo de comando, com o caminho que você anotou no lugar do caminho fictício:
sudo cp /caminho/do/php.ini /caminho/do/php.ini.bak
2. Mude a diretiva
Abra o arquivo num editor de texto, com permissão de administrador, procure a diretiva e troque o valor; linha que começa com ponto e vírgula está comentada. Se a diretiva não estiver no arquivo, acrescente a linha. Um exemplo de valores, que respeita a ordem pedida pelo manual entre os três limites:
memory_limit = 256M
post_max_size = 64M
upload_max_filesize = 32M
3. Recarregue o PHP
Com PHP-FPM, recarregue o serviço do PHP-FPM. Com o PHP como módulo do Apache, reinicie o Apache, que pelo manual lê o arquivo ao iniciar. Um exemplo de comando para listar os serviços; depois use só a linha que corresponde ao seu caso, a segunda para PHP-FPM e a terceira para o módulo do Apache. O nome do serviço muda conforme a versão do PHP e a distribuição:
systemctl list-units --type=service | grep -i php
sudo systemctl reload php8.3-fpm
sudo systemctl restart apache2
A troca de versão do PHP e o socket de cada versão estão em Atualizar versão do PHP: como trocar sem quebrar o site.
4. Confira o valor novo
Crie de novo o arquivo de teste, agora com a linha abaixo, que pelo manual mostra os valores local e mestre das diretivas. Abra pelo navegador, procure a diretiva e apague o arquivo em seguida. Um exemplo, para conferir no seu site:
<?php phpinfo(INFO_CONFIGURATION);
.user.ini, .htaccess e PHP-FPM: mudar só um site
Pelo manual, o PHP aceita arquivos de configuração por diretório, processados só quando ele roda como CGI ou FastCGI. O PHP-FPM costuma se enquadrar nisso, mas essa página do manual não o cita. O PHP procura esses arquivos da pasta do script pedido até a raiz de documentos do site. Só valem ali diretivas dos modos INI_PERDIR e INI_USER, além das INI_ALL.
O nome do arquivo vem da diretiva user_ini.filename, com padrão .user.ini; deixar o valor vazio desliga a procura. A diretiva user_ini.cache_ttl define de quanto em quanto tempo os arquivos são relidos, com padrão de 300 segundos. Ou seja, a mudança pode levar até 5 minutos para valer. Um exemplo de .user.ini, a salvar na pasta do site (a raiz de documentos), para conferir no seu site:
upload_max_filesize = 32M
post_max_size = 64M
Com o PHP como módulo do Apache, o manual indica o .htaccess no lugar do .user.ini, com php_value para valores e php_flag para ligar ou desligar. Isso exige AllowOverride Options ou All. Um exemplo, só para Apache com o módulo do PHP:
php_value upload_max_filesize 32M
php_value post_max_size 64M
php_flag display_errors off
As versões php_admin_value e php_admin_flag não podem ser usadas no .htaccess. Como o Apache lê esse arquivo está em Arquivo htaccess: o que é e como editar no site.
No PHP-FPM, o arquivo de cada pool usa a mesma sintaxe do php.ini. Ali, php_value e php_flag ainda podem ser mudados por ini_set(); php_admin_value e php_admin_flag, não. Um exemplo da página do FPM (o valor é o da página; use o do seu site):
php_admin_value[memory_limit] = 32M
display_errors e log_errors no site no ar
A diretiva display_errors define se os erros aparecem na página, com padrão 1 no manual. A própria documentação a descreve como recurso de desenvolvimento, que não deve ser usado em sistemas de produção, como os conectados à internet.
O manual aconselha registrar os erros em vez de exibi-los em sites de produção. Isso é feito com log_errors, padrão 0, que grava as mensagens no log do servidor ou no arquivo de error_log. Um exemplo, para conferir no seu servidor:
display_errors = Off
log_errors = On
Pelo manual, o phpinfo() mostra caminhos, variáveis de ambiente e cabeçalhos HTTP. Recomendamos apagar o arquivo de teste assim que anotar o que precisa.
Checklist para editar o php.ini
- php --ini para a linha de comando e phpinfo() para o site;
- conferir o modo da diretiva na lista do manual;
- cópia do arquivo antes de mudar;
- post_max_size maior que upload_max_filesize;
- PHP-FPM recarregado ou Apache reiniciado;
- valor novo conferido na forma de execução do site;
- arquivo de teste do phpinfo() apagado;
- display_errors desligado e log_errors ligado no site no ar.
Uma anotação dos valores antes e depois
Recomendamos anotar cada diretiva mudada, o valor antigo, o novo e a data.
Para quem também usa banco de dados, a Eleven Host tem o 11SQL, banco de dados na nuvem. 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Ver 11SQL
Perguntas frequentes
Onde fica o php.ini?
Depende da instalação. Use php --ini na linha de comando e phpinfo() no site.
Mudei o php.ini e nada mudou. Por quê?
Pode ser que o PHP ainda não tenha sido recarregado, ou que o arquivo editado não seja o do site (e sim o da linha de comando). No .user.ini, a mudança pode levar até 5 minutos.
Posso mudar upload_max_filesize com ini_set()?
Não. Ela é INI_PERDIR e fica no php.ini, no .user.ini ou, com Apache e o módulo do PHP, no .htaccess.
Qual a diferença entre upload_max_filesize e post_max_size?
A primeira limita cada arquivo enviado; a segunda, o envio inteiro do formulário. Pelo manual, post_max_size precisa ser maior.