Solucionar problemas de limitação de uploads grandes no PHP-FPM em VPS Linux e servidor dedicado

Problemas ao realizar uploads grandes em aplicações PHP são comuns em ambientes VPS Linux e servidores dedicados, especialmente quando o PHP-FPM está configurado com limites restritivos. Neste guia, você aprenderá como identificar, ajustar e validar as configurações essenciais para garantir uploads estáveis e sem erros, seguindo boas práticas de segurança e desempenho.

Passos para solucionar limitação de uploads grandes no PHP-FPM

1. Verifique os limites atuais do PHP

   Confira os valores de upload_max_filesize e post_max_size no arquivo php.ini. Você pode localizar o arquivo executando:

   php --ini

   Procure pelas linhas:

   upload_max_filesize = 2M
   post_max_size = 8M

   Altere para valores adequados, por exemplo:

   upload_max_filesize = 100M
   post_max_size = 120M

   Salve e feche o arquivo.

2. Ajuste as configurações do PHP-FPM

   Edite o arquivo de pool do PHP-FPM, normalmente em /etc/php-fpm.d/www.conf ou /etc/php/7.x/fpm/pool.d/www.conf:

   php_admin_value[upload_max_filesize] = 100M
   php_admin_value[post_max_size] = 120M

   Reinicie o PHP-FPM para aplicar as mudanças:

   systemctl restart php-fpm

3. Verifique as configurações do servidor web (Nginx ou Apache)

   Para Nginx, ajuste o parâmetro client_max_body_size no bloco do servidor:

   server {
     ...
     client_max_body_size 120M;
     ...
   }

   Reinicie o Nginx:

   systemctl restart nginx

   Para Apache, normalmente não há limitação, mas verifique se há diretivas LimitRequestBody em .htaccess ou httpd.conf.

4. Valide as alterações

   Crie um arquivo info.php com <?php phpinfo(); ?> e acesse via navegador para conferir se os novos valores foram aplicados.

5. Teste o upload na aplicação

   Realize um upload de arquivo do tamanho desejado e verifique se o processo é concluído sem erros.

Checklist rápido

• Faça backup dos arquivos de configuração antes de alterar.
• Reinicie os serviços após cada ajuste.
• Utilize valores compatíveis com a memória e recursos do servidor.
• Evite valores excessivamente altos para não comprometer a segurança.

Erros comuns e como resolver

• Erro 413 Request Entity Too Large: Ajuste client_max_body_size no Nginx.
• Arquivo não sobe e não há mensagem de erro: Verifique permissões do diretório /tmp e limites do PHP.
• Timeout durante upload: Aumente max_execution_time e max_input_time no php.ini.
• Configuração não surte efeito: Confirme se está editando o arquivo correto e reinicie o serviço PHP-FPM.

Resumo

• Identifique e ajuste os limites de upload no PHP-FPM e servidor web.
• Valide as alterações com um arquivo phpinfo().
• Teste uploads grandes e monitore o desempenho do servidor.

Para mais dicas sobre performance e segurança, confira nosso guia de servidores dedicados e outros artigos sobre hospedagem Linux na AviraHost.

Contrate Agora

Garanta estabilidade e suporte 24/7 para suas aplicações PHP com um servidor dedicado AviraHost. Fale com nossos especialistas e descubra o melhor plano para o seu projeto.