O Que é o Arquivo PHP.ini e Onde ele Fica? Entenda os Principais Parâmetros e Como Editá-lo

O PHP.ini é um arquivo de configuração que contém as definições de PHP do seu servidor web. Sempre que o PHP for iniciado, seu sistema procurará por ele e executará o arquivo para habilitar as regras de script do seu site.  

Embora esteja pré-configurado, você pode precisar alterar as configurações padrões do PHP para atender às suas necessidades. Por exemplo, você pode modificar o nome e a duração do cookie de sessão para habilitar o recurso para lembrar dos usuários que já acessaram seu site.

Neste artigo, explicaremos a localização do arquivo PHP.ini e seus importantes parâmetros. Você também aprenderá como editá-lo para alterar suas configurações de PHP.

Onde Fica Localizado o Arquivo PHP.ini?

A localização do PHP.ini varia dependendo do seu servidor, versão do PHP e sistema operacional. Ao executar o PHP, o sistema procura o arquivo nos seguintes lugares:

1. A localização específica do módulo de interface de programação de aplicação do servidor (SAPI) (link em inglês).
2. A variável de ambiente de configuração de tempo de execução do PHP (PHPRC).
3. Diretório de trabalho atual, que pode ser pesquisado usando a função getcwd().
4. Diretório do PHP instalado ou do servidor web.

Em vez de localizar seus arquivos INI manualmente através dos gerenciadores de arquivos de sua hospedagem, os usuários podem fazer isso de maneira automática.

Entre vários métodos disponíveis, o mais fácil é criar um novo arquivo PHP dentro do diretório raiz do seu domínio. Para este tutorial, vamos mostrar como fazer isso via hPanel:

1. Vá para hPanel → Hospedagem → Gerenciar .
2. Clique em Gerenciador de arquivos .

3. Navegue até o diretório raiz do seu site. No nosso caso, é /home/nome_de_usuário/public_html.
4. Selecione o ícone + Novo Arquivo. Insira qualquer nome de arquivo com uma extensão PHP, como phpinfo.php. Então, clique em Criar Novo Arquivo.
5. Clique com o botão direito no novo arquivo → Editar e insira o seguinte código:

<?php
   phpinfo();
?>

6. Clique em Salvar alterações.
7. Digite seudominio.tld/phpinfo.php no seu navegador e pressione enter. 
8. Busque pelo Arquivo de configuração carregado. O caminho do PHP.ini deve se parecer com o seguinte exemplo:

Este método também funciona no cPanel para localizar o arquivo PHP.ini de um servidor privado virtual (VPS). Outra opção é você se conectar usando SSH e executar o seguinte comando:

php -i | grep 'Arquivo de Configuração'

O seu cliente SSH mostrará o diretório, que é usr/local/lib na maioria dos servidores web. Além de consultar a localização, você pode mover e editar o arquivo  PHP.ini  com o cliente SSH.

Observe que o arquivo PHP.ini geralmente é inacessível para usuários de hospedagem compartilhada. Neste caso, utilize o menu de configuração do painel de controle de hospedagem edite o arquivo .htaccess para modificar as configurações PHP

Parâmetros Importantes do Arquivo PHP.ini

Nesta seção, explicaremos os parâmetros mais importantes contidos no arquivo PHP.ini, incluindo seus valores e propósitos. Esses parâmetros também são conhecidos como diretrizes.

display_errors

Determina se as mensagens de erro do PHP são exibidas para os usuários durante a execução do script ou não, usando os valores on (ligadas) e off (desligadas). Por razões de segurança, você deve usar essa diretriz apenas quando estiver desenvolvendo seu site.  

error_reporting

Define qual mensagem de erro é exibida para os usuários quando a diretriz display_errors está ativada. O parâmetro error_reporting  aceita várias constantes para exibir diferentes erros.

Você pode usar múltiplos valores fixos e excluir erros específicos. Por exemplo, para mostrar todos os erros exceto o aviso de descontinuidade, use a seguinte constante:

E_ALL & ~E_DEPRECATED

error_log

Especifica o arquivo onde o PHP registrará erros para a solução de problemas do erro. Antes de habilitá-lo, certifique-se de que os usuários do servidor web têm permissão para escrever sobre o arquivo. 

file_uploads

Define se os uploads de arquivos HTTP estão habilitados ou não. O valor on (habilitado) permitirá que os usuários façam upload de arquivos para o seu site, enquanto off (desabilitado) desativa essa função. 

upload_max_filesizeEste parâmetro determina o tamanho máximo que o PHP permitirá para upload de arquivos em seu site. Como o valor padrão é 2 MB, você pode aumentar o tamanho máximo de upload de arquivo para permitir que os usuários subam de arquivos grandes.

post_max_size

O tamanho máximo de dados POST que o PHP pode coletar dos formulários HTML em seu site. O valor deve ser maior que o tamanho máximo do arquivo, pois é manipulado com a função POST (link em inglês).

allow_url_fopen

