Geral

O Que e o Arquivo PHP.ini e Onde se Encontra? Entendendo a Configuracao do PHP

Geral·22 de março de 2026·27 min de leitura

O arquivo PHP.ini e um arquivo de configuracao que contem as configuracoes do PHP do seu servidor web. Toda vez que o PHP e iniciado, seu sistema o procurara e executara para habilitar as regras de script do seu site.

Embora venha pre-configurado, voce pode precisar alterar as configuracoes padrao do PHP para adapta-las as suas necessidades. Por exemplo, voce pode modificar o nome e a duracao da cookie de sessao para habilitar a funcao de "lembrar-me" no seu site.

Neste artigo, explicaremos a localizacao do arquivo PHP.ini e seus parametros importantes. Voce tambem aprendera como editar o arquivo para alterar as configuracoes do PHP.

O Que e PHP.ini?

PHP.ini e um arquivo de configuracao que contem as configuracoes PHP do seu servidor web.

Ele permite que voce controle as regras relacionadas ao PHP do seu site, como definir o limite de tamanho ao carregar arquivos e ocultar mensagens de erro.

A localizacao deste arquivo de configuracao do PHP varia de acordo com o servidor web. Para alterar suas configuracoes, edite o arquivo e mude o valor dos parametros atraves de um editor de texto.

Onde se Encontra o Arquivo PHP.ini?

A localizacao do arquivo PHP.ini varia de acordo com seu servidor, versao do PHP e sistema operacional. Ao executar o PHP, o sistema busca o arquivo nos seguintes locais:

1. A localizacao especifica do modulo de interface de programacao de aplicacoes do servidor (SAPI).

2. A variavel de ambiente de configuracao em tempo de execucao do PHP (PHPRC).

3. O diretorio de trabalho atual, que pode ser buscado atraves da funcao getcwd().

4. O diretorio do servidor PHP ou web instalado.

Em vez de buscar manualmente seus arquivos INI atraves dos gerenciadores de arquivos do seu hosting, os usuarios podem faze-lo automaticamente.

Entre varios metodos, criar um novo arquivo PHP dentro do diretorio raiz do seu dominio e o mais facil. Para este tutorial, mostraremos como faze-lo atraves do hPanel:

1. Va para hPanel, Hosting, Gerenciar.

2. Clique em Gerenciador de Arquivos.

3. Navegue ate o diretorio raiz do seu site. No nosso caso, e /home/usuario/public_html.

4. Selecione o icone + Arquivo. Insira um nome de arquivo com extensao PHP, como phpinfo.php. Depois, clique em Criar novo arquivo.

5. Clique com o botao direito no novo arquivo, Editar e insira o seguinte codigo:

```php

<?php

phpinfo();

?>

```

6. Clique em Salvar alteracoes.

7. Insira seu dominio.tld/phpinfo.php no seu navegador web e pressione Enter.

8. Procure o arquivo de configuracao carregado. O caminho do PHP.ini devera se parecer com:

Caminho do arquivo PHP.ini na saida de informacoes do PHP

Este metodo tambem funciona no cPanel para localizar o arquivo PHP.ini de um servidor virtual privado (VPS). Alternativamente, conecte via SSH e execute o seguinte comando:

```bash

php -i | grep 'Configuration File'

```

Seu cliente SSH mostrara o diretorio, que e usr/local/lib para a maioria dos servidores web. Alem de consultar a localizacao, voce pode mover e editar o arquivo PHP.ini com o cliente SSH.

Parametros Importantes do Arquivo PHP.ini

Nesta secao, explicaremos os parametros mais importantes no arquivo PHP.ini, incluindo seus valores e propositos. Esses parametros tambem sao conhecidos como diretivas.

display_errors

Determina se as mensagens de erro do PHP sao exibidas aos usuarios durante a execucao do script, utilizando os valores on e off. Por razoes de seguranca, so deve utilizar esta diretiva durante o desenvolvimento do seu site.

error_reporting

Define qual mensagem de erro e exibida aos usuarios quando display_errors esta habilitado. O parametro error_reporting aceita varias constantes para exibir diferentes erros.

Voce pode usar varias constantes e excluir erros especificos. Por exemplo, para exibir todos os erros exceto o aviso de obsolescencia, use o seguinte:

```php

E_ALL & ~E_DEPRECATED

```

error_log

Especifica o arquivo onde o PHP registrara erros para solucionar problemas. Antes de habilita-lo, certifique-se de que os usuarios do servidor web tenham permissao para escrever no arquivo.

file_uploads

Define se os uploads de arquivos HTTP estao habilitados ou nao. O valor on permitira que os usuarios carreguem arquivos no seu site, enquanto off o desabilita.

upload_max_filesize

Este parametro determina o tamanho maximo de arquivo carregado que o PHP permite no seu site. Dado que o valor padrao e de 2 MB, voce pode aumentar o limite maximo de tamanho de upload para permitir que os usuarios carreguem arquivos grandes.

Leia mais sobre este tema no nosso tutorial sobre como resolver o problema de upload_max_filesize em caso de erro.

post_max_size

O tamanho maximo de dados POST que o PHP pode coletar dos formularios HTML no seu site. O valor deve ser maior que o tamanho maximo de arquivo, pois e tratado com a funcao POST.

allow_url_fopen

