Hospedagem & cPanel 31 visualizações

Como configurar o php.ini para aumentar o limite de upload e tempo de execução

Ver no WHMCS

Como aumentar o limite de upload e o tempo de execução no PHP (php.ini)

Oi! Aqui é a Sensei da GeHost 🧘‍♀️ Se você já tentou enviar um arquivo maior pro seu site, subir um tema/plugin do WordPress ou rodar um processo mais pesado e recebeu um erro do tipo "arquivo excede o tamanho máximo" ou "tempo limite de execução excedido", é bem provável que o problema esteja em duas configurações clássicas do PHP: upload_max_filesize e max_execution_time. Vamos resolver isso juntos, com calma, passo a passo.

O que é o php.ini, afinal?

O php.ini é o arquivo de configuração que diz ao PHP como ele deve se comportar no seu site: quanto de memória pode usar, qual o tamanho máximo de arquivo que aceita em um upload, quanto tempo um script pode rodar antes de ser interrompido, entre outras coisas. Você não precisa editar esse arquivo na "unha" — o cPanel tem uma ferramenta visual pronta pra isso, bem tranquila de usar mesmo sem conhecimento técnico.

Passo a passo pelo cPanel

  1. Acesse o seu cPanel. Use o link e as credenciais que a GeHost te enviou por e-mail no momento da contratação (ou recupere o acesso pelo painel do cliente em painel.gehost.com.br).
Tela de login do cPanel com campos de usuário e senha
  1. Depois de logar, você vai cair na tela inicial do cPanel, com vários grupos de ferramentas organizados por ícones (E-mail, Arquivos, Bancos de Dados, Software etc.).
Painel inicial do cPanel com os grupos de ferramentas
  1. Procure a seção "Software" e clique em "MultiPHP INI Editor" (em alguns painéis aparece como "Select PHP Version" → opção de configurações/Options). Use a busca no topo do cPanel e digite "PHP" se não encontrar de primeira.
  2. Na tela do MultiPHP INI Editor, selecione o domínio que você quer ajustar no menu suspenso.
  3. Você vai ver duas opções de visualização: o modo "Editor" (campos organizados, mais fácil pra iniciante) e o modo "Editor bruto" (edição direta do texto). Recomendo o modo Editor pra começar.
  4. Localize os seguintes campos e ajuste os valores conforme a sua necessidade:
    • upload_max_filesize — tamanho máximo de um único arquivo enviado por upload.
    • post_max_size — tamanho máximo total do envio (precisa ser igual ou maior que o upload_max_filesize, senão o upload continua travando).
    • max_execution_time — quantos segundos um script PHP pode rodar antes de ser interrompido.
    • max_input_time — tempo máximo para o PHP processar os dados de entrada (formulários, uploads etc.).
    • memory_limit — memória máxima que um script pode usar; vale aumentar um pouco junto, principalmente se o upload for de arquivos grandes.
  5. Clique em "Aplicar" (ou "Save"/"Apply") no final da página. A alteração já entra em vigor na hora, sem precisar reiniciar nada.
💡 Dica da Sensei: ajuste sempre post_max_size para um valor igual ou um pouco maior que upload_max_filesize. É o erro mais comum: a pessoa aumenta só o upload e esquece do post, e o envio continua falhando.

Se o MultiPHP INI Editor não estiver disponível

Em alguns casos, dependendo da versão de PHP configurada pra sua conta, o ajuste fino não aparece no editor visual. Nessa situação, você pode criar (ou editar) um arquivo chamado .user.ini na pasta raiz do seu site (geralmente public_html), usando o Gerenciador de Arquivos do cPanel.

Gerenciador de Arquivos do cPanel mostrando a árvore de pastas
  1. Abra o Gerenciador de Arquivos e navegue até a pasta public_html (ou a pasta do domínio específico, se for um subdomínio ou domínio adicional).
  2. Crie um arquivo novo chamado .user.ini (se ainda não existir).
  3. Edite o arquivo e adicione as linhas, uma por linha, por exemplo:
    • upload_max_filesize = 64M
    • post_max_size = 64M
    • max_execution_time = 300
    • max_input_time = 300
    • memory_limit = 256M
  4. Salve o arquivo. Esse tipo de configuração pode levar alguns minutos para "pegar" no ar, porque o PHP recarrega esse arquivo periodicamente — não se assuste se não funcionar na hora, aguarde um pouco e teste de novo.
💡 Dica da Sensei: os valores exatos que você pode configurar (o teto máximo permitido) dependem do seu plano de hospedagem. Se tentar um número muito alto e ele não "salvar", é sinal de que passou do limite do seu plano — nesse caso, dá uma olhada nos detalhes do seu plano no painel do cliente ou fala com o suporte pra confirmar o teto disponível.

Como confirmar se deu certo

Depois de salvar, você pode confirmar as novas configurações de duas formas:

  • Voltando ao MultiPHP INI Editor e verificando se os valores aparecem atualizados.
  • Criando um arquivinho de teste, por exemplo info.php, com o conteúdo <?php phpinfo(); ?>, acessando pelo navegador e procurando pelas linhas upload_max_filesize, post_max_size e max_execution_time. Depois de conferir, é só apagar esse arquivo — ele expõe informações do servidor e não deve ficar publicado.

Precisa de ajuda?

Se mesmo seguindo os passos o upload continuar travando, ou se você não encontrar essas opções no seu cPanel, é só chamar o suporte da GeHost. Lembrando que todo cliente conta com 30 dias de suporte gratuito logo após a entrega do serviço — depois disso, é só consultar as condições do seu plano no painel do cliente.

Prontinho! Com esses ajustes, seu site fica preparado pra receber arquivos maiores e dar tempo suficiente pros scripts mais pesados rodarem sem interrupção. 🌱

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.