blog
Infraestrutura web

Erro 413 mesmo depois de aumentar o limite do PHP

O limite que barra o upload é avaliado antes de o PHP entrar em cena, e ele não aparece na tela do MultiPHP INI Editor. Em hospedagem compartilhada, às vezes só o suporte consegue subi-lo. Veja como identificar qual teto está barrando e alinhar os dois sem quebrar o site.

JR · · 7 min de leitura · 3 tabelas · 2 blocos de código

Resposta curta: o 413 vem do servidor web, não do PHP. Existe um segundo teto (`LimitRequestBody` no Apache e LiteSpeed, `client_max_body_size` no NGINX) avaliado antes de o PHP ser acionado. Alinhe-o acima de `post_max_size` e `upload_max_filesize`, com backup do .htaccess antes.

Neste artigo
  1. Os dois tetos, e qual é avaliado primeiro
  2. Backup do .htaccess e como voltar atrás em segundos
  3. Como ver os dois tetos pelo cPanel
  4. Max Request Body Size no LiteSpeed e no OpenLiteSpeed
  5. Em NGINX a diretiva é client_max_body_size, e não há .htaccess
  6. Quando não subir o limite resolve melhor
  7. Qual sintoma aponta para qual teto

Você editou upload_max_filesize, editou post_max_size, limpou o cache, tentou de novo e a tela devolveu 413 Request Entity Too Large. O PHP não tem culpa, porque o PHP nem chegou a ver o arquivo.

Existe um segundo teto, antes do PHP: o limite de tamanho do corpo da requisição no servidor web. Ele é avaliado quando os bytes ainda estão chegando pela conexão. Se o upload estoura esse limite, o servidor corta a requisição e responde 413 sozinho, sem acionar o interpretador PHP. É por isso que mexer no painel de PHP não muda nada.

Os dois tetos, e qual é avaliado primeiro

Um upload de 80 MB passa por uma fila de porteiros. Só o último é o PHP.

Ordem Quem avalia Diretiva Onde se configura
1 Servidor web LimitRequestBody (Apache) .htaccess, vhost
1 Servidor web Max Request Body Size (LiteSpeed/OpenLiteSpeed) Admin do LiteSpeed, ou LimitRequestBody no .htaccess
1 Servidor web client_max_body_size (NGINX) nginx.conf, bloco server/location
2 PHP post_max_size MultiPHP INI Editor / php.ini
3 PHP upload_max_filesize MultiPHP INI Editor / php.ini
4 Aplicação limite do WordPress/plugin código ou configuração do plugin

O erro que o porteiro 1 devolve é o 413, uma resposta HTTP crua, normalmente sem a aparência do seu site. Os porteiros 2 e 3 devolvem outra coisa: uma mensagem do próprio WordPress ("o arquivo excede o upload_max_filesize"), ou uma tela branca, ou um upload que chega a 100% e depois falha dentro do Media Library.

Esse detalhe serve de diagnóstico. Se a mensagem é 413 e vem com cara de página de servidor, o problema está no nível 1. Se a mensagem é em português e dentro do admin do WordPress, está no nível 2 ou 3.

A fila de porteiros de um uploadServidor webLimitRequestBody ou client_max_body_sizePHP post_max_sizecorpo inteiro do POSTPHP upload_max_filesizearquivo enviadoWordPress ou pluginlimite da aplicação
O 413 nasce no primeiro porteiro, antes de o PHP ver o arquivo.

Backup do .htaccess e como voltar atrás em segundos

A alteração deste artigo mexe no .htaccess. Um .htaccess com sintaxe inválida derruba o site inteiro com 500 Internal Server Error, não só o upload. Então:

  1. Entre no cPanel e abra Gerenciador de Arquivos (File Manager).
  2. Navegue até a pasta raiz do site (normalmente public_html, ou public_html/nomedodominio em domínios adicionais).
  3. Clique em Configurações (canto superior direito) e marque Mostrar arquivos ocultos (dotfiles). Sem isso o .htaccess não aparece.
  4. Clique com o botão direito em .htaccess e escolha Copiar (ou Copy). Salve a cópia como .htaccess-backup na mesma pasta.

Se algo quebrar: apague o .htaccess editado, renomeie .htaccess-backup de volta para .htaccess, recarregue o site. Volta ao estado anterior em segundos.

Como ver os dois tetos pelo cPanel

Onde conferir upload_max_filesize e post_max_size

No cPanel, vá em Software → MultiPHP INI Editor. Escolha o domínio no seletor e veja upload_max_filesize e post_max_size. Anote os dois.

Regra prática: post_max_size precisa ser maior que upload_max_filesize, porque o POST carrega o arquivo mais os campos do formulário. Um upload_max_filesize de 64M com post_max_size de 64M falha em arquivos próximos do limite.

Por que o teto do servidor não aparece em nenhuma tela

Esse não aparece na tela do MultiPHP INI Editor, e no cPanel de hospedagem compartilhada não existe campo que mostre o valor em vigor. O método aqui é inferência: você confirma o que o PHP está aplicando e, por eliminação, descobre se existe um teto menor antes dele. É aí que a maioria das tentativas trava.

O jeito mais direto de ver o valor efetivo é criar um arquivo de teste. No Gerenciador de Arquivos, dentro de public_html, clique em + Arquivo, crie info.php e cole:

<?php phpinfo();

Acesse https://seudominio.com.br/info.php. A página mostra os valores de PHP em vigor, incluindo o Loaded Configuration File (qual php.ini está realmente valendo) e a seção do servidor. Apague o info.php assim que terminar de ler: ele expõe detalhes da sua instalação para qualquer visitante.

