Contexte
Suite à l’activation d’un nouveau plugin, le site WordPress est devenu inaccessible, affichant soit une page blanche, soit une erreur serveur 500. L’administration était également impactée. Ce type d’incident est fréquent et doit être traité rapidement pour limiter l’impact business.
Symptômes observés
- Page blanche sans message visible (front-office et admin).
- Erreur 500 Internal Server Error selon le navigateur.
- Accès FTP encore fonctionnel, mais back-office indisponible.
- Problème survenu immédiatement après l’activation d’un plugin.
Objectifs du dépannage
- Rétablir l’accès au site sans restauration complète.
- Identifier précisément la cause de l’erreur 500.
- Éviter toute perte de données ou de contenus.
- Sécuriser le site avant remise en production.
Diagnostic (méthode)
- Consultation des logs serveur (Apache / Nginx).
- Activation temporaire du mode debug WordPress.
- Désactivation ciblée des plugins via WP-CLI.
- Vérification de la mémoire PHP disponible.
Cause identifiée
Un plugin récemment activé utilisait une fonctionnalité PHP incompatible avec la version PHP de l’hébergement, provoquant une fatal error. Le problème était accentué par une limite mémoire PHP trop basse.
Correctifs appliqués
1) Désactivation du plugin en cause
- Désactivation via WP-CLI sans passer par l’admin.
- Confirmation immédiate du retour du site.
2) Ajustement de la mémoire PHP
- Augmentation de la limite mémoire WordPress.
- Vérification de la cohérence avec la configuration serveur.
3) Mise à niveau contrôlée
- Vérification de la compatibilité PHP du plugin.
- Test sur environnement de staging avant réactivation.
Exemple technique : activer le debug WordPress
Permet d’afficher les erreurs fatales lors du diagnostic.
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Exemple technique : désactiver un plugin via WP-CLI
Indispensable quand l’admin est inaccessible.
wp plugin deactivate nom-du-plugin
Exemple technique : augmenter la mémoire PHP WordPress
À adapter selon l’hébergement.
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '256M');
Résultats
- Site remis en ligne en moins d’une heure.
- Aucune perte de contenu ou de configuration.
- Plugin remplacé par une alternative compatible.
- Stabilité confirmée après surveillance.
Prévention mise en place
- Tests systématiques sur staging avant activation en production.
- Surveillance des logs serveur après mises à jour.
- Documentation des versions PHP et plugins compatibles.
Points clés à retenir
- L’erreur 500 est souvent liée à un plugin ou à PHP.
- WP-CLI permet de dépanner sans accès à l’admin.
- Une mémoire PHP suffisante évite de nombreux écrans blancs.