Configurer LiteSpeed Cache dans Drupal

LiteSpeed dispose d'un cache intégré grâce auquel Drupal peut éviter des exécutions PHP répétées pour le contenu compatible. Le gain dépend du site, du contenu pouvant être mis en cache et du taux de succès.

Le module LiteSpeed Cache relie les étiquettes et les purges de Drupal à ce cache. Le site doit utiliser LiteSpeed ou OpenLiteSpeed et le serveur doit avoir le cache activé ; installer le module ne remplace pas cette condition.

La branche 1.3 documentée ici nécessite Drupal 10.3 ou Drupal 11. Vérifiez la version stable et ses prérequis publiés avant de l'installer : ne rétrogradez pas Drupal et ne forcez pas Composer pour contourner un conflit.

1. Faites une sauvegarde

Enregistrez une sauvegarde récupérable des fichiers et de la base de données. Si le site gère des sessions, des formulaires ou du contenu personnalisé, effectuez d'abord le changement dans un environnement de test.

2. Installez le module avec Composer

Depuis le répertoire racine du projet, exécutez :

composer require 'drupal/lscache:^1.3'

Composer choisira une version compatible dans cette branche. Pour d'autres versions de Drupal, utilisez la commande indiquée sur la page officielle du projet.

3. Activez LiteSpeed Cache

Activez LiteSpeed Cache depuis Étendre (Extend) ou avec Drush :

vendor/bin/drush en lscache -y

Ajoutez aussi les directives requises au .htaccess de la racine de Drupal :

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

Sans ces deux directives, le module peut envoyer ses en-têtes sans que LiteSpeed stocke les réponses. Le rapport d'état de Drupal vérifie cette configuration. Les autres options du module se trouvent dans Configuration > Développement > LiteSpeed Cache.

4. Vérifiez que cela fonctionne

Consultez le rapport d'état de Drupal au cas où le module détecterait des directives ou des données du serveur manquantes.

Ouvrez ensuite le site dans une fenêtre privée, visitez deux fois une page publique et examinez ses en-têtes de réponse dans les outils de développement du navigateur. Une requête ultérieure sur une page publique compatible peut afficher un en-tête LiteSpeed avec l'état hit ; la première peut apparaître comme miss pendant la génération du cache. Vérifiez que vous observez bien une requête au serveur, et non une copie en mémoire du navigateur.

Si miss apparaît toujours, vérifiez si la page dépend d'une session, d'un cookie ou d'un contenu personnalisé. Confirmez aussi qu'aucun autre cache de page n'interfère.

N'activez pas de cache public pour des pages contenant des données privées ou propres à chaque utilisateur sans avoir vérifié le comportement des sessions.

Tester l'invalidation et désactiver

Modifiez un contenu de test et vérifiez que le changement apparaît sur les pages liées. Testez la recherche, les formulaires, la connexion et la déconnexion, ainsi que deux utilisateurs ayant des droits différents. Les étiquettes de cache doivent refléter les dépendances réelles des modules personnalisés.

Si vous devez le retirer, purgez le cache et désinstallez le module avec la procédure de Drupal avant de retirer le paquet Composer. Conservez les autres règles du .htaccess. Si le problème est apparu en ajoutant les directives, annulez ce changement et consultez le rapport d'état et le journal des erreurs.