WordPress

Déployer WordPress Bedrock en production et préparer le retour arrière

Othmane Ibn Dahou Idrissi ·

Trois responsabilités d’un déploiement Bedrock : release du code, configuration et données persistantes.

Un projet Bedrock fonctionne sur le poste de développement, mais le déploiement échoue : mauvaise racine web, variables absentes, médias perdus après une nouvelle livraison ou site toujours exclu de l’indexation. Ces problèmes viennent souvent d’une confusion entre le code versionné, la configuration de l’environnement et les données qui doivent survivre aux déploiements.

Bedrock organise WordPress autour de Composer et d’une structure de projet explicite. Il ne remplace ni WordPress ni l’administration de l’hébergement. Ce guide décrit une préparation de production et un retour arrière pour un hébergement PHP compatible. Les chemins et domaines sont des exemples ; aucun accès de production réel n’est inclus.

Vérifier l’hébergement avant de préparer les commandes

Contrôlez la version PHP requise par votre projet, les extensions nécessaires, l’accès à la base et la possibilité de définir le document root. Vérifiez aussi comment les dépendances seront installées : directement sur l’hôte ou dans une étape de construction qui produit un artefact. Une offre commerciale ne garantit pas à elle seule toutes ces capacités.

Dans l’organisation Bedrock standard, la racine publique est le dossier web. Le dépôt contient également des fichiers qui ne doivent pas être servis publiquement. La documentation de la structure Bedrock distingue ces emplacements. Si votre hébergeur impose un dossier public fixe, préparez une configuration compatible et testez l’exposition des fichiers sensibles avant le lancement.

Ne compensez pas une contrainte inconnue en copiant tout le dépôt dans le répertoire public. Une réponse 403 ponctuelle ne suffit pas à prouver que tous les fichiers de configuration resteront protégés après une mise à jour du serveur.

Séparer code, configuration et données persistantes

Le code comprend le thème, les extensions gérées par le projet, les mu-plugins et les fichiers Composer. La configuration contient les URL, les identifiants de base et les secrets. Les données persistantes comprennent la base WordPress et les médias téléversés. Ces trois ensembles n’ont pas le même cycle de vie.

release/                  code livré
  composer.json
  composer.lock
  vendor/
  config/
  web/                    racine HTTP
    app/uploads -> emplacement persistant

Configuration secrète     propre à l'environnement
Base de données           sauvegardée séparément

Les médias ne doivent pas disparaître lorsqu’une release est remplacée. Selon l’hébergement, un lien symbolique ou un montage vers un répertoire partagé peut convenir. Vérifiez sa disponibilité et ses permissions. Si les médias sont externalisés, testez également les URL, l’accès et la restauration avec ce fournisseur.

Le fichier composer.lock doit accompagner le code pour reproduire les versions résolues. Les changements de dépendances se préparent et se testent en amont ; la production ne doit pas décider implicitement de nouvelles versions au moment d’une livraison.

Configurer les URL et l’environnement explicitement

Voici un extrait de configuration illustratif pour une installation standard. Les identifiants et les clés de sécurité doivent être fournis séparément par un mécanisme de secrets adapté à l’hôte. Ne copiez pas des valeurs de démonstration dans un site réel.

WP_ENV=production
WP_HOME=https://www.exemple.fr
WP_SITEURL=https://www.exemple.fr/wp
DB_NAME=nom_de_base
DB_USER=utilisateur_application
DB_HOST=127.0.0.1

WP_HOME désigne l’adresse publique ; WP_SITEURL correspond à l’installation WordPress dans l’organisation standard. La référence des variables Bedrock décrit les variables attendues et les alternatives de connexion. Définissez le mot de passe et les clés de sécurité sans les committer ni les afficher dans les journaux de déploiement.

Relisez également les fichiers sous config/environments. Une valeur locale ou une règle de staging peut changer le comportement effectif. L’existence d’un fichier .env ne prouve pas que chaque variable est lue comme prévu. Vérifiez l’environnement réellement chargé avec une méthode qui n’expose pas les secrets.

Le mode de production mérite un contrôle SEO spécifique : le mécanisme Bedrock qui décourage l’indexation hors production peut laisser le site non indexable si l’environnement est mal défini. La documentation de déploiement Roots signale ce point. Il faut ensuite vérifier le HTML et les réglages WordPress, plutôt que se fier au nom de la variable.

Construire une release reproductible

