O PHP protege o desempenho do servidor limitando o tamanho dos arquivos enviados. No entanto, o limite padrão costuma ser muito baixo para muitas aplicações web modernas, como sites WordPress, lojas virtuais ou sistemas que trabalham com mídias.
- Leia também: Como fazer backup do seu site WordPress e evitar perder tudo
- Leia também: Detecção de Phishing em Alta Escala: O Novo Desafio de Segurança para CISOs
- Leia também: Alerta de Segurança: Trojan PixRevolution Sequestra Transferências PIX no Brasil
Esse problema geralmente aparece quando uma aplicação PHP exibe uma mensagem de erro solicitando o aumento do tamanho máximo de upload de arquivos.
Felizmente, existem várias formas de ajustar esse limite — desde alterações simples no cPanel até configurações mais avançadas no WHM. Neste artigo, você aprenderá como fazer isso de forma rápida e segura.
O que é “upload_max_filesize” em PHP?
A diretiva upload_max_filesize é uma configuração do PHP definida em arquivos como:
- php.ini
- user.ini
Esses arquivos controlam o comportamento do interpretador PHP no servidor.
Como o nome sugere, a diretiva upload_max_filesize define o tamanho máximo permitido para envio de arquivos através de aplicações PHP.
Por padrão, esse valor é de apenas 2MB, o que é insuficiente para a maioria dos sites atuais.
Outras diretivas importantes relacionadas
Ao aumentar o limite de upload, você também precisa ajustar outras configurações para evitar conflitos:
- post_max_size
Define o tamanho máximo de dados enviados via POST.
Deve ser maior que o upload_max_filesize - memory_limit
Define a quantidade máxima de memória que um script pode usar.
Deve ser maior que o post_max_size
Como funcionam os valores?
Os valores dessas diretivas são definidos em bytes, mas você pode usar abreviações:
- K = Kilobytes
- M = Megabytes
- G = Gigabytes
Exemplos:
- 1000K = 1000 KB
- 100M = 100 Megabytes
- 1G = 1 Gigabyte
Como aumentar o tamanho máximo de upload do PHP no cPanel?
Se você utiliza hospedagem com cPanel, o processo é simples e não exige acesso root.
Role a página até a entrada de upload_max_filesize e edite o valor correspondente. Certifique-se de que o valor de post_max_size seja maior que upload_max_filesize e clique em Aplicar na parte inferior da página.
Passo a passo:
- Acesse o cPanel
- Vá até a seção Software
- Clique em Editor INI MultiPHP
- No menu suspenso, selecione o domínio ou diretório desejado
- Localize as opções:
- upload_max_filesize
- post_max_size
- memory_limit
- upload_max_filesize
- Defina os novos valores (exemplo recomendado):
- upload_max_filesize = 64M
- post_max_size = 64M ou maior
- memory_limit = 128M ou maior
- upload_max_filesize = 64M
- Clique em Aplicar
Dica: Sempre deixe uma margem entre os valores para evitar erros durante o upload.
Como alterar o tamanho máximo de upload do PHP no WHM?
Diferente do cPanel, no WHM permite alterar as configurações globais do servidor, afetando todas as contas que utilizam uma determinada versão do PHP.
Passo a passo:
- Acesse o WHM com usuário root
- Vá até a seção Software
- Clique em MultiPHP INI Editor
- No menu suspenso, selecione a versão do PHP desejada
Importante: Cada versão do PHP possui configurações independentes.
Se você usa múltiplas versões, será necessário repetir o processo para cada uma.
- Localize a diretiva upload_max_filesize
- Defina o novo valor desejado
- Ajuste também:
- post_max_size
- memory_limit
- post_max_size
- Clique em Aplicar
Boas práticas ao configurar uploads no PHP
- Sempre mantenha post_max_size ≥ upload_max_filesize
- Garanta que o memory_limit seja suficiente para processar o upload
- Evite valores excessivamente altos para não comprometer o desempenho do servidor
- Teste após a alteração para confirmar que tudo está funcionando corretamente
Aumentar o limite de upload do PHP é uma tarefa essencial para garantir que seu site funcione corretamente, especialmente em aplicações modernas que trabalham com arquivos maiores.
Seja pelo cPanel ou pelo WHM, o processo é simples, mas exige atenção às configurações relacionadas para evitar erros.
