Guia Nginx FastCGI Cache: Configuração Avançada para Alta Performance

# Define o local do cache e a zona de memória
# /var/cache/nginx/fastcgi_temp: pasta onde os arquivos ficarão (crie-a se não existir)
# levels=1:2: estrutura de subpastas para não sobrecarregar o sistema de arquivos
# keys_zone=meu_cache:100m: nome da zona e 100MB de RAM para armazenar as CHAVES (não os arquivos)
# inactive=60m: se o arquivo não for acessado em 60m, ele é deletado
# max_size=1g: tamanho máximo total do cache em disco
fastcgi_cache_path /var/cache/nginx/fastcgi_temp levels=1:2 keys_zone=meu_cache:100m inactive=60m max_size=1g use_temp_path=off;

# Define a chave única do cache (separar http de https, e por host)
fastcgi_cache_key "$scheme$request_method$host$request_uri";

# Por padrão, vamos cachear
set $skip_cache 0;

# POST requests nunca devem ser cacheados
if ($request_method = POST) {
    set $skip_cache 1;
}

# Se houver query strings (ex: ?busca=xyz), decida se quer cachear. 
# Para segurança máxima, muitas vezes pulamos o cache, mas em picos pode ser útil cachear.
if ($query_string != "") {
    set $skip_cache 1;
}

# Não cachear URLs especiais (admin, login, wp-admin, etc)
if ($request_uri ~* "/wp-admin/|/xmlrpc.php|wp-.*.php|/feed/|index.php|sitemap(_index)?.xml") {
    set $skip_cache 1;
}

# Não cachear se o usuário tiver cookies específicos (logado, comentado, etc)
# Exemplo para WordPress:
if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_no_cache|wordpress_logged_in") {
    set $skip_cache 1;
}

location ~ \.php$ {
    try_files $uri =404;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    
    # ... configurações padrão do fastcgi_pass ...
    fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # Exemplo
    include fastcgi_params;
    
    # --- ATIVAÇÃO DO CACHE ---
    fastcgi_cache meu_cache;
    fastcgi_cache_bypass $skip_cache;
    fastcgi_no_cache $skip_cache;

    # Validade do cache: 200 (OK) e 301 (Redirect) por 60 minutos
    fastcgi_cache_valid 200 301 60m;
    
    # Cache de erros (404, 500) por tempo curto para evitar DDoS no backend
    fastcgi_cache_valid 404 500 502 503 1m;

    # --- O SEGREDO PARA PICOS DE TRÁFEGO ---
    
    # 1. Cache Lock: Impede "Cache Stampede". 
    # Se 1000 pessoas pedirem a mesma página não cacheada, o Nginx segura 999,
    # deixa passar 1 para o PHP, popula o cache e serve as outras 999.
    fastcgi_cache_lock on;
    fastcgi_cache_lock_timeout 5s;

    # 2. Use Stale: Se o PHP morrer (erro 500) ou estiver ocupado (timeout),
    # o Nginx serve a versão "velha" do cache em vez de mostrar erro.
    # "updating" permite servir cache velho enquanto um novo está sendo gerado em background.
    fastcgi_cache_use_stale error timeout invalid_header http_500 http_503 updating;
    
    # Permite atualização em background para não travar o usuário que deu azar de pegar o cache expirado
    fastcgi_cache_background_update on;

    # Header para Debug (verifique se está dando HIT ou MISS)
    add_header X-FastCGI-Cache $upstream_cache_status;
}