Installez les dépendances depuis le lockfile avec une commande adaptée à la production. Exécutez-la dans un environnement dont PHP et les extensions correspondent à la cible. Les scripts Composer du projet doivent être connus et revus, puisqu’ils peuvent effectuer des actions pendant l’installation. La référence des commandes Composer précise les options d’installation et la vérification de la plateforme.

composer install --no-dev --prefer-dist --optimize-autoloader
composer check-platform-reqs --no-dev

Ces commandes ne constituent pas à elles seules un déploiement. Il reste à construire les ressources du thème si celui-ci possède une chaîne de build, à transférer la release et à appliquer la configuration. Bedrock n’impose pas que chaque thème utilise Node, ni qu’un thème Sage soit présent.

Un artefact construit en amont peut réduire les différences entre les serveurs, mais ne dispense pas du contrôle de compatibilité PHP. Évitez également de livrer des caches contenant des chemins absolus propres au poste de développement. Testez l’artefact comme il sera réellement servi.

Préparer la bascule et le retour arrière

Lorsque l’infrastructure le permet, une organisation par releases rend la bascule du code plus simple. Préparez la nouvelle release dans un autre dossier, vérifiez ses dépendances et reliez les données persistantes. Basculez ensuite le pointeur public de manière atomique selon les possibilités de l’hôte.

Le retour au code précédent ne remet pas automatiquement la base dans son ancien état. Une extension peut avoir modifié son schéma ou ses options pendant l’activation. Avant la livraison, identifiez ces changements et vérifiez si l’ancienne version reste compatible. Sans cette information, le bouton « rollback » donne une fausse impression de sécurité.

Sauvegardez la base et les médias selon une politique définie, puis testez la restauration sur un environnement isolé. Une archive créée sans erreur n’est pas encore une preuve de restauration possible. Mesurez le temps nécessaire et documentez qui décide de restaurer, surtout si de nouvelles données ont été créées depuis la sauvegarde.

Contrôler le site après la livraison

Vérifiez d’abord les parcours essentiels : accueil, article, recherche éventuelle, connexion administrative, téléversement et formulaire. Testez un média récent et un ancien média. Les permissions correctes pour lire les fichiers ne garantissent pas que WordPress puisse enregistrer un nouvel envoi.

Contrôlez ensuite les URL et les réponses HTTP. Une canonical doit utiliser le domaine final, les ressources doivent être en HTTPS et les anciennes URL doivent suivre la stratégie prévue. Une boucle de redirection entre le proxy et WordPress peut venir d’une mauvaise interprétation du protocole d’origine ; inspectez la configuration du proxy de confiance avant de modifier des règles au hasard.

Enfin, observez les erreurs PHP et les journaux applicatifs sans rendre leur détail public. Définissez une alerte utile sur les échecs répétés et un responsable de la maintenance. Le guide sur la sécurité et la maintenance WordPress complète ces opérations quotidiennes.

Un document de livraison réellement exploitable

Conservez la version du code, l’identifiant de l’artefact, la version PHP, la date de sauvegarde et le résultat des vérifications. N’y mettez pas de mots de passe. Ajoutez le chemin de la procédure de restauration et les conditions qui imposent un retour arrière.

Cette trace permet à une autre personne de comprendre ce qui a changé sans relire tout l’historique de discussion. Elle aide aussi à distinguer un incident introduit par la release d’un problème de service externe. Pour une migration vers une façade différente, utilisez en complément le guide WordPress vers Next.js et redirections SEO.

Questions fréquentes

Bedrock rend-il WordPress sécurisé automatiquement ?

Non. Il apporte une organisation et des conventions utiles, mais les comptes, les extensions, les permissions, les sauvegardes et les mises à jour restent à gérer. Une structure propre n’annule pas une dépendance vulnérable ou un secret publié.

Peut-on déployer sans accès SSH ?

Cela dépend des capacités de l’offre. Un artefact complet peut être préparé ailleurs, mais il faut encore servir la bonne racine, fournir la configuration et gérer les données persistantes. Validez ces points avant de promettre une procédure compatible.

Faut-il passer en headless pour moderniser le projet ?

Pas nécessairement. Bedrock et un thème classique peuvent répondre à de nombreux besoins. Le comparatif WordPress headless ou thème classique aide à examiner l’autre option. Mon parcours présente le contexte professionnel des technologies abordées ici.

WordPressBedrockPHPDéploiement