Como habilitar a compressão Gzip ou Brotli no WordPress

Quando um navegador solicita uma página do seu site WordPress, o servidor envia de volta HTML, CSS, JavaScript e outros arquivos baseados em texto. Sem compressão, esses arquivos são transmitidos em seu tamanho total. Habilitar a compressão pode reduzir o tamanho desses arquivos em 70-90%, o que se traduz diretamente em carregamentos de página mais rápidos e custos de banda menores.

Como a compressão funciona nos bastidores

A compressão depende de uma negociação entre o navegador e o servidor. Quando o navegador envia uma requisição, ele inclui um cabeçalho Accept-Encoding que lista os algoritmos de compressão suportados, tipicamente gzip, deflate, br. O servidor verifica esse cabeçalho, comprime a resposta usando o melhor algoritmo disponível e envia de volta com um cabeçalho Content-Encoding indicando qual método foi usado. O navegador então descomprime o conteúdo antes de renderizá-lo. Todo esse processo é transparente para o usuário final.

Há dois algoritmos principais de compressão que você encontrará:

• Gzip: O padrão da indústria há mais de duas décadas. Suportado por todos os navegadores e servidores web. Taxas de compressão de 70-80% são típicas para arquivos baseados em texto.
• Brotli: Desenvolvido pelo Google e lançado em 2015. Oferece taxas de compressão 15-25% melhores que o Gzip com uso de CPU semelhante. Suportado por todos os navegadores modernos. Funciona apenas em conexões HTTPS.

Quais tipos de arquivo devem ser comprimidos

A compressão funciona melhor em conteúdo baseado em texto e repetitivo. Você deve habilitá-la para os seguintes tipos MIME:

• Arquivos de texto: text/html, text/css, text/javascript, text/xml, text/plain
• Arquivos de aplicação: application/javascript, application/json, application/xml, application/rss+xml, application/atom+xml
• Fontes e SVGs: image/svg+xml, font/ttf, font/otf (fontes WOFF e WOFF2 já são comprimidas)

Não comprima arquivos binários como JPEG, PNG, WebP, GIF, MP4 ou PDF. Esses formatos já usam seus próprios algoritmos de compressão, e recomprimi-los desperdiça CPU sem reduzir o tamanho do arquivo.

Economia de tamanho esperada

Para dar uma ideia concreta do que a compressão alcança, aqui estão alguns exemplos do mundo real:

• Uma página HTML típica do WordPress (80 KB): Comprime para cerca de 15-20 KB com Gzip, ou 12-16 KB com Brotli.
• Biblioteca jQuery (90 KB minificada): Comprime para cerca de 30 KB com Gzip, ou 25 KB com Brotli.
• Bootstrap CSS (160 KB): Comprime para cerca de 25 KB com Gzip, ou 20 KB com Brotli.
• Uma resposta grande de API JSON (500 KB): Comprime para cerca de 50-80 KB com Gzip.

Em todo um site WordPress, habilitar a compressão tipicamente reduz o tamanho total de transferência em 60-80%.

Apache: habilitar Gzip com mod_deflate

Se seu site WordPress roda em Apache (caso da maioria dos provedores de hospedagem compartilhada), adicione o seguinte ao seu arquivo .htaccess. Coloque-o antes das regras de rewrite do WordPress:

<IfModule mod_deflate.c>
    # Compress HTML, CSS, JavaScript, Text, XML and fonts
    AddOutputFilterByType DEFLATE text/html
    AddOutputFilterByType DEFLATE text/css
    AddOutputFilterByType DEFLATE text/javascript
    AddOutputFilterByType DEFLATE text/xml
    AddOutputFilterByType DEFLATE text/plain
    AddOutputFilterByType DEFLATE application/javascript
    AddOutputFilterByType DEFLATE application/x-javascript
    AddOutputFilterByType DEFLATE application/json
    AddOutputFilterByType DEFLATE application/xml
    AddOutputFilterByType DEFLATE application/rss+xml
    AddOutputFilterByType DEFLATE application/atom+xml
    AddOutputFilterByType DEFLATE image/svg+xml
    AddOutputFilterByType DEFLATE font/ttf
    AddOutputFilterByType DEFLATE font/otf
    AddOutputFilterByType DEFLATE font/woff

    # Remove browser bugs for older browsers
    BrowserMatch ^Mozilla/4 gzip-only-text/html
    BrowserMatch ^Mozilla/4\.0[678] no-gzip
    BrowserMatch \bMSIE !no-gzip !gzip-only-text/html

    # Make sure proxies deliver the correct content
    Header append Vary Accept-Encoding
</IfModule>

O wrapper IfModule garante que essa configuração seja aplicada apenas se o mod_deflate estiver instalado. Na maioria dos provedores de hospedagem, ele já vem habilitado por padrão. Se você receber um erro 500 Internal Server Error após adicionar esse código, entre em contato com seu provedor para confirmar que o mod_deflate está disponível.

Nginx: habilitar a compressão Gzip

Se seu servidor roda Nginx, adicione as diretivas a seguir ao seu bloco server ou ao bloco http em seu arquivo nginx.conf:

