Bedrock change la manière dont on structure un projet WordPress en remettant l’architecture au centre des préoccupations.
Il sépare clairement le cœur de WordPress des thèmes et plugins, introduit une gestion des dépendances avec Composer et favorise l’usage de variables d’environnement pour sécuriser les accès.
Pour des équipes qui gèrent plusieurs environnements, Bedrock apporte des routines et des conventions qui réduisent les erreurs et accélèrent les déploiements.
Qu’est-ce que bedrock
Bedrock est un squelette de projet pensé pour professionnaliser le développement WordPress. Il réorganise les répertoires, centralise la configuration et traite WordPress comme une dépendance, au même titre qu’une bibliothèque PHP.
Le modèle s’inspire de principes éprouvés comme la méthode Twelve-Factor et les pratiques modernes d’intégration continue. L’objectif est simple : rendre le site plus maintenable, plus sécurisé et plus prévisible en production.
Principales caractéristiques
- Structure de dossiers améliorée : séparation nette entre web, config, vendor et code applicatif.
- Gestion des dépendances : WordPress et plugins sont gérés via Composer, facilitant les mises à jour et les verrouillages de version.
- Configurations par environnement : fichiers dédiés et dotenv pour isoler les secrets hors du dépôt.
- Autoloading et mu-plugins : possibilité de charger automatiquement des mu-plugins et du code partagé.
- Meilleures pratiques CI/CD : conventions qui s’intègrent naturellement aux pipelines d’intégration continue.

Architecture et structure
La structure proposée par Bedrock place les fichiers accessibles au web dans un répertoire web/ et laisse le reste hors racine publique. Cette séparation réduit la surface d’attaque et simplifie la gestion des assets.
Le noyau WordPress est géré dans vendor/ par Composer, ce qui signifie qu’une mise à jour se fait comme pour n’importe quelle dépendance PHP. Les thèmes et plugins deviennent des paquets que l’on peut versionner et partager.
| Répertoire | Contenu |
|---|---|
| web/ | Index public, assets, wp-config.php réécrit |
| vendor/ | Dépendances gérées par Composer (dont WordPress) |
| config/ | Fichiers de configuration par environnement |
Sécurité et configuration
L’usage de dotenv pour les variables sensibles permet d’extraire les secrets du dépôt Git et d’utiliser des valeurs spécifiques par environnement. Cela simplifie également l’intégration avec des services d’infrastructure ou des runners CI.
La configuration est écrite pour être lisible et modifiée sans toucher au cœur de WordPress, réduisant ainsi les risques liés aux merges ou aux erreurs humaines lors des déploiements.
Quand l’utiliser
Bedrock est pertinent dès que la complexité d’un projet dépasse le simple site vitrine. Il s’adresse aux sites d’entreprise, aux plateformes multi-équipes et aux projets qui nécessitent une gestion stricte des versions.
Pour des sites très petits, la surcouche peut sembler lourde, mais dès que plusieurs environnements ou plusieurs développeurs interviennent, la valeur ajoutée devient tangible.
- Projets collaboratifs : coordination facilitée entre développeurs et intégrateurs.
- Environnements multiples : dev, staging et production clairement isolés.
- Exigences de sécurité : séparation des secrets et réduction de la surface exposée.
Compatibilité et migration
La plupart des plugins et thèmes fonctionnent avec Bedrock, à condition qu’ils n’aient pas d’attentes rigides sur la structure des dossiers. Les extensions bien conçues sont agnostiques et s’adaptent sans modification.
La migration d’un site existant demande quelques étapes clés : adapter les chemins, convertir les références absolues et traiter la base de données. Des outils et scripts existent pour automatiser une partie du travail.
| Étape | Durée approximative | Difficulté |
|---|---|---|
| Installation initiale et configuration | 30–90 minutes | Faible |
| Adaptation des thèmes/plugins | 1–3 heures | Moyenne |
| Migrations de la base et vérifications | 1–4 heures | Élevée selon la complexité |
Fait clé : gérer WordPress comme une dépendance permet des mises à jour traçables et reproductibles, pratique utilisée par des équipes professionnelles depuis plusieurs années.
Outils et ressources
Pour démarrer rapidement, le dépôt officiel contient un README détaillé et des exemples de configuration. Le hub du projet centralise les meilleures pratiques adoptées par la communauté.
Si vous souhaitez examiner le code source ou cloner le starter, vous pouvez consulter le dépôt officiel sur GitHub pour voir la structure et les scripts fournis.
Ce que cela change pour vos projets
Adopter Bedrock transforme la façon dont on pense les déploiements, la sécurité et la maintenance. En séparant les responsabilités et en automatisant la gestion des dépendances, on gagne en fiabilité et en vitesse d’intervention.
Sur le plan humain, les équipes constatent moins de conflits de configuration et une montée en compétence plus linéaire entre développeurs juniors et seniors. Sur le plan technique, les gains se mesurent en temps réduit pour appliquer des correctifs et en traçabilité des versions.
Bilan : Bedrock n’est pas une solution magique, mais c’est un cadre pragmatique qui impose des bonnes pratiques et facilite la croissance d’un projet WordPress sans sacrifier la robustesse ni la sécurité.
FAQ
Bedrock est un squelette de projet qui traite WordPress comme une dépendance Composer, réorganise les répertoires, centralise la configuration et utilise dotenv pour sécuriser les secrets et améliorer la maintenabilité.
Bedrock offre une séparation claire entre web et code privé, gestion des dépendances via Composer, configurations par environnement, autoloading de code partagé et conventions CI/CD qui réduisent erreurs et accélèrent déploiements.
La plupart des plugins et thèmes bien conçus fonctionnent sans modification car ils sont agnostiques à la structure. Seuls les éléments qui présupposent des chemins absolus ou non standard peuvent nécessiter des ajustements.
La migration demande d’adapter les chemins publics, convertir les références absolues dans la base de données, déplacer la configuration vers le dossier config/ et éventuellement utiliser des scripts pour automatiser certaines étapes et validations.
Bedrock est recommandé pour sites d’entreprise, projets multi-équipes et environnements multiples où la traçabilité des versions, la sécurité des secrets et la cohérence des déploiements sont prioritaires; il peut être excessif pour un simple site vitrine.