Onde fica o php.ini? 5 erros fatais e como evitá-los

"Onde está essa maldita php.ini?" — a pergunta que enlouquece até desenvolvedores experientes

Você já se sentiu um caçador de tesouros, mas em vez de ouro, estava procurando o php.ini? Se sim, você não está sozinho. A pergunta "Where can I find php.ini?" no Stack Overflow já acumulou dezenas de milhares de visualizações. E não é por acaso.

Imagine: você instalou o PHP, escreveu um código perfeito, mas ele teimosamente se recusa a funcionar. Ou você altera as configurações no php.ini, reinicia o servidor, e as mudanças… não são aplicadas. Familiar? Bem-vindo ao clube.

Neste artigo, não vamos apenas mostrar onde o php.ini está localizado. Vamos analisar os 5 erros mais comuns que desenvolvedores cometem e dar instruções claras sobre como evitá-los. Vamos nessa!

O que é o php.ini e para que serve?

php.ini é o principal arquivo de configuração do PHP. É aqui que você controla o comportamento da linguagem: desde o tamanho máximo do arquivo para upload até o tempo de execução do script. Sem ele, o PHP funciona "do jeito que Deus quer" — com as configurações padrão.

Aqui estão alguns parâmetros que você pode alterar no php.ini:

\n
• upload_max_filesize — tamanho máximo do arquivo para upload
\n
• max_execution_time — tempo máximo de execução do script
\n
• memory_limit — limite de memória para o script
\n
• display_errors — exibir ou não erros na tela
\n
• error_reporting — nível de exibição de erros
\n

O problema é que, em diferentes sistemas operacionais e ambientes, a localização do php.ini varia. E essa é a primeira armadilha para iniciantes.

Onde procurar o php.ini: guia rápido para todos os SOs

Linux (Ubuntu, Debian, CentOS)

No Linux, o arquivo pode estar em vários lugares. Os mais comuns são:

/etc/php/8.1/cli/php.ini   # para linha de comando (CLI)\n/etc/php/8.1/apache2/php.ini # para Apache\n/etc/php/8.1/fpm/php.ini     # para PHP-FPM

Observe: a versão do PHP (8.1) pode variar. Se você tem PHP 8.0, o caminho será /etc/php/8.0/....

Como encontrar rapidamente? Execute no terminal:

php --ini

Este comando mostra o caminho para o arquivo de configuração carregado.

Windows

No Windows, o php.ini geralmente está na pasta onde o PHP foi instalado:

C:\\php\\php.ini\nC:\\Program Files\\PHP\\php.ini\nC:\\xampp\\php\\php.ini    # se você usa XAMPP\nC:\\wamp64\\bin\\php\\php8.1.0\\php.ini  # para WAMP

macOS

No macOS (se o PHP foi instalado via Homebrew):

/usr/local/etc/php/8.1/php.ini\n/opt/homebrew/etc/php/8.1/php.ini  # para Apple Silicon

Se você usa o PHP integrado da Apple (não recomendamos), o caminho pode ser diferente.

Docker

Em um contêiner Docker, o caminho é o padrão do Linux:

/usr/local/etc/php/php.ini

Mas é melhor montar seu próprio php.ini através de volumes:

docker run -v /caminho/para/seu/php.ini:/usr/local/etc/php/php.ini my-php-app

Top 5 erros ao trabalhar com php.ini (e como evitá-los)

Erro #1: Estou editando o php.ini errado

Este é o problema mais comum. Você abre o arquivo, altera as configurações, reinicia o servidor, mas o PHP continua funcionando como antes. Por quê? Porque você editou o arquivo errado!

O PHP pode usar diferentes php.ini para o CLI (linha de comando) e para o servidor web (Apache/Nginx).

Como evitar:

\n
1. Crie um arquivo PHP com o seguinte conteúdo:
\n

<?php\nphpinfo();\n?>

\n
2. Execute-o no navegador (se estiver testando a versão web) ou no terminal (php seuarquivo.php).
\n
3. Localize a linha Loaded Configuration File — este é o caminho para o arquivo de configuração ativo.
\n