Configurar o LiteSpeed Cache no Drupal

O LiteSpeed dispõe de uma cache integrada com a qual o Drupal pode evitar execuções PHP repetidas para conteúdo compatível. A melhoria depende do site, do conteúdo que pode ser colocado em cache e da taxa de acertos.

O módulo LiteSpeed Cache liga as etiquetas e as purgas do Drupal a essa cache. O site deve utilizar LiteSpeed ou OpenLiteSpeed e o servidor deve ter a cache ativada; instalar o módulo não substitui este requisito.

O ramo 1.3 aqui documentado requer o Drupal 10.3 ou o Drupal 11. Verifique a versão estável e os requisitos publicados antes de a instalar: não baixe a versão do Drupal nem force o Composer para contornar um conflito.

1. Faça uma cópia de segurança

Guarde uma cópia recuperável dos ficheiros e da base de dados. Se o site tiver sessões, formulários ou conteúdo personalizado, faça primeiro a alteração num ambiente de testes.

2. Instale o módulo com o Composer

A partir do diretório raiz do projeto, execute:

composer require 'drupal/lscache:^1.3'

O Composer selecionará uma versão compatível dentro desse ramo. Para outras versões do Drupal, utilize o comando indicado na página oficial do projeto.

3. Ative o LiteSpeed Cache

Ative o LiteSpeed Cache a partir de Extend ou através do Drush:

vendor/bin/drush en lscache -y

Adicione também as diretivas necessárias ao .htaccess da raiz do Drupal:

<IfModule LiteSpeed>
    CacheLookup public on
    php_flag output_buffering off
</IfModule>

Sem ambas as diretivas, o módulo pode emitir os seus cabeçalhos sem que o LiteSpeed armazene as respostas. O relatório de estado do Drupal verifica esta configuração. As restantes opções do módulo estão em Configuration > Development > LiteSpeed Cache.

4. Verifique que funciona

Reveja o relatório de estado do Drupal, caso o módulo detete diretivas ou dados do servidor pendentes.

Depois, abra o site numa janela privada, visite duas vezes uma página pública e reveja os seus cabeçalhos de resposta nas ferramentas de programador do navegador. Um pedido posterior a uma página pública compatível pode mostrar um cabeçalho do LiteSpeed com o estado hit; o primeiro pode aparecer como miss enquanto a cache é gerada. Verifique que está a observar um pedido ao servidor e não uma cópia em memória do navegador.

Se aparecer sempre miss, verifique se a página depende de uma sessão, de um cookie ou de conteúdo personalizado. Confirme também que não há outra cache de página a interferir.

Não ative a cache pública para páginas com dados privados ou específicos de cada utilizador sem verificar antes o comportamento das sessões.

Testar a invalidação e desativar

Edite um conteúdo de teste e verifique que a alteração aparece nas páginas relacionadas. Teste a pesquisa, os formulários, o início e o fim de sessão, e dois utilizadores com permissões diferentes. As etiquetas de cache devem refletir as dependências reais dos módulos personalizados.

Se precisar de o retirar, purgue a cache e desinstale o módulo com o procedimento do Drupal antes de remover o pacote do Composer. Conserve as restantes regras do .htaccess. Se o problema começou ao adicionar as diretivas, reverta essa alteração e reveja o relatório de estado e o registo de erros.