blog
WordPress

Brotli ou gzip: descubra em dois comandos o que seu site envia

Dois comandos curl (ou a aba Rede do Chrome) mostram qual compressão chegou ao navegador e quantos bytes cada uma gastou. E três armadilhas que fazem o teste devolver resposta errada.

JR · · 7 min de leitura · 1 tabela · 3 blocos de código

Resposta curta: Peça a mesma URL duas vezes com `Accept-Encoding` diferente e leia o cabeçalho `Content-Encoding` da resposta: `br` é Brotli, `gzip` é gzip, ausente é sem compressão. Comparar os bytes das duas respostas mostra quantos KB o Brotli economiza no seu HTML.

Neste artigo
  1. O que o cabeçalho `Content-Encoding` responde
  2. Medir sem terminal, pela aba Rede do Chrome
  3. Os dois comandos que comparam gzip e Brotli
  4. Como ler o que voltou
  5. Três coisas que fazem o teste mentir
  6. Quando trocar vale e quando não vale
  7. Checklist antes de mexer em qualquer coisa

O que o cabeçalho `Content-Encoding` responde

Quando o navegador pede uma página, ele manda um cabeçalho dizendo quais compressões aceita (Accept-Encoding: gzip, deflate, br). O servidor escolhe uma e avisa na resposta qual usou, no cabeçalho Content-Encoding. É esse cabeçalho, e só ele, que diz o que chegou de fato:

Saber se existe compressão é uma pergunta. Qual das duas chegou, e quantos KB a diferença representa no seu HTML, é outra. O segundo número ninguém pode te dar de fora, porque depende do seu tema, dos seus plugins e do tamanho do seu HTML. Você mede no seu site, em dois comandos.

Dois pré-requisitos antes de testar. Primeiro: os navegadores só enviam br no Accept-Encoding em conexões HTTPS. Se o site responde em HTTP puro, o navegador nunca vai pedir Brotli e o teste não significa nada. Segundo: no cPanel, o Brotli vem do módulo mod_brotli do Apache, que a documentação da cPanel descreve como um módulo do EasyApache 4. Se ele não estiver instalado no servidor, nenhuma configuração dentro do WordPress faz Brotli aparecer.

Medir sem terminal, pela aba Rede do Chrome

Dá o mesmo dado e não exige nada instalado.

1. Abra a página e o DevTools

Abra seu site no Chrome, pressione F12 e clique na aba Network (Rede).

2. Recarregue ignorando o cache

Com o DevTools aberto, pressione Ctrl+Shift+R (ou Cmd+Shift+R no Mac). Sem isso, o Chrome pode servir a resposta guardada e você vai ler um cabeçalho antigo.

3. Clique na primeira linha da lista

É o documento HTML, normalmente com o nome do domínio ou uma barra. No painel que abre, vá em Headers e role até Response Headers. Procure a linha content-encoding.

4. Leia o tamanho na coluna Size

A coluna Size mostra dois valores empilhados: em cima, o que trafegou pela rede (comprimido); embaixo, o tamanho depois de descomprimir. A diferença entre os dois é o que a compressão economizou naquela requisição.

O limite desse método: ele mostra o que o seu navegador negociou, não o que o servidor faria com outra negociação. Para comparar gzip contra Brotli no mesmo arquivo, o terminal é mais direto.

Os dois comandos que comparam gzip e Brotli

São duas requisições para a mesma URL, mudando só o Accept-Encoding. Troque exemplo.com.br pelo seu domínio.

curl -s -o /dev/null \
  -H 'Accept-Encoding: gzip' \
  -w 'bytes: %{size_download}\n' \
  https://exemplo.com.br/

Linha a linha: -s cala a barra de progresso, -o /dev/null descarta o conteúdo (você quer o número, não o HTML), -H envia o cabeçalho fingindo um navegador que só aceita gzip, e -w 'bytes: %{size_download}\n' imprime quantos bytes vieram pela rede, já comprimidos. Esse comando não diz qual codificação voltou: isso sai do comando com -I logo abaixo.

Para ver também qual codificação voltou, peça os cabeçalhos:

curl -sI -H 'Accept-Encoding: gzip' https://exemplo.com.br/ | grep -i -E 'content-encoding|vary'
curl -sI -H 'Accept-Encoding: br'   https://exemplo.com.br/ | grep -i -E 'content-encoding|vary'

Resultado esperado em um servidor com os dois módulos ativos: a primeira linha devolve content-encoding: gzip e a segunda devolve content-encoding: br. Se as duas devolverem gzip, o Brotli não está disponível para esse recurso. Se nenhuma devolver nada, não há compressão no HTML e o problema a resolver é outro, anterior a este artigo.

Agora o número que interessa, o tamanho de cada variante:

for enc in gzip br; do
  echo -n "$enc: "
  curl -s -o /dev/null -H "Accept-Encoding: $enc" \
    -w '%{size_download} bytes\n' https://exemplo.com.br/
done

Saída esperada: duas linhas, uma para cada codificação, com os bytes recebidos. A subtração entre elas é o ganho do Brotli naquele HTML, naquele momento. Anote o resultado antes de mexer em qualquer coisa, porque é a sua linha de base.

