Désactiver rapidement une extension qui provoque une erreur fatale lorsque l’administration WordPress n’est plus accessible.
Étapes à suivre
-
1
Créer une sauvegarde
Sauvegardez les fichiers et la base si possible.
-
2
Accéder aux fichiers du site
Connectez-vous en FTP/SFTP ou via le gestionnaire de fichiers.
-
3
Ouvrir wp-content/plugins
Repérez le dossier de l’extension suspecte.
-
4
Renommer le dossier du plugin
Ajoutez par exemple -disabled au nom du dossier.
-
5
Retester WordPress
Si le site revient, analysez ensuite la compatibilité et les journaux.
À retenir
- Ne supprimez pas immédiatement l’extension : le renommage facilite le retour arrière.
- Activez WP_DEBUG uniquement de manière contrôlée et évitez d’exposer publiquement des logs sensibles.
WordPress : enrichir le diagnostic sans masquer la cause
Repères techniques
- WP_DEBUG_LOG écrit généralement dans wp-content/debug.log seulement si WP_DEBUG est activé et si le processus PHP peut écrire le fichier.
- Renommer le dossier d’un plugin désactive son chargement sans modifier la base, ce qui est utile quand wp-admin est inaccessible.
- WP_MEMORY_LIMIT ne peut pas dépasser les limites réellement accordées par PHP/hébergeur ; une erreur mémoire exige de lire memory_limit et le pic.
Récupération contrôlée
Isoler le plugin ou la couche fautive, garder les logs, puis réactiver un composant à la fois.
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);Pièges spécifiques
Comment valider
- Le site charge avec les logs propres et le composant fautif est identifié, pas seulement désactivé.
- Les constantes de debug temporaires sont retirées ou adaptées après l’intervention.
Preuves et vérifications
WP_DEBUG_LOG écrit généralement dans wp-content/debug.log seulement si WP_DEBUG est activé et si le processus PHP peut écrire le fichier. Renommer le dossier d’un plugin désactive son chargement sans modifier la base, ce qui est utile quand wp-admin est inaccessible.
Contrôle de résultat
Le site charge avec les logs propres et le composant fautif est identifié, pas seulement désactivé. Les constantes de debug temporaires sont retirées ou adaptées après l’intervention.
Point d’attention
Supprimer .maintenance, un plugin ou le cache sans noter l’état initial peut faire disparaître le symptôme sans expliquer la cause. WP_MEMORY_LIMIT ne peut pas dépasser les limites réellement accordées par PHP/hébergeur ; une erreur mémoire exige de lire memory_limit et le pic.
Concepts liés
Référence primaire : WordPress Developer Resources — Debugging.