Boîte à Outils Informatique
Guide

Comment récupérer WordPress après une erreur critique de plugin

Quand wp-admin est inaccessible après l’activation ou la mise à jour d’un plugin, le moyen le plus sûr est de désactiver uniquement le plugin suspect via le système de fichiers.

ThématiqueWordPress →
⌚ Environ 3 min de lecture
Voir mes favoris
WordPress Intermédiaire 15 min

Quand wp-admin est inaccessible après l’activation ou la mise à jour d’un plugin, le moyen le plus sûr est de désactiver uniquement le plugin suspect via le système de fichiers.

Avant de commencer : adaptez toujours les commandes et manipulations à votre environnement. Sur un système de production, prévoyez une sauvegarde ou un retour arrière lorsque l’action peut modifier la configuration.

Étapes à suivre

  1. 1

    Identifier le plugin

    Repérez la dernière extension activée ou mise à jour.

  2. 2

    Renommer son dossier

    Via FTP ou le gestionnaire de fichiers, renommez uniquement le dossier du plugin.

  3. 3

    Retester wp-admin

    WordPress désactivera l’extension manquante.

  4. 4

    Lire l’erreur PHP

    Consultez le journal pour identifier la fonction, classe ou version incompatible.

  5. 5

    Installer une version corrigée

    Remettez le plugin uniquement après validation.

À retenir

  • Ne renommez pas tout le dossier plugins si un seul plugin est suspect.
  • Gardez WP_DEBUG_DISPLAY désactivé en production.
  • Un lint PHP ne détecte pas toutes les erreurs qui n’apparaissent qu’à l’exécution.
← Tous les guides
Complément technique

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

  • Supprimer .maintenance, un plugin ou le cache sans noter l’état initial peut faire disparaître le symptôme sans expliquer la cause.
  • Une boucle de redirection peut venir de WordPress, du proxy/CDN, HTTPS ou d’un plugin : vérifier chaque couche séparément.

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.

♡ 0