{"id":40834,"date":"2023-10-17T13:41:32","date_gmt":"2023-10-17T16:41:32","guid":{"rendered":"\/tutoriais\/?p=40834"},"modified":"2026-05-21T12:47:00","modified_gmt":"2026-05-21T05:47:00","slug":"php-ini","status":"publish","type":"post","link":"\/br\/tutoriais\/php-ini\/","title":{"rendered":"O que \u00e9 o arquivo php.ini e onde ele fica? Entenda os principais par\u00e2metros e como edit\u00e1-lo"},"content":{"rendered":"

O PHP.ini<\/strong> é 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.  <\/p>

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.<\/p>

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

\"\"<\/a><\/figure>

\n\n\n\n\n\n

\n \n \n <\/svg>\n

\n O Que é PHP.ini?\n <\/p>\n <\/div>\n

O PHP.ini<\/strong> é um arquivo de configuração que contém as definições de PHP do seu servidor web. Ele permite que você controle as regras relacionadas ao PHP do seu site, incluindo definir o limite de tamanho ao fazer upload de arquivos e ocultar mensagens de erro.
\nA localização deste arquivo de configuração PHP varia dependendo do servidor web. Para alterar as configurações, edite o arquivo e altere o valor do parâmetro através de um editor de texto. <\/p><\/div>\n\n\n\n<\/p>

Onde Fica Localizado o Arquivo PHP.ini?<\/h3>

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

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

    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.<\/p>

    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<\/a>:<\/p>

      \n
    1. Vá para hPanel → Hospedagem <\/strong>→ <\/strong>Gerenciar<\/strong> <\/strong>.<\/li>\n\n\n\n
    2. Clique em Gerenciador de arquivos <\/strong>.<\/li>\n<\/ol>
      \n
      \"Painel<\/figure>\n<\/div>
        \n
      1. Navegue até o diretório raiz do seu site. No nosso caso, é \/home\/nome_de_usuário\/public_html<\/strong>.<\/li>\n\n\n\n
      2. Selecione o ícone + Novo Arquivo<\/strong>. Insira qualquer nome de arquivo com uma extensão PHP, como phpinfo.php<\/strong>. Então, clique em Criar Novo Arquivo<\/strong>.<\/li>\n\n\n\n
      3. Clique com o botão direito no novo arquivo → Editar<\/strong> e insira o seguinte código:<\/li>\n<\/ol>
        <?php\n   phpinfo();\n?><\/pre>
          \n
        1. Clique em Salvar alterações.<\/strong><\/li>\n\n\n\n
        2. Digite seudominio.tld\/phpinfo.php <\/strong>no seu navegador e pressione enter. <\/li>\n\n\n\n
        3. Busque pelo Arquivo de configuração carregado<\/strong>. O caminho do PHP.ini<\/strong> deve se parecer com o seguinte exemplo:<\/li>\n<\/ol>
          \n
          \"\"<\/figure>\n<\/div>
          Este método também funciona no cPanel<\/a> para localizar o arquivo PHP.ini <\/strong>de um servidor privado virtual (VPS). Outra opção é você se conectar usando SSH<\/a> e executar o seguinte comando:<\/p>
          php -i | grep 'Arquivo de Configuração'<\/pre>
          O seu cliente SSH mostrará o diretório, que é usr\/local\/lib<\/strong> na maioria dos servidores web. Além de consultar a localização, você pode mover e editar o arquivo  PHP.ini <\/strong> com o cliente SSH.<\/p>
          \n\n\n        
          \n            
          \n                \n                    \n                <\/svg>\n                
          \n                    Saiba Mais sobre VPS e Comandos Linux                <\/p>\n            <\/div>\n            

          \n          O Que é Hospedagem VPS<\/a>
          \n          Comandos Essenciais do Linux que Todo Usuário Deveria Saber<\/a><\/p>\n                    <\/div>\n        \n\n\n\n<\/p>
          Observe que o arquivo PHP.ini<\/strong> 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<\/strong> .htaccess<\/a> para modificar as configurações PHP<\/p>
          Parâmetros Importantes do Arquivo PHP.ini<\/h2>
          Nesta seção, explicaremos os parâmetros mais importantes contidos no arquivo PHP.ini<\/strong>, incluindo seus valores e propósitos. Esses parâmetros também são conhecidos como diretrizes<\/strong>.<\/p>
          \n\n\n
          \n            \n                \n                    \n                <\/svg>\n                Important\n            <\/span>\n            
          \n                Importante!<\/strong> Alguns parâmetros e valores podem não estar disponíveis em certas versões do PHP. Consulte a lista completa de diretivas PHP.ini<\/a> para aprender mais sobre as alterações.\n            <\/p><\/div>\n\n\n\n<\/p>
          display_errors<\/strong><\/p>
          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<\/strong> (ligadas) e off<\/strong> (desligadas). Por razões de segurança, você deve usar essa diretriz apenas quando estiver desenvolvendo seu site.  <\/p>
          error_reporting<\/strong><\/p>
          Define qual mensagem de erro é exibida para os usuários quando a diretriz display_errors <\/strong>está ativada. O parâmetro error_reporting <\/strong> aceita várias constantes para exibir diferentes erros<\/a>.<\/p>
          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:<\/p>
          E_ALL & ~E_DEPRECATED<\/pre>
          error_log<\/strong><\/p>
          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. <\/p>
          file_uploads<\/strong><\/p>
          Define se os uploads de arquivos HTTP estão habilitados ou não. O valor on<\/strong> (habilitado) permitirá que os usuários façam upload de arquivos para o seu site, enquanto off<\/strong> (desabilitado) desativa essa função. <\/p>
          upload_max_filesize<\/strong>Este parâmetro determina o tamanho máximo que o PHP permitirá<\/a> para upload de arquivos em seu site. Como o valor padrão é 2 MB<\/strong>, você pode aumentar o tamanho máximo de upload de arquivo<\/a> para permitir que os usuários subam de arquivos grandes.<\/p>
          post_max_size<\/strong><\/p>
          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<\/a> (link em inglês).<\/p>
          allow_url_fopen<\/strong><\/p>
          Escreve um script PHP para acessar arquivos remotos de outro servidor. Está desativado<\/strong> por padrão, pois ativá-lo pode expor seu servidor a um ataque de injeção de código. <\/p>
          allow_url_include<\/strong><\/p>
          Esta diretiva tem uma função semelhante à de allow_url_open<\/strong>, mas usa a função include<\/a> (link em inglês). Para habilitá-lo, você precisa antes habilitar<\/strong> a diretriz allow_url_open<\/strong>. <\/p>
          session.name<\/strong><\/p>
          Esta diretiva define o nome da sessão atual, que é usado em cookies e URLs. Você pode alterar o valor padrão de PHPSESSID<\/strong> para qualquer nome descritivo com caracteres alfanuméricos. <\/p>
          session.auto_start<\/strong><\/p>
          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, <\/strong>a sessão iniciará manualmente usando o script session_start<\/strong>. <\/p>
          session.cookie_lifetime<\/strong><\/p>
          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<\/strong> segundos, o que significa que seu site apaga os dados da sessão dos visitantes depois que eles fecham seus navegadores.  <\/p>
          memory_limit<\/strong><\/p>
          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. <\/p>
          max_execution_time<\/strong><\/p>
          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.<\/p>
          \n\n\n        
          \n            
          \n                \n                    \n                <\/svg>\n                
          \n                    Leitura Sugerida                <\/p>\n            <\/div>\n            
          Consulte o nosso guia sobre como  corrigir o Erro Fatal: max_execution_time excedido<\/a> se você receber esse código de erro.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p>
          max_input_time<\/strong><\/p>
          Define por quanto tempo um script pode analisar dados coletados de formulários HTML em seu site usando um método POST ou GET<\/a> (link em inglês). Quanto mais dados seu site coleta, maior deve ser o valor de max_input_time <\/strong>.<\/p>
          upload_temp_dir<\/strong><\/p>
          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. <\/p>
          realpath_cache_ttl<\/strong><\/p>
          Define o tempo pelo qual seu sistema vai armazenar em cache as informações do realpath<\/a> (link em inglês). Recomendamos aumentar o valor para sistemas com arquivos que raramente mudam. <\/p>
          arg_separator.output<\/strong><\/p>
          Use esta diretiva de manipulação de dados para separar argumentos em URLs gerados pelo PHP. Seu valor padrão é um ampersand (&<\/strong>).<\/p>
          arg_separator.output<\/strong><\/p>
          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 (;).<\/p>
          Como Editar o Arquivo PHP.ini<\/h2>
          Antes de editar o arquivo  PHP.ini<\/strong>, verifique a configuração PHP do seu servidor usando o phpinfo.php<\/strong>.
          Se configurado como um módulo Apache, altere a configuração PHP           usando seu arquivo.htaccess<\/a>.<\/p>
          \n\n\n
          \n            \n                \n                    \n                <\/svg>\n                Important\n            <\/span>\n            
          \n                Importante!<\/strong> Crie um backup do seu arquivo PHP.ini<\/strong> antes de editá-lo. Ele permite que você restaure rapidamente o arquivo, pois configurações incorretas podem resultar em problemas de desempenho ou tempo de inatividade para seu site.\n            <\/p><\/div>\n\n\n\n<\/p>
          Para o PHP CGI, você pode editar diretamente o arquivo INI usando o Editor de INI MultiPHP<\/a> (link em inglês) do cPanel. <\/p>
          Se você está usando o hPanel, simplesmente baixe e edite o arquivo usando um editor de texto. <\/p>
          Para usuários do cPanel, aqui estão as etapas para fazer isso:<\/p>
            \n
          1. Acesse seu cPanel<\/strong>.<\/li>\n\n\n\n
          2. Vá para a <\/strong>seção Software → Editor MultiPHP INI <\/strong>.<\/li>\n\n\n\n
          3. Clique na aba Modo Básico <\/strong>. Se preferir uma personalização aprofundada, selecione o Modo Editor <\/strong>.<\/li>\n\n\n\n
          4. No menu suspenso, selecione o diretório raiz<\/strong> ou o caminho do domínio<\/strong>. Este último configurará o arquivo PHP.ini<\/strong> específico do seu domínio.<\/li>\n\n\n\n
          5. Altere as configurações para cada diretiva PHP e clique em Aplicar <\/strong>para salvar as alterações. <\/li>\n<\/ol>
            Se o seu servidor não suportar a ferramenta de edição, use o Seletor de PHP<\/strong> em vez disso. Alternativamente, baixe o arquivo PHP.ini <\/strong>e altere as diretivas de configuração usando um editor de texto. <\/p>
            \n
            \"Editor<\/figure>\n<\/div>
            Se você usa uma VPS<\/a>, pode configurar as definições de PHP via cliente SSH. Certifique-se de ter instalado o editor de texto Nano<\/a> e execute este comando:<\/p>
            nano usr\/local\/lib\/php.ini<\/pre>
            Altere o diretório para o caminho do seu arquivo PHP.ini<\/strong> no seu VPS.<\/p>
            Conclusão<\/h2>
            O PHP.ini<\/strong> é 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. <\/p>
            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<\/strong>. Você pode descobrir a sua localização dentro da seção loaded configuration file<\/strong> (arquivo de configuração carregado) da tela de informações do PHP. <\/p>
            O PHP.ini <\/strong>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. <\/p>
            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!<\/p>\n","protected":false},"excerpt":{"rendered":"
            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 […]<\/p>\n
            Read More…<\/a><\/p>\n","protected":false},"author":125,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"rank_math_title":"O Que \u00e9 o Arquivo PHP.ini e Onde ele Fica? Veja Como Edit\u00e1-lo!","rank_math_description":"O php.ini \u00e9 o arquivo de configura\u00e7\u00e3o padr\u00e3o para executar aplicativos PHP. Confira este artigo para aprender mais sobre ele, incluindo como edit\u00e1-lo.","rank_math_focus_keyword":"php.ini","footnotes":""},"categories":[4915],"tags":[7586],"class_list":["post-40834","post","type-post","status-publish","format-standard","hentry","category-vps","tag-php-ini"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/tutorials\/what-is-php-ini\/","default":1},{"locale":"pt-BR","link":"https:\/\/www.hostinger.com\/br\/tutoriais\/php-ini\/","default":0},{"locale":"es-ES","link":"https:\/\/www.hostinger.com\/es\/tutoriales\/que-es-php-ini\/","default":0},{"locale":"id-ID","link":"https:\/\/www.hostinger.com\/id\/tutorial\/file-php-ini\/","default":0},{"locale":"en-PH","link":"https:\/\/www.hostinger.com\/ph\/tutorials\/what-is-php-ini\/","default":0},{"locale":"en-MY","link":"https:\/\/www.hostinger.com\/my\/tutorials\/what-is-php-ini\/","default":0},{"locale":"en-GB","link":"https:\/\/www.hostinger.com\/uk\/tutorials\/what-is-php-ini\/","default":0},{"locale":"en-IN","link":"https:\/\/www.hostinger.com\/in\/tutorials\/what-is-php-ini\/","default":0},{"locale":"en-CA","link":"https:\/\/www.hostinger.com\/ca\/tutorials\/what-is-php-ini\/","default":0},{"locale":"en-AU","link":"https:\/\/www.hostinger.com\/au\/tutorials\/what-is-php-ini\/","default":0},{"locale":"en-NG","link":"https:\/\/www.hostinger.com\/ng\/tutorials\/what-is-php-ini\/","default":0},{"locale":"es-AR","link":"https:\/\/www.hostinger.com\/ar\/tutoriales\/que-es-php-ini\/","default":0},{"locale":"es-MX","link":"https:\/\/www.hostinger.com\/mx\/tutoriales\/que-es-php-ini\/","default":0},{"locale":"es-CO","link":"https:\/\/www.hostinger.com\/co\/tutoriales\/que-es-php-ini\/","default":0},{"locale":"pt-PT","link":"https:\/\/www.hostinger.com\/pt\/tutoriais\/php-ini\/","default":0}],"acf":[],"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/40834","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/users\/125"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/comments?post=40834"}],"version-history":[{"count":4,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/40834\/revisions"}],"predecessor-version":[{"id":55391,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/40834\/revisions\/55391"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/media?parent=40834"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/categories?post=40834"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/tags?post=40834"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}