Escreve um script PHP para acessar arquivos remotos de outro servidor. Está desativado por padrão, pois ativá-lo pode expor seu servidor a um ataque de injeção de código. 

allow_url_include

Esta diretiva tem uma função semelhante à de allow_url_open, mas usa a função include (link em inglês). Para habilitá-lo, você precisa antes habilitar a diretriz allow_url_open. 

session.name

Esta diretiva define o nome da sessão atual, que é usado em cookies e URLs. Você pode alterar o valor padrão de PHPSESSID para qualquer nome descritivo com caracteres alfanuméricos. 

session.auto_start

Escolhe se uma sessão PHP inicia automaticamente ou sob demanda quando os usuários acessam seu site. Se você definir o valor para 0, a sessão iniciará manualmente usando o script session_start. 

session.cookie_lifetime

Especifica a duração do cookie de sessão nos navegadores dos visitantes do seu site. Por padrão, o valor está definido para 0 segundos, o que significa que seu site apaga os dados da sessão dos visitantes depois que eles fecham seus navegadores.  

memory_limit

Define a quantidade máxima de memória RAM que um script PHP pode usar. Tenha cuidado ao aumentar o limite de memória, pois configurações erradas podem levar a sites lentos ou a quedas do servidor. 

max_execution_time

Determina o tempo máximo de execução de um script. Você pode alterar o tempo máximo padrão de execução de 30 segundos para qualquer valor, mas configurar uma opção muito alta pode causar problemas de desempenho.

max_input_time

Define por quanto tempo um script pode analisar dados coletados de formulários HTML em seu site usando um método POST ou GET (link em inglês). Quanto mais dados seu site coleta, maior deve ser o valor de max_input_time .

upload_temp_dir

Especifica o diretório temporário para armazenamento dos arquivos subidos para o servidor. Todos os usuários devem poder escrever sobre e criar arquivos no diretório especificado. Caso contrário, o PHP usará o diretório padrão do sistema. 

realpath_cache_ttl

Define o tempo pelo qual seu sistema vai armazenar em cache as informações do realpath (link em inglês). Recomendamos aumentar o valor para sistemas com arquivos que raramente mudam. 

arg_separator.output

Use esta diretiva de manipulação de dados para separar argumentos em URLs gerados pelo PHP. Seu valor padrão é um ampersand (&).

arg_separator.output

Define o separador que o PHP usa para analisar URLs de entrada em variáveis. Por padrão, é um ampersand (&), mas você pode mudá-lo para outros símbolos como ponto e vírgula (;).

Como Editar o Arquivo PHP.ini

Antes de editar o arquivo  PHP.ini, verifique a configuração PHP do seu servidor usando o phpinfo.php.
Se configurado como um módulo Apache, altere a configuração PHP usando seu arquivo.htaccess.

Para o PHP CGI, você pode editar diretamente o arquivo INI usando o Editor de INI MultiPHP (link em inglês) do cPanel. 

Se você está usando o hPanel, simplesmente baixe e edite o arquivo usando um editor de texto. 

Para usuários do cPanel, aqui estão as etapas para fazer isso:

1. Acesse seu cPanel.
2. Vá para a seção Software → Editor MultiPHP INI .
3. Clique na aba Modo Básico . Se preferir uma personalização aprofundada, selecione o Modo Editor .
4. No menu suspenso, selecione o diretório raiz ou o caminho do domínio. Este último configurará o arquivo PHP.ini específico do seu domínio.
5. Altere as configurações para cada diretiva PHP e clique em Aplicar para salvar as alterações. 

Se o seu servidor não suportar a ferramenta de edição, use o Seletor de PHP em vez disso. Alternativamente, baixe o arquivo PHP.ini e altere as diretivas de configuração usando um editor de texto. 

Se você usa uma VPS, pode configurar as definições de PHP via cliente SSH. Certifique-se de ter instalado o editor de texto Nano e execute este comando:

nano usr/local/lib/php.ini

Altere o diretório para o caminho do seu arquivo PHP.ini no seu VPS.

Conclusão

O PHP.ini é um arquivo de configuração que armazena as definições de PHP do seu servidor web. Você pode editá-lo para alterar as regras relacionadas ao PHP do seu site, assim como restringir ações ou limitar o tamanho dos dados enviados. 

Como sua localização pode variar, crie um arquivo de informações PHP no diretório raiz do seu domínio e faça upload dele através do seu navegador para encontrar rapidamente o arquivo PHP.ini. Você pode descobrir a sua localização dentro da seção loaded configuration file (arquivo de configuração carregado) da tela de informações do PHP. 

O PHP.ini contém vários parâmetros para definir o tratamento de erros, uploads de arquivos, configuração de sessões e outras regras. Para alterar as configurações, edite os valores dos respectivos parâmetros. 

Os usuários do hPanel da Hostinger podem simplesmente baixar o arquivo e alterar os parâmetros em um editor de texto. Caso tenha mais alguma pergunta ou dúvida, não esqueça de deixar um comentário abaixo!