O que o phpinfo() não mostra é o LimitRequestBody. Para esse valor não há leitura direta, só inferência por teste de upload: com os valores de PHP já acima de 60 MB, se um arquivo de 10 MB sobe e um de 60 MB devolve 413 crua, há um teto de servidor entre os dois.

Como declarar LimitRequestBody no .htaccess

Abra o .htaccess no Gerenciador de Arquivos (botão direito → Editar) e, no topo do arquivo, antes do bloco # BEGIN WordPress, acrescente:

LimitRequestBody 104857600

O valor é em bytes, sem sufixo. 104857600 bytes são 100 MB. Esse número é um exemplo, escolha o seu: multiplique os MB desejados por 1048576.

Em Apache e em LiteSpeed/OpenLiteSpeed, LimitRequestBody com valor 0 significa sem limite imposto por essa diretiva. Evite 0 em produção: um limite alto e explícito é melhor que nenhum, porque um upload infinito é também uma forma de abuso.

Por que o teto do servidor precisa ser o maior dos três

Depois do passo 3, volte ao MultiPHP INI Editor e ajuste post_max_size e upload_max_filesize abaixo do LimitRequestBody que você definiu no .htaccess. Aproveite e confira os dois limites de tempo, que ficam na mesma tela:

Diretiva Exemplo coerente Onde se edita
LimitRequestBody (servidor) 104857600 (100 MB) .htaccess (passo 3)
post_max_size (PHP) 96M MultiPHP INI Editor
upload_max_filesize (PHP) 90M MultiPHP INI Editor
max_execution_time 300 MultiPHP INI Editor
max_input_time 300 MultiPHP INI Editor

Os valores da tabela são exemplo, não recomendação universal. O que importa é a ordem: o teto do servidor é o maior, e os dois do PHP ficam abaixo dele. Se o do servidor for menor, você volta ao 413 e os ajustes de PHP ficam decorativos.

max_execution_time e max_input_time entram porque um arquivo grande em conexão lenta pode estourar tempo antes de estourar tamanho. O sintoma aí é diferente: o upload morre no meio, não no começo.

Repita o upload com o mesmo arquivo que deu 413

Use o mesmo arquivo que deu 413, não um menor. Se o painel do seu servidor tiver cache de página, limpe antes. Se continuar 413 com o mesmo arquivo, o teto ainda está acima na pilha: pode haver um proxy, um CDN ou um WAF na frente do servidor com limite próprio de corpo de requisição.

Max Request Body Size no LiteSpeed e no OpenLiteSpeed

Em LiteSpeed, o limite se chama Max Request Body Size e vive na configuração do servidor, não no arquivo do site. A documentação do LiteSpeed Cloud (Optimize Upload Size) descreve o ajuste de tamanho de upload envolvendo tanto os valores de PHP quanto o limite do servidor web, exatamente a separação que este artigo descreve.

Se você tem acesso ao WebAdmin do LiteSpeed, o parâmetro fica em Configuration → Server → Tuning → Max Request Body Size: esse caminho de menu é da própria interface do WebAdmin, não da página citada acima, que trata apenas da relação entre os valores de PHP e o limite do servidor. Em hospedagem compartilhada você não tem esse acesso, e aí restam dois caminhos: o LimitRequestBody no .htaccess, que o LiteSpeed interpreta por compatibilidade com Apache, ou pedir o ajuste ao suporte do seu provedor informando o valor em MB que precisa.

Uma observação honesta: em alguns ambientes compartilhados o limite do servidor é travado e o .htaccess não o sobrescreve para cima. Se depois do passo 3 o 413 persistir com o mesmo arquivo, pare de editar e abra chamado. Continuar empilhando diretivas só aumenta a chance de quebrar o .htaccess.

Em NGINX a diretiva é client_max_body_size, e não há .htaccess

NGINX não lê .htaccess. A diretiva é client_max_body_size, em nginx.conf ou no bloco server do site, e exige recarregar o serviço. Se o seu site roda atrás de um NGINX como proxy reverso (arranjo comum em VPS), o 413 pode nascer ali, antes de chegar ao Apache ou ao PHP-FPM. Nesse cenário, os três valores precisam estar alinhados: NGINX, servidor de aplicação e PHP.

Quando não subir o limite resolve melhor

Antes de subir qualquer limite, pergunte se o arquivo precisa mesmo passar pelo uploader do navegador.

Subir limite é legítimo quando o arquivo grande é parte do negócio (um PDF de catálogo, um pacote para download pago). Quando é só falta de otimização, o limite maior esconde o problema em vez de resolver.

Qual sintoma aponta para qual teto

Sintoma Teto provável Onde agir
413 cru, página sem o tema do site Servidor web LimitRequestBody / Max Request Body Size / client_max_body_size
Mensagem do WordPress sobre upload_max_filesize PHP MultiPHP INI Editor
Upload chega a 100% e falha depois post_max_size ou tempo MultiPHP INI Editor
Falha só em conexão lenta max_input_time MultiPHP INI Editor
500 depois da edição sintaxe do .htaccess restaure o .htaccess-backup

Se depois de alinhar todos os valores da tabela do passo 4 o arquivo continuar barrado, registre: tamanho exato do arquivo, horário da tentativa, URL e a mensagem literal da tela. Com esses quatro dados o suporte consegue localizar a linha no log de erro do servidor, que é onde a resposta final está.

Caminho do diagnóstico até o teto certoLeia a tela do erro413 cru ou aviso do WordPressFaça backup do .htaccesscopie como .htaccess-backupAjuste o teto do servidormaior que os dois do PHPRepita com o mesmo arquivose persistir, abra chamado
Ordem de diagnóstico sem editar diretiva no escuro.

Referências

  1. Documentação oficial (litespeed) — LiteSpeed Cloud: Optimize Upload Size. Consultado em 2026-10-13.
Leia também