Bedrock WordPress - Guide Pédagogique
Bedrock révolutionne le développement WordPress en apportant une architecture moderne, sécurisée et maintenable. Cette approche transforme WordPress d'un CMS traditionnel en une plateforme de développement robuste, adaptée aux équipes professionnelles et aux projets complexes.
🎯 Ce guide vous permettra de :
- Comprendre l'architecture moderne de Bedrock et ses avantages
- Maîtriser Composer pour la gestion des dépendances WordPress
- Configurer des environnements de développement robustes avec Docker
- Implémenter des solutions de templating modernes (Sage/Timber)
- Déployer en production avec CI/CD et sécurité renforcée
Partie 1: Fondations - Comprendre Bedrock
Qu'est-ce que Bedrock ?
🏠 Analogie : De la cabane à l'architecture moderne
WordPress traditionnel = Une maison construite sans plan : tout est mélangé, les fondations sont fragiles, difficile à rénover ou agrandir.
Bedrock = Architecture moderne avec plan détaillé : structure claire, matériaux séparés, fondations solides, facilement extensible et maintenable.
Bedrock est un boilerplate WordPress créé par l'équipe Roots qui modernise l'architecture de WordPress. Il transforme la structure chaotique traditionnelle en une organisation claire et professionnelle, inspirée des frameworks modernes comme Laravel ou Symfony.
🔒 Pourquoi Bedrock est plus sécurisé
- Configuration hors web : wp-config.php et .env ne sont pas accessibles via HTTP
- Séparation des responsabilités : Code, configuration et contenu sont isolés
- Gestion des versions : WordPress core via Composer, pas de modifications directes
- Headers de sécurité : Configuration centralisée des protections
- Environnements isolés : Configuration différente dev/staging/prod
Structure des fichiers Bedrock
Architecture complète d'un projet Bedrock
mon-projet-bedrock/
├── 📄 composer.json # Dépendances PHP (WordPress, plugins, thèmes)
├── 🔒 .env # Variables d'environnement (JAMAIS versionné)
├── 📄 .env.example # Template de configuration
├── 📄 .gitignore # WordPress core exclu du versioning
├── 📁 config/ # ⚡ Configuration hors web
│ ├── 📄 application.php # Configuration principale
│ └── 📁 environments/ # Config par environnement
│ ├── 📄 development.php # - Développement local
│ ├── 📄 staging.php # - Serveur de test
│ └── 📄 production.php # - Serveur de production
├── 📁 vendor/ # ⚡ Dépendances Composer (hors web)
├── 📁 web/ # 🌐 SEULE partie accessible via HTTP
│ ├── 📄 index.php # Point d'entrée unique
│ ├── 📄 wp-config.php # Bootstrap WordPress
│ ├── 📁 wp/ # WordPress core (via Composer)
│ └── 📁 app/ # Contenu personnalisé
│ ├── 📁 plugins/ # Plugins personnalisés uniquement
│ ├── 📁 themes/ # Thèmes personnalisés
│ ├── 📁 mu-plugins/ # Must-Use plugins
│ └── 📁 uploads/ # Médias uploadés
└── 📁 scripts/ # Scripts de déploiement/maintenance
À retenir - Fondations Bedrock
- Sécurité par conception : Fichiers sensibles hors de la racine web
- Séparation claire : Code custom, dépendances et core WordPress isolés
- Versionning intelligent : Seul le code custom est versionné, pas WordPress core
- Architecture évolutive : Structure pensée pour les projets complexes
- Compatibilité totale : Reste 100% compatible avec l'écosystème WordPress
Partie 2: Environnement & Dépendances
Configuration .env - Variables d'environnement
Le fichier .env centralise toute la configuration sensible et permet d'avoir des réglages différents selon l'environnement (développement, staging, production) sans modification de code.
Fichier .env complet avec explications
# 🌍 ENVIRONNEMENT DE DÉVELOPPEMENT
WP_ENV='development' # Type d'environnement (development|staging|production)
# 🌐 URLS DU SITE
WP_HOME='http://localhost:8080' # URL publique du site
WP_SITEURL="${WP_HOME}/wp" # URL de WordPress (toujours /wp avec Bedrock)
# 🗄️ BASE DE DONNÉES
DB_NAME='wordpress_dev' # Nom de la base de données
DB_USER='wordpress' # Utilisateur de la base
DB_PASSWORD='secret' # Mot de passe de la base
DB_HOST='database' # Hôte (localhost ou service Docker)
DB_PREFIX='wp_' # Préfixe des tables (sécurité)
# 🐛 DEBUG ET DÉVELOPPEMENT
WP_DEBUG_LOG=true # Logs d'erreurs activés
WP_DEBUG_DISPLAY=true # Affichage des erreurs
SCRIPT_DEBUG=true # Scripts non minifiés
# 🔐 CLÉS DE SÉCURITÉ (générer via https://roots.io/salts.html)
AUTH_KEY='your-unique-auth-key'
SECURE_AUTH_KEY='your-unique-secure-auth-key'
LOGGED_IN_KEY='your-unique-logged-in-key'
NONCE_KEY='your-unique-nonce-key'
AUTH_SALT='your-unique-auth-salt'
SECURE_AUTH_SALT='your-unique-secure-auth-salt'
LOGGED_IN_SALT='your-unique-logged-in-salt'
NONCE_SALT='your-unique-nonce-salt'
# 📧 SMTP (optionnel pour le développement)
SMTP_HOST='mailhog' # Service de mail local
SMTP_PORT=1025 # Port SMTP
🔑 Rôle de chaque variable .env :
- WP_ENV : Détermine quel fichier config/environments/ charger
- WP_HOME/WP_SITEURL : URLs de base, permettent les redirections automatiques
- DB_* : Connexion base de données, différente par environnement
- DEBUG : Contrôle l'affichage des erreurs et logs
- Clés de sécurité : Chiffrement des cookies et sessions WordPress
Composer - Gestionnaire de dépendances moderne
Composer révolutionne la gestion des plugins et thèmes WordPress. Il traite WordPress lui-même comme une dépendance, permettant un contrôle total sur les versions et les mises à jour.
📦 Analogie : Composer = Chef de projet pour votre code
Sans Composer = Vous devez télécharger, installer et mettre à jour chaque plugin manuellement, comme gérer une équipe sans coordination.
Avec Composer = Un chef de projet qui s'occupe automatiquement des recrutements (installations), gestion d'équipe (dépendances) et formations (mises à jour).
Gestion des plugins via Composer
# Plugins gratuits depuis le répertoire WordPress
composer require wpackagist-plugin/advanced-custom-fields
composer require wpackagist-plugin/yoast-seo
composer require wpackagist-plugin/contact-form-7
# Plugins premium (nécessite configuration repository)
composer require advanced-custom-fields/advanced-custom-fields-pro
# Thèmes gratuits
composer require wpackagist-theme/twentytwentyfour
# Plugins de développement uniquement
composer require --dev wpackagist-plugin/query-monitor
composer require --dev wpackagist-plugin/debug-bar
# Mettre à jour tous les plugins
composer update
# Supprimer un plugin
composer remove wpackagist-plugin/nom-plugin
| Type de dépendance | Préfixe Composer | Exemple | Destination |
|---|---|---|---|
| Plugin gratuit | wpackagist-plugin/ | wpackagist-plugin/jetpack | web/app/plugins/ |
| Thème gratuit | wpackagist-theme/ | wpackagist-theme/twentytwentyfour | web/app/themes/ |
| Must-Use Plugin | type:wordpress-muplugin | Custom configuration | web/app/mu-plugins/ |
| WordPress Core | roots/wordpress | roots/wordpress:^6.4 | web/wp/ |
Configuration Docker pour le développement
Docker transforme l'expérience de développement en créant un environnement isolé, reproductible et partageable entre les développeurs. Cette configuration élimine les problèmes de "ça marche sur ma machine".
docker-compose.yml complet pour Bedrock
version: '3.8'
services:
# Application WordPress avec Bedrock
wordpress:
image: webdevops/php-apache:8.1
container_name: bedrock-wp
volumes:
- ./:/app
ports:
- "8080:80"
environment:
- WEB_DOCUMENT_ROOT=/app/web
- PHP_MEMORY_LIMIT=512M
- PHP_UPLOAD_MAX_FILESIZE=100M
depends_on:
- database
networks:
- bedrock-network
# Base de données MySQL
database:
image: mysql:8.0
container_name: bedrock-db
environment:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: wordpress_dev
MYSQL_USER: wordpress
MYSQL_PASSWORD: secret
volumes:
- db_data:/var/lib/mysql
ports:
- "3306:3306"
networks:
- bedrock-network
# phpMyAdmin pour gérer la base
phpmyadmin:
image: phpmyadmin/phpmyadmin
container_name: bedrock-pma
environment:
PMA_HOST: database
PMA_USER: wordpress
PMA_PASSWORD: secret
ports:
- "8081:80"
depends_on:
- database
networks:
- bedrock-network
volumes:
db_data:
networks:
bedrock-network:
driver: bridge
À retenir - Environnement & Dépendances
- Composer pour tout : WordPress core, plugins, thèmes gérés comme des dépendances
- .env pour la configuration : Variables d'environnement centralisées et sécurisées
- Docker pour l'isolation : Environnement reproductible et partageable
- Versioning intelligent : Composer.lock garantit la reproductibilité
- Environnements multiples : dev/staging/prod avec configurations distinctes
Partie 3: Développement Moderne
Templating moderne : Sage vs Timber
Bedrock se marie parfaitement avec des approches modernes de templating qui séparent la logique de la présentation. Deux solutions principales dominent : Sage (Blade) et Timber (Twig).
| Aspect | Sage (Blade) | Timber (Twig) |
|---|---|---|
| Syntaxe | Blade Laravel (@if, {{ }}) | Twig Symfony ({% if %}, {{ }}) |
| Écosystème | Laravel, build tools modernes | Symfony, focus templating |
| CSS Framework | Tailwind CSS intégré | Libre choix |
| Build Process | Laravel Mix / Vite | Configuration manuelle |
| Courbe apprentissage | Moyenne (si connaissance Laravel) | Douce (syntaxe intuitive) |
| Performance | Excellente (cache Blade) | Excellente (cache Twig) |
Option 1 : Installation Sage
Setup complet Sage avec Bedrock
# Dans le dossier Bedrock, créer un thème Sage
composer create-project roots/sage web/app/themes/mon-theme
# Se placer dans le dossier du thème
cd web/app/themes/mon-theme
# Installer les dépendances Node.js
npm install
# Lancer le build de développement
npm run dev
# Mode watch pour le développement
npm run dev -- --watch
# Build pour la production
npm run build
Option 2 : Configuration Timber
Installation et configuration Timber
# Installer Timber via Composer
composer require timber/timber
# Dans functions.php du thème
<?php
use Timber\Timber;
// Initialiser Timber
Timber::init();
Timber::$dirname = ['templates'];
// Classe principale du site
class StarterSite extends Timber\Site {
public function __construct() {
add_action('after_setup_theme', array($this, 'theme_supports'));
add_filter('timber/context', array($this, 'add_to_context'));
parent::__construct();
}
public function add_to_context($context) {
$context['menu'] = new Timber\Menu('primary');
$context['site'] = $this;
return $context;
}
public function theme_supports() {
add_theme_support('post-thumbnails');
add_theme_support('menus');
}
}
new StarterSite();
// Contrôleur pour la page d'accueil
$context = Timber::context();
$context['posts'] = new Timber\PostQuery();
Timber::render('index.twig', $context);
Debugging et outils de développement
Must-Use Plugin pour optimisations (web/app/mu-plugins/bedrock-optimizations.php)
<?php
// Plugin Must-Use automatiquement activé
// Nettoyer le head WordPress
remove_action('wp_head', 'wp_generator');
remove_action('wp_head', 'wlwmanifest_link');
remove_action('wp_head', 'rsd_link');
remove_action('wp_head', 'wp_shortlink_wp_head');
// Désactiver l'API REST pour les non-connectés (optionnel)
add_filter('rest_authentication_errors', function($result) {
if (!empty($result)) {
return $result;
}
if (!is_user_logged_in()) {
return new WP_Error('rest_not_logged_in', 'API REST désactivée.', array('status' => 401));
}
return $result;
});
// Headers de sécurité
function add_security_headers() {
header('X-Content-Type-Options: nosniff');
header('X-Frame-Options: SAMEORIGIN');
header('X-XSS-Protection: 1; mode=block');
header('Referrer-Policy: strict-origin-when-cross-origin');
}
add_action('send_headers', 'add_security_headers');
Makefile pour automatiser les tâches
.PHONY: help install up down shell logs clean
help: ## Afficher cette aide
@grep -E '^[a-zA-Z_-]+:.*?## .*$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $1, $2}'
install: ## Installer le projet
composer install
docker-compose up -d
@echo "🎉 Projet installé ! http://localhost:8080"
up: ## Démarrer les conteneurs
docker-compose up -d
down: ## Arrêter les conteneurs
docker-compose down
shell: ## Shell WordPress
docker-compose exec wordpress bash
logs: ## Voir les logs
docker-compose logs -f
clean: ## Nettoyer
docker-compose down -v
docker system prune -f
update: ## Mettre à jour
composer update
docker-compose exec wordpress wp core update
À retenir - Développement Moderne
- Séparation logique/présentation : Templates modernes (Blade/Twig) vs PHP mélangé
- Composants réutilisables : Architecture modulaire pour grandes équipes
- Build process moderne : Outils front-end intégrés (Vite, Mix, etc.)
- Must-Use Plugins : Fonctionnalités automatiquement activées
- Automatisation : Makefile et scripts pour simplifier le workflow
Partie 4: Déploiement & Production
CI/CD avec GitHub Actions
Pipeline de déploiement automatisé (.github/workflows/deploy.yml)
name: Deploy Bedrock
on:
push:
branches: [main, staging]
jobs:
test:
runs-on: ubuntu-latest
services:
mysql:
image: mysql:8.0
env:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: wordpress_test
options: --health-cmd="mysqladmin ping" --health-interval=10s
steps:
- name: Checkout
uses: actions/checkout@v3
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.1'
- name: Install dependencies
run: composer install --no-dev --optimize-autoloader
- name: Run tests
run: vendor/bin/phpunit
deploy-staging:
needs: test
runs-on: ubuntu-latest
if: github.ref == 'refs/heads/staging'
steps:
- name: Deploy to staging
uses: appleboy/ssh-action@v0.1.5
with:
host: ${{ secrets.STAGING_HOST }}
username: ${{ secrets.STAGING_USER }}
key: ${{ secrets.STAGING_SSH_KEY }}
script: |
cd /var/www/staging
git pull origin staging
composer install --no-dev
php vendor/bin/phpcbf
deploy-production:
needs: test
runs-on: ubuntu-latest
if: github.ref == 'refs/heads/main'
environment: production
steps:
- name: Deploy to production
run: echo "Production deployment with approval"
Dockerfile multi-stage pour la production
Dockerfile optimisé
# Build stage
FROM composer:2 AS vendor
WORKDIR /app
COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader --no-scripts
# Production stage
FROM webdevops/php-apache:8.1-alpine
LABEL maintainer="team@monsite.com"
# Configuration
ENV WEB_DOCUMENT_ROOT=/app/web
ENV PHP_MEMORY_LIMIT=512M
ENV PHP_UPLOAD_MAX_FILESIZE=100M
# Copier l'application
COPY --from=vendor /app /app
COPY . /app
# Permissions
RUN chown -R application:application /app/web/app/uploads
RUN chmod -R 755 /app/web/app/uploads
# Health check
HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
CMD curl -f http://localhost/wp/wp-admin/admin-ajax.php || exit 1
EXPOSE 80
À retenir - Déploiement & Production
- CI/CD automatisé : Tests, builds et déploiements sans intervention manuelle
- Environnements isolés : staging et production avec configurations distinctes
- Docker multi-stage : Images optimisées pour la production
- Health checks : Monitoring automatique de l'état de l'application
- Rollback facile : Versioning et capacité de retour arrière rapide
Partie 5: Sécurité Avancée
🔒 Top 5 des mesures de sécurité Bedrock
- Configuration hors web : .env et config/ inaccessibles via HTTP
- Headers de sécurité : CSP, HSTS, X-Frame-Options, etc.
- Désactivation fonctionnalités : Éditeur de fichiers, installation plugins
- Validation des entrées : Échappement automatique, sanitisation
- Mises à jour automatisées : WordPress core et plugins via Composer
Configuration sécurisée complète (config/application.php)
<?php
// Désactiver l'éditeur de fichiers
define('DISALLOW_FILE_EDIT', true);
define('DISALLOW_FILE_MODS', true);
// Forcer HTTPS en production
if (WP_ENV === 'production') {
define('FORCE_SSL_ADMIN', true);
ini_set('display_errors', 0);
}
// Sécuriser les cookies
ini_set('session.cookie_httponly', 1);
ini_set('session.cookie_secure', 1);
ini_set('session.cookie_samesite', 'Strict');
// Content Security Policy
function add_csp_header() {
$csp = "default-src 'self'; ";
$csp .= "script-src 'self' 'unsafe-inline' cdnjs.cloudflare.com; ";
$csp .= "style-src 'self' 'unsafe-inline' fonts.googleapis.com; ";
$csp .= "font-src 'self' fonts.gstatic.com; ";
$csp .= "img-src 'self' data: *.wordpress.com; ";
$csp .= "frame-ancestors 'none';";
header("Content-Security-Policy: " . $csp);
}
add_action('send_headers', 'add_csp_header');
// Limiter les tentatives de connexion
function limit_login_attempts() {
$ip = $_SERVER['REMOTE_ADDR'];
$attempts = get_transient('login_attempts_' . $ip) ?: 0;
if ($attempts >= 5) {
wp_die('Trop de tentatives. Réessayez dans 15 minutes.');
}
}
add_action('wp_login_failed', 'limit_login_attempts');
À retenir - Sécurité Avancée
- Défense en profondeur : Multiples couches de protection
- Principe du moindre privilège : Accès minimal nécessaire
- Headers HTTP sécurisés : CSP, HSTS, X-Frame-Options
- Monitoring et logs : Détection proactive des menaces
- Mises à jour automatisées : Composer garantit la sécurité des dépendances
Partie 6: Optimisations & Performance
Optimisations au niveau serveur
Configuration Apache/Nginx optimisée (.htaccess)
# Compression Gzip
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json
</IfModule>
# Cache statique
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType text/css "access plus 1 year"
ExpiresByType application/javascript "access plus 1 year"
ExpiresByType image/png "access plus 1 year"
ExpiresByType image/jpg "access plus 1 year"
ExpiresByType image/jpeg "access plus 1 year"
</IfModule>
# Sécurité des répertoires
<Files "composer.json">
Order allow,deny
Deny from all
</Files>
<Files ".env">
Order allow,deny
Deny from all
</Files>
Must-Use Plugins pour la performance
Plugin de cache et optimisations (web/app/mu-plugins/performance.php)
<?php
// Optimisations automatiques de performance
// Désactiver l'emoji support
remove_action('wp_head', 'print_emoji_detection_script', 7);
remove_action('wp_print_styles', 'print_emoji_styles');
// Retirer les styles de blocks Gutenberg si non utilisés
function remove_gutenberg_css() {
if (!is_admin()) {
wp_dequeue_style('wp-block-library');
wp_dequeue_style('wp-block-library-theme');
}
}
add_action('wp_enqueue_scripts', 'remove_gutenberg_css', 100);
// Optimiser les requêtes WP_Query
function optimize_wp_queries() {
if (is_admin()) return;
// Désactiver les requêtes d'auteur sur les pages non-author
if (!is_author()) {
remove_action('template_redirect', 'wp_old_slug_redirect');
}
}
add_action('init', 'optimize_wp_queries');
// Preload critical resources
function add_preload_links() {
echo '<link rel="preload" href="' . get_template_directory_uri() . '/assets/app.css" as="style">';
echo '<link rel="preload" href="' . get_template_directory_uri() . '/assets/app.js" as="script">';
}
add_action('wp_head', 'add_preload_links', 1);
// Lazy loading pour les images (WordPress 5.5+)
add_filter('wp_lazy_loading_enabled', '__return_true');
À retenir - Optimisations & Performance
- Cache multi-niveaux : Browser, CDN, serveur, application
- Optimisation assets : Minification, compression, lazy loading
- Must-Use Plugins : Optimisations automatiques et transparentes
- Monitoring performance : Web Vitals, temps de chargement
- CDN intégration : Distribution mondiale des assets statiques
Partie 7: Ressources & Communauté
Liens essentiels pour approfondir Bedrock
- Documentation officielle : https://roots.io/bedrock/
- Discourse Roots : https://discourse.roots.io/ - Communauté active
- WPackagist : https://wpackagist.org/ - Dépôt Composer pour WordPress
- Sage documentation : https://roots.io/sage/docs/ - Thème moderne
- Timber documentation : https://timber.github.io/docs/ - Templating Twig
- Bedrock GitHub : https://github.com/roots/bedrock - Code source
Écosystème Roots complet
| Outil | Description | Usage recommandé |
|---|---|---|
| Bedrock | Boilerplate WordPress moderne | Base de tous les projets WordPress professionnels |
| Sage | Thème starter avec Blade | Projets nécessitant un build process moderne |
| Trellis | DevOps et déploiement Ansible | Automatisation complète des serveurs |
| Timber | Templating Twig pour WordPress | Alternative à Sage, plus flexible |
Partie 8: Comparaisons & Alternatives
| Aspect | WordPress Classique | Bedrock | Headless WordPress |
|---|---|---|---|
| Structure | Monolithique, tout mélangé | Organisée, séparée | API uniquement |
| Gestion deps | Manuelle (FTP, admin) | Composer automatisé | Package managers divers |
| Déploiement | Complexe et risqué | Automatisé, fiable | Découplé frontend/backend |
| Sécurité | Vulnérable par défaut | Sécurisé par conception | Surface d'attaque réduite |
| Performance | Lourde, non optimisée | Optimisée, cacheable | Très rapide (statique) |
| Courbe apprentissage | Facile au début | Moyenne | Élevée (frameworks JS) |
| Maintenance | Difficile à grande échelle | Scalable et maintenable | Complexité architecturale |
Quand choisir Bedrock ?
🎯 Bedrock est idéal pour :
- Projets d'équipe : Multiples développeurs, environnements partagés
- Applications complexes : E-commerce, portails, sites corporate
- Clients exigeants : Besoins de sécurité et performance élevés
- Maintenance long terme : Évolutions fréquentes, montée en charge
- Intégration CI/CD : Déploiements automatisés, tests
❌ Évitez Bedrock pour :
- Projets simples : Blog personnel, site vitrine basique
- Budget très limité : Hébergement mutualisé basic
- Équipe non technique : Besoin d'interface admin uniquement
- Projets temporaires : Landing pages, événements courts
🎯 Synthèse Finale
Bedrock transforme WordPress en plateforme de développement moderne en apportant :
- Architecture sécurisée : Configuration hors web, environnements isolés
- Gestion professionnelle : Composer, Docker, CI/CD intégrés
- Développement moderne : Templating avancé, outils contemporains
- Scalabilité native : Pensé pour les projets complexes et équipes importantes
- Maintenance simplifiée : Mises à jour automatisées, déploiements fiables
💡 Investissement vs bénéfices : La courbe d'apprentissage initiale de Bedrock est compensée par des gains considérables en productivité, sécurité et maintenabilité. Pour un développeur habitué aux frameworks modernes (React, Laravel, Symfony), cette approche sera intuitive et permettra d'appliquer les mêmes bonnes pratiques au développement WordPress.
🚀 Prochaine étape recommandée : Commencer par un projet de test avec Bedrock + Docker pour se familiariser avec l'architecture, puis progresser vers Sage ou Timber selon vos préférences de templating. L'écosystème Roots offre une progression naturelle vers des solutions encore plus avancées (Trellis pour DevOps).