Base de Conhecimento

php.ini: o que é e como editar no servidor

  • php, php.ini, php-fpm, .user.ini, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: php.ini: o que é e como editar no servidor

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.

Esta resposta lhe foi útil?

Artigos Relacionados