Mode maintenance WordPress : activer, quitter

Vous lancez la mise à jour d'une extension, l'onglet se ferme ou la connexion coupe, et votre site affiche « Indisponible momentanément pour cause de maintenance programmée. Revenez dans une minute. » Une minute plus tard, le message est toujours là. Une heure plus tard aussi, et vos visiteurs, eux, ne voient plus rien d'autre.

Ce message n'est pas une panne mystérieuse : c'est le mode maintenance de WordPress, qui s'active tout seul pendant les mises à jour et qu'on peut aussi déclencher volontairement avant des travaux. Voici comment il fonctionne, comment l'activer proprement, et comment en sortir quand il reste coincé.

Ce que fait le mode maintenance natif

Pendant la mise à jour du cœur de WordPress, d'un thème ou d'une extension, WordPress crée un fichier caché nommé .maintenance à la racine du site, à côté de wp-config.php. Tant qu'il est là, les visiteurs reçoivent la page de maintenance et un code HTTP 503, qui signale une indisponibilité temporaire. Une fois la mise à jour terminée, WordPress supprime le fichier.

Ce fichier contient une valeur, $upgrading, qui marque l'heure de sa création. D'après le code de WordPress, le mode n'est actif que si cette heure date de moins de 10 minutes : au-delà, WordPress considère la maintenance comme terminée. Ce mécanisme sert donc aux mises à jour, pas aux travaux longs. Il bloque aussi le site entier, administration comprise : pendant qu'il est actif, vous ne pouvez pas revenir par le tableau de bord.

Activer le mode maintenance avec une extension

C'est la méthode la plus simple pour des travaux planifiés, parce qu'elle se règle et s'annule depuis le tableau de bord.

1. Faites une sauvegarde avant de toucher au site. Voir comment sauvegarder son site WordPress correctement.
2. Installez et activez une extension de mode maintenance depuis Extensions, puis Ajouter.
3. Rédigez le message. Dites ce qui se passe, quand vous serez de retour et comment vous joindre : le contenu d'une bonne page est détaillé dans faire une page de maintenance propre.
4. Activez le mode, puis testez. Ouvrez le site en navigation privée : vous devez voir la page de maintenance, alors que vous, connecté, accédez encore au site.
5. Effectuez vos travaux, désactivez le mode et videz le cache pour que les visiteurs retrouvent le vrai site.

Activer le mode maintenance sans extension

Sans extension, on peut recréer ce que fait WordPress lui-même : déposer à la racine un fichier .maintenance qui contient <?php $upgrading = time(); ?>. Comme l'heure est recalculée à chaque requête, le mode reste actif tant que le fichier existe. Attention : un fichier vide n'active rien, car sans valeur $upgrading WordPress ne trouve pas d'heure de départ. Pour remplacer le message par défaut, WordPress accepte aussi un fichier maintenance.php déposé dans le dossier wp-content.

Cette méthode convient à un développeur à l'aise avec le FTP. Pour supprimer le mode, il suffit de supprimer le fichier. Si vous n'avez aucun accès aux fichiers de votre hébergement, restez sur l'extension : vous ne pourriez pas annuler le blocage.

Site bloqué en maintenance : les gestes, dans l'ordre

1. Patientez quelques minutes. Une mise à jour du cœur ou de plusieurs extensions peut prendre du temps. Relancer dix mises à jour d'affilée n'arrange rien.
2. Videz les caches. Le navigateur, l'extension de cache de page et, s'il y en a un, le réseau de diffusion peuvent continuer à servir la page de maintenance alors que le site fonctionne.
3. Supprimez le fichier .maintenance. Connectez-vous en FTP ou depuis le gestionnaire de fichiers de votre hébergeur, allez à la racine du site (là où se trouve wp-config.php) et supprimez-le. Un fichier dont le nom commence par un point est masqué par défaut : activez l'affichage des fichiers cachés si vous ne le voyez pas.
4. Vérifiez la mise à jour interrompue. Retirer le message ne prouve pas que la mise à jour s'est terminée. Rendez-vous dans Tableau de bord, puis Mises à jour, et relancez ce qui n'a pas abouti, en suivant la méthode de mise à jour sans rien casser.
5. Si une erreur apparaît ensuite (page blanche, erreur critique), traitez-la pour elle-même : voir écran blanc WordPress et erreur critique WordPress.

Combien de temps un site peut-il rester en maintenance ?

Le code 503 protège vos pages : il indique aux moteurs de recherche que la situation est temporaire et qu'ils ne doivent pas indexer le message d'attente. Google précise toutefois qu'il réessaie d'accéder à des pages en 503 pendant une semaine au plus avant de les traiter comme une erreur permanente, et qu'elles risquent alors de disparaître des résultats. Une maintenance se compte donc en minutes ou en heures, pas en semaines. Vérifiez que votre page renvoie bien un 503 et non un code 200 : la marche à suivre est dans l'article sur la page de maintenance.

Éviter d'y revenir

Mettez à jour en dehors des heures de forte visite, une extension à la fois plutôt qu'en lot, et après une sauvegarde. Pour les changements importants, testez d'abord sur une copie de test. Si vous laissez WordPress se mettre à jour seul, comprenez ce qu'il fait dans le guide des mises à jour automatiques.