gzip on;
gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_min_length 256;
gzip_types
    text/plain
    text/css
    text/xml
    text/javascript
    application/json
    application/javascript
    application/x-javascript
    application/xml
    application/xml+rss
    application/atom+xml
    image/svg+xml
    font/ttf
    font/otf;

Algumas observações sobre essas configurações: gzip_comp_level 6 oferece um bom equilíbrio entre taxa de compressão e uso de CPU. Níveis acima de 6 oferecem retornos decrescentes enquanto aumentam significativamente a carga de CPU. A diretiva gzip_min_length 256 impede a compressão de arquivos muito pequenos, em que a sobrecarga da compressão supera a economia. A diretiva gzip_vary on diz aos proxies de cache para armazenar versões separadas de conteúdo comprimido e não comprimido.

Nginx: habilitar a compressão Brotli

O Brotli não está incluído no pacote padrão do Nginx. Você precisa instalar o módulo ngx_brotli separadamente, ou usar uma distribuição que o inclua (muitas distribuições Linux modernas o oferecem como pacote opcional). Uma vez instalado, adicione isso à sua configuração do Nginx:

brotli on;
brotli_comp_level 6;
brotli_min_length 256;
brotli_types
    text/plain
    text/css
    text/xml
    text/javascript
    application/json
    application/javascript
    application/x-javascript
    application/xml
    application/xml+rss
    application/atom+xml
    image/svg+xml
    font/ttf
    font/otf;

Você pode rodar Gzip e Brotli ao mesmo tempo. O Nginx servirá Brotli para navegadores que o suportam e fará fallback para Gzip para os demais. Essa é a configuração recomendada para máxima compatibilidade.

Plugins WordPress que cuidam da compressão

Se você não tem acesso a arquivos de configuração do servidor (comum em hospedagem compartilhada), vários plugins de cache do WordPress podem habilitar a compressão para você:

• WP Rocket: Adiciona automaticamente regras de compressão Gzip ao seu arquivo .htaccess na ativação. Nenhuma configuração adicional necessária. Esse é um plugin premium.
• LiteSpeed Cache: Se seu host usa o servidor web LiteSpeed, esse plugin habilita a compressão no nível do servidor, o que é mais eficiente que o mod_deflate do Apache. Gratuito e disponível no diretório de plugins do WordPress.
• W3 Total Cache: Oferece compressão Gzip como parte de suas configurações de Browser Cache. Habilite-o em Performance > Browser Cache > HTTP compression. Gratuito, mas tem uma curva de aprendizado mais íngreme.
• WP Super Cache: Inclui uma opção "Compress pages" que serve arquivos estáticos pré-comprimidos. Mais simples que o W3 Total Cache, mas com menos opções.

Tenha em mente que se seu provedor de hospedagem já habilita a compressão no nível do servidor, adicioná-la novamente por meio de um plugin não terá efeito adicional. Verifique antes de fazer alterações.

Como testar se a compressão está funcionando

Após habilitar a compressão, você deve verificar se ela está realmente sendo aplicada. Aqui estão vários métodos:

• DevTools do navegador: Abra seu site, pressione F12 para abrir o DevTools, vá para a aba Rede e recarregue a página. Clique em qualquer requisição HTML, CSS ou JS e olhe os cabeçalhos de resposta. Você deve ver Content-Encoding: gzip ou Content-Encoding: br. Você também pode comparar a coluna "Size" (tamanho de transferência comprimido) com a coluna "Content" ou "Resource" (tamanho real descomprimido).
• Ferramentas online: Sites como GTmetrix, Google PageSpeed Insights e o verificador de compressão da KeyCDN podem verificar se seu site serve conteúdo comprimido. Eles sinalizarão recursos não comprimidos, se houver.
• Linha de comando: Se você tem acesso a um terminal, pode usar curl -H "Accept-Encoding: gzip" -I https://seusite.com para ver os cabeçalhos de resposta. Procure pelo cabeçalho Content-Encoding na saída.
• Varredura do InspectWP: Execute uma nova varredura do InspectWP após habilitar a compressão. A seção de desempenho exibirá o valor de Content-Encoding. Deve mostrar gzip ou br (Brotli) em vez de estar vazio ou ausente.

Solução de problemas comuns

Se a compressão não parece funcionar após as alterações, verifique o seguinte:

• Override de CDN: Se você usa um CDN como o Cloudflare, o CDN pode lidar com a compressão independentemente das configurações do seu servidor. O Cloudflare habilita Gzip por padrão e oferece Brotli como um interruptor nas configurações de Speed.
• Módulo do servidor não carregado: No Apache, o mod_deflate deve estar habilitado. Entre em contato com seu provedor de hospedagem se não tiver certeza. No Nginx, o módulo Brotli requer instalação separada.
• Regras conflitantes: Vários plugins ou regras .htaccess tentando definir a compressão podem entrar em conflito. Verifique se há blocos mod_deflate duplicados em seu arquivo .htaccess.
• Camada de proxy ou cache: Proxies reversos como o Varnish podem remover ou modificar cabeçalhos de compressão. Certifique-se de que cada camada da sua stack está configurada corretamente.