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
- 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).
- 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.).
- 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.
- Na tela do MultiPHP INI Editor, selecione o domínio que você quer ajustar no menu suspenso.
- 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.
- 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.
- 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.
- 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).
- Crie um arquivo novo chamado .user.ini (se ainda não existir).
- Edite o arquivo e adicione as linhas, uma por linha, por exemplo:
upload_max_filesize = 64Mpost_max_size = 64Mmax_execution_time = 300max_input_time = 300memory_limit = 256M
- 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. 🌱