{"id":16908,"date":"2026-07-21T08:48:54","date_gmt":"2026-07-21T11:48:54","guid":{"rendered":"https:\/\/www.homehost.com.br\/blog\/?p=16908"},"modified":"2026-07-21T11:36:15","modified_gmt":"2026-07-21T14:36:15","slug":"php-ini","status":"publish","type":"post","link":"https:\/\/www.homehost.com.br\/blog\/tutoriais\/php\/php-ini\/","title":{"rendered":"php.ini: o que \u00e9, onde fica e como configurar"},"content":{"rendered":"\n

O php.ini \u00e9 o arquivo de configura\u00e7\u00e3o do PHP \u2014 \u00e9 nele que se define o comportamento da linguagem no servidor: quanto de mem\u00f3ria cada script pode usar, por quanto tempo pode rodar, se os erros aparecem na tela, o tamanho m\u00e1ximo de upload e dezenas de outros ajustes.<\/strong> Cada linha do arquivo \u00e9 uma “diretiva”: um par\u00e2metro com um valor.<\/p>\n\n\n\n

Se voc\u00ea j\u00e1 se deparou com um erro de “memory size exhausted”, um upload que falha por ser grande demais, ou uma tela em branco sem mensagem de erro, a solu\u00e7\u00e3o quase sempre passa pelo php.ini. Este guia explica o que \u00e9 o arquivo, como descobrir onde ele est\u00e1, como edit\u00e1-lo (pelo cPanel ou direto no servidor), e quais s\u00e3o as principais diretivas que voc\u00ea pode ajustar.<\/p>\n\n\n\n

\n
Resposta r\u00e1pida<\/div>\n

O php.ini<\/strong> \u00e9 o arquivo que controla o comportamento do PHP no servidor. Cada linha \u00e9 uma diretiva<\/strong> no formato diretiva = valor<\/code> (por exemplo, memory_limit = 256M<\/code>). Para descobrir onde ele fica, rode php --ini<\/code> no terminal ou use a fun\u00e7\u00e3o phpinfo()<\/code>. Em hospedagem compartilhada<\/strong>, voc\u00ea normalmente n\u00e3o edita o arquivo direto: ajusta as diretivas pelo painel (no cPanel, em Select PHP Version \u2192 Options<\/em>). Em VPS ou servidor dedicado<\/strong>, edita o arquivo diretamente.<\/p>\n<\/div>\n\n\n\n

O que \u00e9 o php.ini<\/h2>\n\n\n\n

O php.ini<\/strong> \u00e9 o arquivo de configura\u00e7\u00e3o principal do PHP<\/a>. Toda vez que o PHP \u00e9 iniciado, ele l\u00ea esse arquivo para saber como deve se comportar: quais recursos liberar, quais limites impor, o que fazer com os erros. \u00c9, na pr\u00e1tica, o painel de controle da linguagem no servidor.<\/p>\n\n\n\n

O nome vem do formato do arquivo: .ini<\/code> (de initialization<\/em>), um formato de texto simples usado para configura\u00e7\u00e3o. Cada configura\u00e7\u00e3o \u00e9 uma diretiva<\/strong>, escrita como uma chave e um valor separados por um sinal de igual:<\/p>\n\n\n\n

\n memory_limit = 256M\nmax_execution_time = 30\ndisplay_errors = Off\nupload_max_filesize = 64M<\/code>\n<\/div>\n\n\n\n

Linhas que come\u00e7am com ponto e v\u00edrgula (;<\/code>) s\u00e3o coment\u00e1rios \u2014 o PHP as ignora. \u00c9 por isso que, ao abrir um php.ini, voc\u00ea v\u00ea muitas linhas come\u00e7ando com ;<\/code>: s\u00e3o diretivas desativadas ou explica\u00e7\u00f5es.<\/p>\n\n\n\n

Onde fica o arquivo php.ini<\/h2>\n\n\n\n

A localiza\u00e7\u00e3o do php.ini varia conforme o sistema operacional e a forma como o PHP foi instalado \u2014 n\u00e3o h\u00e1 um \u00fanico lugar fixo. Mas h\u00e1 duas formas r\u00e1pidas de descobrir onde ele est\u00e1.<\/p>\n\n\n\n

Pelo comando php –ini<\/h4>\n\n\n\n

Se voc\u00ea tem acesso ao terminal (SSH<\/a>), o jeito mais direto \u00e9 rodar:<\/p>\n\n\n\n

\n php --ini<\/code>\n<\/div>\n\n\n\n

O comando mostra o caminho do arquivo carregado (na linha “Loaded Configuration File”) e de eventuais arquivos adicionais. Em sistemas Linux, o php.ini costuma ficar em caminhos como \/etc\/php\/8.x\/apache2\/php.ini<\/code> ou \/etc\/php\/8.x\/cli\/php.ini<\/code> \u2014 note que pode haver arquivos diferentes<\/strong> para o PHP do servidor web (Apache) e o da linha de comando (CLI).<\/p>\n\n\n\n

Pela fun\u00e7\u00e3o phpinfo()<\/h4>\n\n\n\n

Se voc\u00ea n\u00e3o tem acesso ao terminal, mas pode subir um arquivo PHP para o site, crie um arquivo com este conte\u00fado e acesse-o pelo navegador:<\/p>\n\n\n\n

\n <?php phpinfo(); ?><\/code>\n<\/div>\n\n\n\n

Na p\u00e1gina gerada, procure por “Loaded Configuration File” \u2014 \u00e9 o caminho do php.ini em uso. Um cuidado importante: apague esse arquivo depois de consultar<\/strong>, porque o phpinfo()<\/code> exp\u00f5e muitos detalhes do servidor que podem ajudar um atacante.<\/p>\n\n\n\n

Como editar o php.ini<\/h2>\n\n\n\n

Aqui est\u00e1 a parte que mais gera d\u00favida, porque depende do tipo de hospedagem. Depois de qualquer altera\u00e7\u00e3o, confirme que ela pegou: acesse novamente o phpinfo()<\/strong><\/code> (ou rode php -i<\/strong><\/code>) e veja se a diretiva est\u00e1 com o novo valor.<\/p>\n\n\n\n

\n
⚠️ Em hospedagem compartilhada, voc\u00ea n\u00e3o edita o arquivo direto<\/div>\n

Na maioria das hospedagens compartilhadas, o php.ini \u00e9 um arquivo global do servidor, compartilhado por todos os sites \u2014 por isso voc\u00ea n\u00e3o tem permiss\u00e3o para edit\u00e1-lo diretamente. Em vez disso, o painel oferece uma interface para ajustar as diretivas s\u00f3 do seu site. No cPanel<\/strong>, isso fica em Select PHP Version \u2192 Options<\/em>. As altera\u00e7\u00f5es feitas ali valem apenas para a sua conta, com seguran\u00e7a.<\/p>\n<\/div>\n\n\n\n

No cPanel (hospedagem compartilhada)<\/h3>\n\n\n\n

Este \u00e9 o caminho para a maioria dos sites hospedados. No cPanel:<\/p>\n\n\n\n

    \n
  1. Acesse o cPanel e clique em Select PHP Version<\/strong> (Selecionar vers\u00e3o do PHP).<\/li>\n\n\n\n
  2. Clique em Switch To PHP Options<\/strong> (ou “Options”).<\/li>\n\n\n\n
  3. Voc\u00ea ver\u00e1 a lista de diretivas ajust\u00e1veis (memory_limit, max_execution_time, upload_max_filesize, display_errors, etc.).<\/li>\n\n\n\n
  4. Clique no valor da diretiva que quer mudar, escolha o novo valor e salve.<\/li>\n<\/ol>\n\n\n\n

    As mudan\u00e7as entram em vigor na hora, sem precisar reiniciar nada, e afetam s\u00f3 o seu site. \u00c9 o m\u00e9todo recomendado para quem est\u00e1 em hospedagem compartilhada.<\/p>\n\n\n\n

    Editando o arquivo diretamente (VPS ou dedicado)<\/h3>\n\n\n\n

    Se voc\u00ea tem um VPS<\/a> ou servidor dedicado, com acesso de administrador, edita o arquivo diretamente:<\/p>\n\n\n\n

      \n
    1. Localize o arquivo com php --ini<\/code>.<\/li>\n\n\n\n
    2. Abra-o com um editor de texto (por exemplo, nano \/etc\/php\/8.x\/apache2\/php.ini<\/code>).<\/li>\n\n\n\n
    3. Encontre a diretiva (a busca do editor ajuda), altere o valor e salve.<\/li>\n\n\n\n
    4. Reinicie o servi\u00e7o<\/strong> para aplicar: o Apache (systemctl restart apache2<\/code>) ou o PHP-FPM, conforme o seu setup.<\/li>\n<\/ol>\n\n\n\n

      O passo 4 \u00e9 o que muita gente esquece: ao editar o arquivo direto, a mudan\u00e7a s\u00f3 vale depois de reiniciar<\/strong> o servidor web ou o PHP-FPM. Sem isso, o PHP continua com a configura\u00e7\u00e3o antiga em mem\u00f3ria.<\/p>\n\n\n\n

      Criando um php.ini pr\u00f3prio na hospedagem compartilhada<\/h3>\n\n\n\n

      Muitas hospedagens compartilhadas, mesmo sem dar acesso ao php.ini global, permitem que voc\u00ea crie um arquivo de configura\u00e7\u00e3o pr\u00f3prio<\/strong> na pasta do seu site. Dependendo do servidor, ele se chama php.ini<\/code> ou .user.ini<\/code>, e vale s\u00f3 para o seu diret\u00f3rio e subpastas.<\/p>\n\n\n\n

      Pelo gerenciador de arquivos do cPanel, na raiz do site (public_html<\/code>), crie um arquivo novo chamado php.ini<\/code> (ou .user.ini<\/code>) e adicione s\u00f3 as diretivas que quer mudar, uma por linha:<\/p>\n\n\n\n

      \n memory_limit = 256M\nupload_max_filesize = 64M\nmax_execution_time = 120<\/code>\n<\/div>\n\n\n\n

      O .user.ini<\/code> \u00e9 o mecanismo do PHP (em instala\u00e7\u00f5es com PHP-FPM ou CGI) para configura\u00e7\u00f5es por diret\u00f3rio \u2014 funciona de forma parecida com o que o .htaccess<\/code> faz para o Apache. Ap\u00f3s criar o arquivo, a mudan\u00e7a pode levar alguns minutos para valer (o PHP rel\u00ea o .user.ini<\/code> periodicamente). Se o cPanel tiver o MultiPHP INI Editor<\/strong>, ele oferece essa mesma edi\u00e7\u00e3o por uma interface gr\u00e1fica, sem criar o arquivo \u00e0 m\u00e3o.<\/p>\n\n\n\n

      Pelo .htaccess ou ini_set (alternativas)<\/h3>\n\n\n\n

      H\u00e1 ainda duas formas de ajustar diretivas sem tocar no php.ini, \u00fateis quando voc\u00ea n\u00e3o tem acesso a ele:<\/p>\n\n\n\n