Permite escrever um script PHP para acessar arquivos remotos de outro servidor. Esta desativado por padrao, pois habilita-lo pode expor seu servidor a um ataque de injecao de codigo.

allow_url_include

Esta diretiva tem uma funcao semelhante a allow_url_open, mas utiliza a funcao include. Para habilita-la, allow_url_open deve estar configurado em on.

session.name

Esta diretiva define o nome da sessao atual utilizado em cookies e URLs. Voce pode alterar o valor padrao PHPSESSID para qualquer nome descritivo com caracteres alfanumericos.

session.auto_start

Define se uma sessao PHP se inicia automaticamente ou sob demanda quando os usuarios acessam seu site. Se definir o valor em 0, a sessao sera iniciada manualmente pelo script session_start.

session.cookie_lifetime

Especifica a duracao do cookie de sessao nos navegadores dos visitantes do seu site. Por padrao, o valor e definido como 0 segundos, o que significa que seu site apaga os dados da sessao dos visitantes apos fechar seus navegadores.

memory_limit

Define a quantidade maxima de RAM que um script PHP pode usar. Tenha cuidado ao aumentar o limite de memoria, pois configuracoes incorretas podem causar sites lentos ou falhas no servidor.

max_execution_time

Determina o tempo maximo de execucao de um script. Voce pode alterar o tempo maximo de execucao padrao

de 30 segundos para qualquer valor, mas defini-lo muito alto pode causar problemas de desempenho.

Leia mais no nosso guia sobre como resolver o erro fatal: max_execution_time exceeded se obtiver este codigo de erro.

max_input_time

Define quanto tempo um script pode analisar dados coletados de formularios HTML no seu site por meio de um metodo POST ou GET. Quanto mais dados seu site coletar, maior devera ser o valor de max_input_time.

upload_temp_dir

Especifica o diretorio temporario para armazenar arquivos carregados. Todos os usuarios devem poder escrever no diretorio especificado, ou o PHP utilizara o padrao do sistema.

realpath_cache_ttl

Define a duracao para que seu sistema armazene em cache as informacoes de realpath. Recomendamos aumentar o valor para sistemas com arquivos que mudam raramente.

arg_separator.output

Utilize esta diretiva de tratamento de dados para separar argumentos nas URLs geradas pelo PHP. Seu valor padrao e um ampersand (&).

arg_separator.output

Defina o separador que o PHP utiliza para analisar as URLs de entrada em variaveis. Por padrao, e um ampersand, mas voce pode altera-lo para outros simbolos como ponto e virgula.

Como Editar o Arquivo PHP.ini

Antes de editar o arquivo PHP.ini, verifique a configuracao PHP do seu servidor utilizando phpinfo.php. Se estiver configurado como um modulo do Apache, altere a configuracao do PHP atraves do seu arquivo .htaccess.

Importante! Faca uma copia de seguranca do seu arquivo PHP.ini antes de edita-lo. Isso permite restaurar rapidamente o arquivo, ja que configuracoes incorretas podem causar problemas de desempenho ou tempo de inatividade.

Para PHP CGI, edite diretamente o arquivo INI utilizando o Editor INI MultiPHP do cPanel para configurar os ajustes.

Se estiver utilizando hPanel, simplesmente baixe e edite o arquivo com um editor de texto.

Para os usuarios do cPanel, aqui estao os passos:

1. Acesse seu cPanel.

2. Va para a secao de Software, Editor INI MultiPHP.

3. Clique na aba Modo basico. Para uma personalizacao mais profunda, selecione o Modo de editor.

4. No menu suspenso, selecione o diretorio inicial ou o caminho do dominio. Isso configurara seu arquivo PHP.ini especifico do dominio.

5. Altere a configuracao para cada diretiva PHP e clique em Aplicar para salvar as alteracoes.

6. Se seu servidor nao suportar a ferramenta do editor, use o seletor de PHP.

Alternativamente, baixe o arquivo PHP.ini e altere as diretivas de configuracao com um editor de texto.

Menu de configuracao do Seletor de PHP no cPanel

Para os usuarios de VPS, configure os ajustes de PHP atraves de um cliente SSH. Certifique-se de ter instalado o editor de texto Nano e execute este comando:

```bash

nano usr/local/lib/php.ini

```

Altere o diretorio com o caminho do seu arquivo PHP.ini no seu VPS.

Conclusao

PHP.ini e um arquivo de configuracao que armazena os ajustes PHP do seu servidor web. Voce pode edita-lo para alterar as regras relacionadas ao PHP do seu site, como restringir acoes ou limitar o tamanho dos dados carregados.

Dado que sua localizacao varia, crie um arquivo de informacoes PHP no diretorio raiz do seu dominio e carregue-o no navegador para encontrar rapidamente o PHP.ini. Nas informacoes do PHP, a localizacao esta na secao do arquivo de configuracao carregado.

O arquivo PHP.ini contem varios parametros para configurar o tratamento de erros, uploads de arquivos, configuracoes de sessao e outras regras. Para alterar a configuracao, edite os valores dos parametros respectivos.

Os usuarios de hPanel da HolyHosting podem simplesmente baixar o arquivo e alterar os parametros em um editor de texto. Se tiver mais perguntas, deixe um comentario abaixo.

Ainda tem dúvidas?

Fale com a gente e responderemos o mais rápido possível!

Contatar o suporte