La bêta de CachePilot est ouverte. Participer gratuitement à la bêta

Menu de la documentation

Premiers pas

Téléversez le ZIP, activez l’extension et vérifiez le résultat. Cette page couvre l’installation, l’ordre dans lequel CachePilot cherche Redis et les vérifications qui suivent.

Installer et activer

01

Télécharger le ZIP

Connectez-vous à votre compte et téléchargez la version actuelle. Le téléchargement exige une inscription à la bêta validée.

02

Le téléverser

Dans WordPress, ouvrez Plugins, Add New Plugin, Upload Plugin, choisissez le ZIP et installez-le.

03

L’activer

Activez CachePilot. Dans un réseau Multisite, activez-le pour le réseau.

04

Ouvrir l’Overview

Ouvrez CachePilot, Overview. La page affiche la connexion Redis et les premières entrées du journal.

Overview de CachePilot après l'activation sur un site de test : bannière « Autopilot is running with 11 modules », taux de succès 83,8 %, latence 0,29 ms, mémoire 5.82M, 93 pages en cache, la liste « What Autopilot did » et les modules actifs
L’Overview quelques minutes après l’activation sur un site de test.

Comment CachePilot trouve Redis

À l’activation, CachePilot parcourt cette liste dans l’ordre et s’arrête au premier serveur Redis qui répond. Chaque tentative attend 0,3 seconde au maximum.

  1. CACHEPILOT_HOST ou WP_REDIS_HOST dans wp-config.php, utilisés tels quels
  2. La variable d’environnement REDIS_URL
  3. Les variables d’environnement REDIS_HOST, REDIS_PORT et REDIS_PASSWORD
  4. Les sockets Unix, s’ils existent, à /var/run/redis/redis.sock, /var/run/redis/redis-server.sock, /run/redis/redis-server.sock, /run/redis/redis.sock et /tmp/redis.sock
  5. 127.0.0.1 sur le port 6379
  6. localhost sur le port 6379
  7. Le nom d’hôte redis sur le port 6379, uniquement dans un conteneur

Dès qu’un serveur répond, CachePilot installe le drop-in du cache d’objets et démarre Autopilot. Un object-cache.php d’une autre extension reste dans wp-content comme copie de sauvegarde, avec un horodatage dans son nom. Ce que fait Autopilot après l’activation fait l’objet d’une page à part.

Si aucun serveur ne répond, l’Overview affiche un formulaire pour l’hôte, le port et le mot de passe. La connexion peut aussi être définie dans wp-config.php, comme ci-dessous. La page Migrer liste toutes les constantes.

define( 'WP_REDIS_HOST', '127.0.0.1' );
define( 'WP_REDIS_PORT', 6379 );
define( 'WP_REDIS_PASSWORD', 'your-redis-password' );
define( 'WP_REDIS_DATABASE', 0 );

Vérifier l’installation

Cette commande écrit une valeur via le cache d’objets et directement dans Redis, la relit, puis la supprime :

wp cachepilot test

La dernière ligne doit être Success: Redis and the object cache work. Les autres commandes figurent dans la référence WP-CLI.

Pour vérifier le Page Cache, exécutez cette commande deux fois, sans cookie de connexion. Elle envoie des requêtes GET, car une requête HEAD lit le Page Cache sans le remplir.

curl -si https://example.com/ | grep -i x-cachepilot

Sur une page hors du cache, la première exécution n’affiche rien et enregistre la page. La seconde affiche X-CachePilot-Cache: HIT. Si cette ligne n’apparaît pas, consultez une page sans l’en-tête.

Les limites de versions et les configurations non prises en charge figurent dans les prérequis.