Sequencia do teste de compressao no seu siteConfirme HTTPSSem HTTPS o navegador nao pede brPeca so gzipcurl com Accept-Encoding gzipPeca so brcurl com Accept-Encoding brAnote os bytesDois numeros, sua linha de base
Ordem do teste: mesma URL, muda apenas o Accept-Encoding.

Como ler o que voltou

O que o teste mostrou Leitura O que fazer
br com Accept-Encoding: br e gzip com gzip Servidor negocia as duas, Brotli ativo Nada. Já está no melhor cenário
gzip nas duas requisições Brotli indisponível para esse recurso Verificar se mod_brotli está instalado no EasyApache 4
Sem Content-Encoding nas duas HTML sem compressão Resolver a compressão básica antes de pensar em Brotli
br nas duas, inclusive quando você só pediu gzip Algo na frente está reescrevendo a resposta Investigar CDN ou proxy
Bytes praticamente iguais nas duas Arquivo já comprimido ou muito pequeno Testar em um CSS ou JS grande
Como decidir a partir do Content-Encoding recebidobr em uma, gzip na outraServidor negocia as duas, nada a fazergzip nas duasChecar mod_brotli no EasyApache 4Nenhum Content-EncodingResolver compressao basica primeirobr mesmo pedindo gzipInvestigar CDN ou proxy na frenteTamanhos quase iguaisRepetir em CSS ou JS grande
Cada resposta do curl leva a uma acao diferente.

Três coisas que fazem o teste mentir

CDN ou proxy na frente

Se há Cloudflare, outro CDN ou um proxy reverso entre você e o servidor, quem responde ao curl é a borda, não o Apache. A borda pode comprimir por conta própria, guardar uma variante em cache e devolver a mesma para todo mundo. Você estará medindo a política do CDN, não a do seu servidor. Para separar os dois, repita o teste apontando direto para o IP de origem (se você tiver esse acesso) ou use um hostname que não passe pelo CDN.

Arquivo que já é comprimido

JPG, PNG, WebP, PDF, ZIP e MP4 já carregam compressão interna. As fontes web também: WOFF usa zlib e WOFF2 usa Brotli dentro do próprio arquivo, então gzip ou Brotli por cima não tiram quase nada. Rodar gzip ou Brotli em cima de qualquer um desses devolve uma diferença de bytes que é ruído, e às vezes o arquivo fica maior. Compare Brotli e gzip em HTML, CSS, JS, SVG e JSON. Nos demais, a resposta correta do servidor é não comprimir.

Cache servindo a variante errada

Se a resposta não trouxer Vary: Accept-Encoding, qualquer cache no caminho (navegador, proxy, plugin de cache de página) pode guardar a versão Brotli e entregá-la a um cliente que pediu só gzip, ou o contrário. Por isso o grep acima procura também por vary. A presença desse cabeçalho é o que autoriza o cache a manter uma cópia por codificação. No navegador, o Ctrl+Shift+R contorna o problema no seu lado, mas não corrige o cabeçalho ausente.

Quando trocar vale e quando não vale

O critério honesto é o tamanho absoluto da economia, não o percentual.

Se o seu HTML sai em algumas dezenas de KB com gzip, o Brotli vai tirar alguns KB a mais. Em uma conexão doméstica comum, isso não é o que decide o tempo de carregamento da página; a fila de requisições, o tempo de resposta do PHP e as imagens pesam mais. Nesse cenário, desativar algo que funciona para ganhar poucos KB é risco sem retorno.

Onde o Brotli pesa de verdade é em arquivos estáticos grandes e repetitivos: o CSS do tema, os bundles de JavaScript de construtores de página, bibliotecas inteiras servidas sem minificação. Rode o mesmo par de comandos apontando para a URL de um .css ou .js do seu tema e compare. Se a diferença ali for de dezenas de KB por visita nova, o argumento muda de figura.

Um detalhe que a documentação da cPanel sobre o módulo Brotli deixa claro: trata-se de um módulo do Apache no EasyApache 4, instalado no nível do servidor. Em hospedagem compartilhada, quem decide isso é o provedor, não o painel do seu site. Antes de instalar plugin de otimização prometendo Brotli, teste com os comandos acima: se o Content-Encoding já volta br, o plugin não tem nada a acrescentar nesse ponto.

Checklist antes de mexer em qualquer coisa

  1. Confirme que o site responde em HTTPS, senão o navegador nunca pedirá Brotli.
  2. Rode o par de curl e anote os dois tamanhos em bytes. Essa é a linha de base.
  3. Repita em um CSS ou JS grande do tema, não só no HTML.
  4. Verifique se Vary: Accept-Encoding aparece na resposta.
  5. Se houver CDN, teste também fora dele antes de concluir qualquer coisa sobre o servidor.
  6. Se for alterar configuração de compressão por .htaccess ou por plugin, faça backup do arquivo e do site antes. Para voltar atrás, basta restaurar o .htaccess anterior ou desativar o plugin pelo painel do WordPress.
  7. Depois de qualquer mudança, rode os mesmos comandos de novo e compare com o tamanho em bytes que você anotou no par de curl.

Sem o tamanho anotado antes da mudança, qualquer alteração vira fé. Com ele, você tem dois números do seu próprio site e sabe exatamente o que mudou.

Referências

  1. Documentação oficial (cpanel) — Apache Module: Brotli. Consultado em 2026-09-15.
Leia também