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

Menu de la documentation

Dépannage

Commencez par wp cachepilot test, qui indique si Redis et le cache d’objets fonctionnent. Plus bas, chaque message est présenté avec sa signification et sa solution.

No Redis server found automatically, waiting for connection details

Aucun emplacement de l’ordre de recherche n’a répondu. Saisissez l’hôte, le port et le mot de passe dans le formulaire de l’Overview, ou définissez les constantes WP_REDIS_* dans wp-config.php.

Overview de CachePilot avec le titre « Connect Redis » et un formulaire pour l'hôte, le port et le mot de passe

Le formulaire répond No Redis server answered at this address. lorsque l’hôte ou le port sont incorrects ou qu’un pare-feu les bloque, et Redis rejected the password. lorsque Redis refuse le mot de passe.

The PHP extension phpredis is missing

Sans phpredis, CachePilot reste inactif. Vérifiez-le en ligne de commande :

php -m | grep -i redis

Si rien n’est listé, demandez à votre hébergeur d’activer l’extension pour la version de PHP de votre site.

Redis answered, but the object cache drop-in could not be written to wp-content.

PHP n’a peut-être pas le droit d’écrire dans wp-content. Corrigez les droits d’accès, puis exécutez :

wp cachepilot dropin install

The configuration folder is not writable

PHP n’a peut-être pas le droit d’écrire dans wp-content/cache/cachepilot, si bien que les réglages modifiés n’atteignent pas le cache d’objets. Corrigez les droits d’accès.

Redis is not reachable

L’Overview et wp cachepilot test signalent ce message, et wp cachepilot status se termine par Redis Connection: failed: suivi de la cause. Entre-temps, WordPress lit depuis la base de données (comportement lors d’une panne). Vérifiez que le serveur Redis fonctionne et que l’hôte, le port et TLS correspondent.

CachePilot: Third-Party Drop-in Detected

Un object-cache.php d’une autre extension se trouve dans wp-content. Le bouton Replace with CachePilot ou wp cachepilot dropin install le remplace et conserve l’ancien fichier comme copie de sauvegarde.

Une page sans X-CachePilot-Cache: HIT

Demandez la page deux fois, comme décrit dans Vérifier l’installation, puis passez en revue ces causes :

  • wp cachepilot modules list indique pagecache comme Inactive. Dans un réseau, le Page Cache s’active à la main.
  • La requête contourne volontairement le cache, par exemple avec un cookie de connexion, sur le panier ou avec un paramètre d’URL inconnu (toutes les règles).

Attention : si une autre extension de Page Cache est active ou détient advanced-cache.php, CachePilot laisse son propre Page Cache désactivé (détails).

Page Cache switched off again

Cette ligne du journal provient du Safety Check, aussi pour Minify, et se termine par la cause :

  • a page answered with a server error
  • a cached page was cut off
  • a cached page was much shorter than the original
  • Un fichier minifié avec son statut HTTP, par exemple answered with HTTP 404

Le module reste désactivé tant que vous ne le réactivez pas. Corrigez la cause, puis exécutez wp cachepilot modules activate pagecache ou minify.

could not be checked because the server blocks requests to itself

Le module reste activé, sans vérification. Autorisez les requêtes de bouclage du serveur vers son propre site.

The active object cache does not support flushing groups.

Le drop-in présent dans wp-content ne propose pas de vidage par groupe, en général parce qu’il appartient à une autre extension. Dans wp cachepilot status, la ligne CachePilot Drop-in doit indiquer Yes.

Autres cas

La mémoire de Redis est pleine

L’Overview affiche cet avertissement après l’autotest horaire. Demandez à votre hébergeur d’augmenter maxmemory ou de définir maxmemory-policy sur allkeys-lru.

Des commentaires de débogage apparaissent dans mon HTML

Le module Debug ajoute des chiffres du cache sous forme de commentaires HTML. Désactivez-le sous CachePilot, Modules.

Une page affiche un ancien prix

Une modification de prix via WordPress ou WooCommerce vide une fois l’ensemble du Page Cache. Pour les modifications faites en dehors de WordPress, exécutez wp cachepilot flush --group=pagecache.

Les testeurs de la bêta envoient les cas non résolus, avec la sortie de wp cachepilot status, par le formulaire de retours de leur compte.