🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir o erro 413 Request Entity Too Large

Time Full Services Time Full Services
Tipo Erro HTTP
Nome do erro Erro 413 Request Entity Too Large EN: 413 Request Entity Too Large
Severidade Atenção
Descrição O erro 413 Request Entity Too Large é um código HTTP que indica que o corpo da requisição excede o limite que o servidor aceita. No WordPress, costuma aparecer ao enviar uma imagem, plugin ou tema maior que o upload_max_filesize do PHP ou o client_max_body_size do Nginx.

O que é o erro 413 no WordPress?

O 413 Request Entity Too Large (na especificação atual, Content Too Large) é um código de status HTTP em que o servidor recusa a requisição porque o seu corpo é maior do que o limite configurado. No WordPress, ele surge quase sempre na hora de fazer upload: enviar uma imagem ou vídeo pesado pela Biblioteca de Mídia, instalar um plugin ou tema em .zip grande, ou importar um arquivo de conteúdo. O limite real é o menor entre o do PHP (upload_max_filesize e post_max_size) e o do servidor web (client_max_body_size no Nginx).

Como identificar

  • Mensagem “413 Request Entity Too Large” ou “Request Entity Too Large” ao enviar um arquivo.
  • O upload na Biblioteca de Mídia falha em arquivos grandes, mas funciona com arquivos pequenos.
  • A instalação de um plugin ou tema em .zip volta erro logo após escolher o arquivo.
  • O painel mostra um “Tamanho máximo de upload” baixo (ex: 2 MB) em Mídia > Adicionar nova.
Antes de começar: Mantenha post_max_size sempre maior ou igual ao upload_max_filesize. Se o post_max_size ficar menor, o upload falha de forma silenciosa mesmo com o upload_max_filesize alto.

Como prevenir

  • Defina upload_max_filesize e post_max_size compatíveis com os arquivos que você costuma enviar
  • Comprima imagens e vídeos antes do upload para evitar arquivos desnecessariamente grandes
  • Documente o limite configurado para não estranhar falhas de upload em arquivos pesados

Causa

  • upload_max_filesize do PHP menor que o arquivo enviado (padrão comum de 2M).
  • post_max_size do PHP menor que o upload_max_filesize, limitando o corpo total da requisição.
  • client_max_body_size do Nginx com valor baixo, cortando a requisição antes de chegar ao PHP.
  • Limite de upload travado pelo painel do host, que ignora alterações no wp-config.php.
  • Plugin de mídia ou CDN reduzindo o tamanho máximo aceito além do limite do servidor.

Como resolver

  1. Confira o limite atual no painel: vá em Mídia > Adicionar nova e veja o "Tamanho máximo de upload". Esse número é o teto efetivo e mostra o quanto você precisa subir para acomodar o arquivo.
  2. Aumente os limites do PHP no php.ini: edite o php.ini do PHP-FPM e suba os três valores juntos, com post_max_size maior ou igual ao upload_max_filesize, depois reinicie o PHP.
    upload_max_filesize = 64M
    post_max_size = 64M
    memory_limit = 256M
    sudo systemctl restart php8.2-fpm
  3. Eleve o client_max_body_size do Nginx: no bloco server do site, adicione ou aumente o client_max_body_size para o mesmo patamar e recarregue o Nginx. Sem isso, o servidor web corta o upload antes do PHP.
    client_max_body_size 64M;
    sudo nginx -t && sudo systemctl reload nginx
  4. Tente pelo .htaccess se o host usa Apache: em hosts compartilhados com Apache, adicione as diretivas de limite ao .htaccess da raiz, já que você não tem acesso ao php.ini do servidor.
  5. Confirme que o host não trava o limite: alguns hosts fixam o limite no painel e ignoram alterações no php.ini ou no wp-config.php. Ajuste pelo painel da hospedagem ou peça o aumento ao suporte.
APACHE
# .htaccess - eleva os limites de upload no Apache (host compartilhado)
php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value memory_limit 256M
php_value max_execution_time 300
php_value max_input_time 300

Perguntas frequentes

O que significa o erro 413 Request Entity Too Large?
Significa que o corpo da requisição, em geral um upload, é maior do que o limite que o servidor aceita. No WordPress, o teto é o menor valor entre o upload_max_filesize do PHP e o client_max_body_size do servidor web.
Por que o upload de imagens grandes falha e o de pequenas funciona?
Porque só os arquivos acima do limite configurado disparam o 413. Os pequenos cabem no upload_max_filesize e passam. Para enviar os grandes, aumente os limites do PHP e do servidor web ou comprima o arquivo antes.
Aumentei o upload_max_filesize e o 413 continua. Por quê?
Há duas causas comuns: o post_max_size ficou menor que o upload_max_filesize, anulando o aumento; ou o servidor é Nginx e falta subir o client_max_body_size, que corta a requisição antes de chegar ao PHP.
Qual a diferença entre upload_max_filesize e post_max_size?
O upload_max_filesize limita o tamanho de cada arquivo enviado. O post_max_size limita o corpo total da requisição POST, que inclui o arquivo mais os outros campos. O post_max_size deve ser igual ou maior que o upload_max_filesize.
Meu host ignora as alterações no php.ini. O que fazer?
Muitos hosts compartilhados travam o limite no painel. Procure a opção de limite de upload ou versão do PHP no painel da hospedagem, ajuste por lá, ou peça o aumento ao suporte. Em Apache, tente também as diretivas php_value no .htaccess.
O client_max_body_size do Nginx tem a ver com o 413?
Tem, diretamente. Se o client_max_body_size estiver baixo, o Nginx devolve 413 antes mesmo de o PHP processar o upload. Suba esse valor no bloco server do site para o mesmo patamar do upload_max_filesize e recarregue o Nginx.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes