Dépannage des problèmes de mise en cache de Jetpack Boost
Si vous recevez une erreur indiquant que le cache ne fonctionne pas comme prévu, il est essentiel d’identifier le problème précis à partir du message d’erreur. Vous trouverez ci-dessous des instructions détaillées pour diagnostiquer et résoudre ces problèmes courants de mise en cache, afin de garantir que la mise en cache de votre site est optimisée et fonctionnelle.
Problèmes d’accès aux fichiers
Problème : Le cache de page de Jetpack Boost doit mettre à jour certains répertoires et fichiers dans votre répertoire wp-content pour fonctionner correctement. Ces emplacements essentiels sont les suivants :
wp-content: Le répertoire de contenu principal de votre installation WordPress, dans lequel Jetpack Boost tente de créer un sous-répertoire boost-cache.wp-content/boost-cache/: Contient la configuration du cache de pages et le contenu mis en cache de Jetpack Boost, qui doivent être accessibles en écriture.wp-content/boost-cache/config.php: Contient la configuration du cache de pages et doit être accessible en écriture.wp-content/advanced-cache.php: Permet de servir le contenu mis en cache avant le chargement complet de WordPress et doit être accessible en écriture.
Solution : Vérifiez et ajustez les autorisations de ces fichiers et répertoires afin qu’ils soient accessibles en écriture par WordPress. Utilisez FTP/SFTP pour définir les autorisations des fichiers sur CHMOD 644 ou 666, et celles des répertoires sur 755 ou 775. Cela permet à Jetpack Boost de mettre efficacement en cache le contenu de votre site.
Réglages de permaliens incompatibles
Problème : La mise en cache de Jetpack Boost ne prend pas en charge le réglage « Permaliens simples », car elle repose sur des URL uniques pour mettre efficacement en cache et récupérer le contenu.
Solution : Modifiez vos permaliens pour utiliser une structure plus lisible en accédant à Réglages → Permaliens dans votre administration WP. Sélectionnez une option autre que « Simple », puis enregistrez vos modifications.
Incompatibilité avec un cache avancé
Problème : Les conflits avec un système de mise en cache existant, installé par une autre extension ou par votre hébergeur, peuvent empêcher la mise en cache de Jetpack Boost.
Solution :
- Désactivez toute extension de mise en cache incompatible dans la section Extensions de WP Admin si vous souhaitez utiliser la mise en cache des pages de Jetpack Boost à la place.
- Si Boost affiche La mise en cache des pages est active, votre hébergeur gère déjà la mise en cache des pages et aucune action n’est nécessaire.
- Si Boost signale un autre conflit de mise en cache lié à votre hébergeur, contactez votre hébergeur avant de modifier ou de supprimer des fichiers liés au cache tels que
advanced-cache.php.
Si vous rencontrez des problèmes de mise en page plutôt que des erreurs de mise en cache, ils peuvent être dus à un conflit d’extensions affectant CSS. Consultez Conflits potentiels avec d’autres extensions de performance pour plus de détails.
Cache avancé pour WP Super Cache
Problème : Si WP Super Cache est actif, il peut entrer en conflit avec le mécanisme de mise en cache de Jetpack Boost.
Solution : Désactivez WP Super Cache dans la section Extensions de votre administration WP afin d’éliminer le conflit et d’activer une mise en cache efficace avec Jetpack Boost.
Impossible d’écrire dans advanced-cache.php
Problème: Jetpack Boost nécessite un fichier advanced-cache.php accessible en écriture pour servir efficacement le contenu mis en cache.
Solution : Ajustez les autorisations du advanced-cache.php dans le répertoire wp-content pour appliquer CHMOD 644 ou 666, afin que Jetpack Boost puisse modifier le fichier si nécessaire.
WP_CACHE est défini, mais pas sur true
Problème : La constante WP_CACHE dans wp-config.php doit être définie sur true pour que Jetpack Boost puisse utiliser les fonctionnalités de mise en cache de WordPress. Un réglage sur false empêche l’activation.
Solution : Recherchez et modifiez la définition de WP_CACHE dans wp-config.php. Remplacez sa valeur par true si elle est définie sur false, ou ajoutez define( 'WP_CACHE', true ); au-dessus de la ligne « That's all, stop editing! Happy publishing. » si elle n’est pas définie.
WP-Config n’est pas accessible en écriture
Problème : La protection en écriture de wp-config.php peut empêcher Jetpack Boost d’ajouter la ligne PHP nécessaire à l’activation de la mise en cache.
Solution : Modifiez manuellement les autorisations de wp-config.php pour le rendre accessible en écriture, ou ajoutez define( 'WP_CACHE', true ); manuellement si les autorisations sont restreintes. Vérifiez que cette ligne est placée au-dessus du commentaire « That's all, stop editing! Happy publishing. ».
En identifiant le problème précis à partir du message d’erreur et en appliquant ces solutions, vous pouvez résoudre les problèmes courants liés à la fonctionnalité de mise en cache de Jetpack Boost, améliorant ainsi les performances de votre site et l’expérience utilisateur.
Suppression manuelle du répertoire de cache de Boost
Problème : Dans certains cas, l’utilisation du bouton Vider le cache dans Jetpack Boost peut ne pas supprimer complètement les fichiers mis en cache du répertoire /wp-content/boost-cache/. Cela peut entraîner l’accumulation de fichiers inutiles, contribuant à une forte utilisation du serveur de fichiers.
Solution : Vous pouvez supprimer manuellement sans risque le répertoire /wp-content/boost-cache/ si le bouton Vider le cache ne supprime pas les fichiers comme prévu. Après avoir supprimé manuellement le dossier, Jetpack Boost régénérera les fichiers de cache nécessaires lorsqu’il sera réactivé. Vous pouvez le faire en accédant au gestionnaire de fichiers de votre site via FTP/SFTP ou le panneau de contrôle de votre hébergeur.
Réinitialisation du cache de Jetpack Boost après des conflits
Problème : Dans certains cas, la fonctionnalité de mise en cache de Jetpack Boost peut cesser de fonctionner correctement après l’activation et la désactivation de différentes extensions de mise en cache, ou après des modifications répétées de la configuration de mise en cache de votre site. Si le cache de Boost ne s’active pas alors que tout semble en place, une réinitialisation complète peut souvent résoudre le problème.
Solution : Suivez ces étapes pour réinitialiser la configuration du cache de Boost :
- Désinstallez les autres extensions de mise en cache, même si elles sont inactives. Faites-le depuis la page Extensions de l’administration WP (ne les supprimez pas manuellement via FTP). Cela permet aux extensions d’exécuter leurs routines de nettoyage.
- Dans les réglages de Boost, désactivez l’option Mise en cache des pages (si elle est actuellement activée).
- Supprimez le
/wp-content/boost-cache/dossier à l’aide de FTP, SFTP ou du gestionnaire de fichiers de votre hébergeur. - Ouvrez votre
wp-config.phpfichier et recherchez une ligne semblable àdefine( 'WP_CACHE', true );— supprimez-la ou commentez-la si elle est présente.
Après avoir terminé ces étapes :
- Activez l’option Mise en cache des pages à nouveau dans Jetpack → Boost.
- Boost recréera les fichiers nécessaires et régénérera sa configuration de cache.
Cette réinitialisation est particulièrement utile si la mise en cache a cessé de fonctionner après le passage d’une extension ou d’un hébergeur à un autre. Si vous avez des doutes concernant l’une des étapes, votre hébergeur pourra peut-être vous aider.
Obtenir de l’aide
Besoin d’aide supplémentaire ? N’hésitez pas à nous contacter ! Pour les utilisateurs de la version gratuite de Jetpack Boost, vous pouvez publier une demande d’assistance sur la Assistance de l’extension Jetpack Boost page. Si vous avez effectué la mise à niveau, vous pouvez contacter l’assistance pour bénéficier d’une assistance plus personnalisée.