Comprendre le fichier .maintenance utilisé par WordPress pendant certaines mises à jour.
Étapes à suivre
-
1
Sauvegarder le site
Effectuez une sauvegarde avant toute modification manuelle.
-
2
Accéder à la racine WordPress
Utilisez FTP/SFTP ou le gestionnaire de fichiers de l’hébergeur.
-
3
Créer le fichier .maintenance avec prudence
WordPress utilise ce fichier pour afficher temporairement un message de maintenance.
-
4
Supprimer le fichier après intervention
Ne laissez pas le site bloqué en maintenance.
-
5
Contrôler le site public et l’administration
Vérifiez les deux interfaces.
À retenir
- Pour une page de maintenance personnalisée, une solution dédiée peut être préférable.
- Si WordPress reste bloqué après une mise à jour, recherchez un fichier .maintenance resté présent.
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.