Installer et configurer Bedrock dans l’environnement ServBay

Vue d’ensemble

Ce document vous guide pas à pas pour installer et configurer Bedrock dans l’environnement de développement local ServBay. Bedrock offre une structure de projet WordPress moderne basée sur Composer pour la gestion des dépendances, une gestion de configuration optimisée et l’application des meilleures pratiques, ce qui améliore considérablement l’efficacité et la sécurité du développement, du déploiement et de la maintenance de vos projets WordPress. Associé à la puissance et la simplicité de gestion locale de ServBay, vous pouvez préparer très rapidement un environnement de développement Bedrock.

Qu’est-ce que Bedrock ?

Bedrock est une structure de projet WordPress créée par l’équipe Roots afin d’améliorer l’expérience de développement sur WordPress. Elle présente plusieurs différences majeures par rapport à la structure WordPress classique, notamment :

• Gestion des dépendances avec Composer : Le cœur WordPress, les thèmes et les plugins sont tous gérés via Composer, ce qui facilite les mises à jour et la résolution des conflits de dépendances.
• Gestion de configuration améliorée : Inspiré des principes Twelve-Factor App, la configuration est séparée du code via un fichier .env contenant les variables d’environnement, garantissant plus de sécurité et de flexibilité.
• Organisation de projet plus claire : Le cœur WordPress est isolé dans un sous-dossier dédié (web/wp), tandis que les thèmes et plugins sont situés dans web/app, pour une structure de fichiers plus propre.
• Sécurité renforcée : Des mesures de sécurité sont incluses par défaut, comme la dissimulation du chemin des fichiers cœur.

Bedrock est le choix idéal pour bâtir des applications WordPress robustes, modernes et faciles à maintenir.

Pourquoi choisir ServBay pour le développement Bedrock ?

ServBay est un outil de développement web local spécialement conçu pour macOS. Il intègre les serveurs web principaux (Caddy/Nginx/Apache), de multiples versions de PHP, la gestion de bases de données (MySQL/PostgreSQL/MongoDB) ainsi que des environnements pour Node.js, Python, Go, Java, etc. Utiliser ServBay avec Bedrock vous permet de :

• Installer un environnement rapidement : ServBay intègre PHP, Composer et les bases de données dont Bedrock a besoin, sans installation ou configuration supplémentaire.
• Changer facilement de version : Basculez aisément entre différentes versions de PHP pour tester la compatibilité de Bedrock.
• Gestion unifiée des bases de données : Créez et gérez aisément vos bases de données pour Bedrock via phpMyAdmin ou Adminer inclus dans ServBay.
• Configuration simplifiée des sites : Configurez rapidement les sites (hôtes virtuels) de vos projets Bedrock via l’interface graphique de ServBay, en pointant vers le bon dossier racine.
• Gestion centralisée : Gérez tous vos packages logiciels et vos sites locaux via une seule application.

Prérequis

Avant de commencer l’installation, veuillez vous assurer que :

• ServBay est installé et lancé sur votre Mac.
• Vous disposez de notions de base en utilisation du terminal.
• Vous maîtrisez les bases de Composer (ce guide fournit néanmoins les commandes nécessaires).

Étapes pour installer Bedrock

Cette section détaille chaque étape pour installer et configurer un projet Bedrock dans ServBay.

Étape 1 : Créer le dossier du projet

Commencez par vous rendre dans le répertoire racine des sites ServBay /Applications/ServBay/www, puis créez-y un nouveau dossier pour votre projet. Choisissez un nom explicite, tel que servbay-bedrock-app.

cd /Applications/ServBay/www
mkdir servbay-bedrock-app
cd servbay-bedrock-app

Ce dossier sera le répertoire racine de votre projet Bedrock.

Étape 2 : Créer le projet Bedrock avec Composer

ServBay embarque déjà Composer, vous pouvez donc directement exécuter la commande composer. Dans le dossier de votre projet (/Applications/ServBay/www/servbay-bedrock-app), lancez la commande suivante pour générer le projet Bedrock :

composer create-project roots/bedrock .

Cette commande téléchargera la dernière version de Bedrock ainsi que toutes ses dépendances dans le dossier courant (.). Le temps d’exécution dépend de la vitesse de votre connexion internet.

Étape 3 : Créer la base de données et l’utilisateur

Bedrock et WordPress nécessitent une base de données pour stocker le contenu et les paramètres du site. Nous utiliserons phpMyAdmin intégré à ServBay pour cette étape.

1. Accédez à l’outil phpMyAdmin de ServBay

   Dans votre navigateur, rendez-vous sur l’adresse locale de ServBay https://servbay.host/. Sur la page d’accueil de ServBay, cliquez sur le lien « phpMyAdmin » pour ouvrir l’interface de gestion des bases de données.

2. Créer un utilisateur base de données

   Pour plus de sécurité et une meilleure gestion, il est conseillé de créer un utilisateur et une base de données par projet.

   1. Rendez-vous sur la page des utilisateurs

      Sur la page principale de phpMyAdmin, cliquez sur « Utilisateurs comptes » dans le menu supérieur.

   2. Ajouter un nouvel utilisateur

      Cliquez sur « Ajouter un compte utilisateur ». Renseignez les champs suivants :

      • Nom d’utilisateur : Entrez un nom pour l’utilisateur de ce projet, par exemple bedrock_user.
      • Hôte : Sélectionnez localhost. Ainsi, il ne sera accessible qu’en local.
      • Mot de passe : Indiquez un mot de passe sécurisé pour cet utilisateur. Notez-le, par exemple password123 pour du test local, mais utilisez un mot de passe robuste en production.
      • Confirmation : Saisissez à nouveau le mot de passe.

      Dans la section « Base de données pour l’utilisateur », choisissez « Créer une base de données portant le même nom que l’utilisateur et lui donner tous les privilèges ». phpMyAdmin créera alors automatiquement une base nommée bedrock_user avec tous les droits pour cet utilisateur.

      Vérifiez que la case « Accorder tous les privilèges » est cochée pour garantir l’accès complet à la base.

      Cliquez ensuite sur « Exécuter » en bas de la page pour finir la création de l’utilisateur et de sa base.

Étape 4 : Configurer Bedrock

Bedrock utilise des variables d’environnement pour sa configuration, généralement via le fichier .env placé à la racine du projet.

1. Préparer le fichier de configuration

   Dans le dossier racine de votre projet Bedrock (/Applications/ServBay/www/servbay-bedrock-app), repérez le fichier exemple .env.example. Copiez-le et renommez-le en .env :

   cp .env.example .env

   Le fichier .env sert à la configuration réelle du projet, tandis que .env.example est un simple gabarit sans données sensibles.

2. Éditer le fichier .env

   Avec votre éditeur préféré (VS Code, Sublime Text, Nano…), ouvrez le fichier .env. Repérez la section dédiée à la connexion base de données et modifiez-la selon les informations créées à l’étape 3 :

   # Base de données
   DB_NAME='bedrock_user' # Nom de la base, identique à l’utilisateur
   DB_USER='bedrock_user' # Nom de l’utilisateur de la base
   DB_PASSWORD='password123' # Mot de passe de la base
   DB_HOST='localhost' # Hôte base de données, en local c’est généralement localhost
   DB_PREFIX='wp_' # Préfixe des tables, conserve la valeur par défaut ou modifiez-le
   
   # Environnement WordPress
   WP_ENV='development' # Environnement actuel : development, staging, production…
   
   # URLs du site
   WP_HOME='http://servbay-bedrock.local' # URL complète de votre site
   WP_SITEURL='${WP_HOME}/wp' # Chemin URL des fichiers WordPress principaux

   Veillez à adapter les valeurs à votre configuration réelle, notamment le DB_PASSWORD selon ce que vous avez défini sous phpMyAdmin.

   WP_HOME et WP_SITEURL définissent les adresses d’accès à votre site. servbay-bedrock.local est un nom courant pour du développement local, mais vous pouvez le personnaliser. Attention, WP_SITEURL doit pointer vers le sous-dossier WordPress (web/wp).

   Vous pouvez également définir d’autres réglages WordPress/Bedrock dans le .env selon vos besoins (constantes, email, etc.).

Étape 5 : Configurer le serveur web (site ServBay)

Pour que le serveur inclus dans ServBay serve correctement votre projet Bedrock, il vous faut ajouter un nouveau site (hôte virtuel) dans ServBay.

1. Ajouter un nouveau site

   Ouvrez l’application ServBay, puis, dans la barre latérale, cliquez sur l’onglet « Sites ». Cliquez sur le bouton « + » ou « Ajouter un site ». Renseignez les champs suivants :

   • Nom : Choisissez un nom explicite, par exemple My Bedrock Site (uniquement pour l’affichage interne dans ServBay).
   • Domaine : Entrez le nom de domaine indiqué dans WP_HOME de votre .env, par exemple servbay-bedrock.local. ServBay le liera automatiquement à 127.0.0.1.
   • Type de site : Sélectionnez PHP.
   • Version PHP : Choisissez une version prise en charge par Bedrock (idéalement la plus récente proposée par ServBay).
   • Dossier racine du site : Étape cruciale ! Le dossier racine n’est pas celui de votre projet, mais le sous-dossier web. Indiquez donc /Applications/ServBay/www/servbay-bedrock-app/web.

2. Sauvegarder la configuration

   Une fois les champs complétés, cliquez sur Enregistrer. ServBay mettra à jour la configuration du serveur web. Si une demande de redémarrage apparaît, validez pour appliquer les changements.

Étape 6 : Finaliser l’installation WordPress

Votre projet Bedrock et le site ServBay sont prêts. Il ne vous reste plus qu’à achever l’installation classique de WordPress via le navigateur.

1. Accéder à la page d’installation

   Rendez-vous dans votre navigateur à l’adresse WP_SITEURL définie, par exemple : http://servbay-bedrock.local/wp. Si tout est bien configuré, l’assistant d’installation WordPress devrait s’afficher.

2. Saisir les informations de la base de données

   Lors de l’installation, WordPress vous demandera les identifiants de la base créés à l’étape 3 :

   • Nom de la base : bedrock_user
   • Nom d’utilisateur : bedrock_user
   • Mot de passe : Le mot de passe défini préalablement (par exemple password123)
   • Hôte de la base : localhost
   • Préfixe des tables : wp_ (laisser la valeur par défaut sauf besoin spécifique)

   Cliquez sur « Soumettre ». WordPress vérifiera alors la connexion.

3. Renseigner les informations du site

   En cas de réussite, l’assistant vous demande :

   • Titre du site : Choisissez le nom de votre site.
   • Identifiant : Définissez un identifiant admin.
   • Mot de passe : Choisissez un mot de passe fort pour l’admin.
   • Adresse e-mail : Saisissez l’email de l’administrateur.
   • Visibilité par les moteurs de recherche : En développement local, il est conseillé de cocher l’option pour bloquer l’indexation.

4. Terminer l’installation

   Cliquez sur « Installer WordPress ». WordPress achèvera l’installation et créera toutes les tables nécessaires en base. À la fin, une page de confirmation s’affichera avec le lien pour accéder à l’interface d’administration.

Étape 7 : Installer thèmes et plugins (avec Composer)

Bedrock recommande de gérer thèmes et plugins avec Composer plutôt que via l’interface WordPress.

1. Trouver le nom du package Composer

   La plupart des thèmes et plugins populaires sont disponibles sur Packagist (packagist.org) ou WordPress Packagist (wpackagist.org). Le nom du package suit généralement le format vendor/nom-du-package, par exemple wpackagist-theme/twentytwentyone ou wpackagist-plugin/wordpress-seo.

2. Installer avec Composer

   Dans la racine du projet Bedrock (/Applications/ServBay/www/servbay-bedrock-app), exécutez :

   Pour les thèmes :

   composer require wpackagist-theme/your-theme-name

   Pour les plugins :

   composer require wpackagist-plugin/your-plugin-name

   Remplacez your-theme-name et your-plugin-name par le nom réel du thème ou plugin. Composer installera le thème dans web/app/themes et le plugin dans web/app/plugins.

3. Activer depuis l’admin WordPress

   Connectez-vous à l’admin WordPress (http://servbay-bedrock.local/wp/wp-admin/), puis :

   • Pour les thèmes : menu « Apparence » > « Thèmes », trouvez celui que vous venez d’installer et activez-le.
   • Pour les plugins : menu « Extensions » > « Extensions installées », repérez le plugin ajouté et activez-le.

   Bien que les installations via fichier .zip restent possibles, Composer est la méthode recommandée et la plus moderne sous Bedrock.

Construire votre site avec Bedrock

Votre environnement Bedrock est désormais opérationnel sous ServBay. Vous pouvez maintenant bâtir votre site comme avec WordPress classique, tout en profitant des bénéfices de la structure moderne Bedrock :

• Créer des pages et articles : Connectez-vous à l’admin WordPress pour gérer vos pages et publications, comme habituellement.
• Configurer les menus : Rendez-vous dans « Apparence » > « Menus » pour vos navigations.
• Personnaliser les widgets : Gérez l’affichage des zones dynamiques dans « Apparence » > « Widgets ».
• Développement de thèmes/plugins : Si vous êtes développeur, travaillez vos créations dans web/app/themes ou web/app/plugins.
• Gestion de configuration : Exploitez le fichier .env pour gérer différentes configurations selon l’environnement (développement, préproduction, production).

Questions fréquentes (FAQ)

• Q : Que faire si la visite de http://servbay-bedrock.local affiche une erreur 404 ?

  • R : Vérifiez que le domaine configuré dans ServBay correspond bien à celui que vous tentez d’atteindre.
  • R : Vérifiez que le dossier racine pointé dans ServBay est bien /Applications/ServBay/www/servbay-bedrock-app/web.
  • R : Assurez-vous que le serveur web de ServBay est bien lancé.
  • R : Vérifiez la valeur de WP_HOME dans votre fichier .env.

• Q : Que faire face à une erreur de connexion à la base sur http://servbay-bedrock.local/wp ?

  • R : Vérifiez que les paramètres DB_NAME, DB_USER, DB_PASSWORD, DB_HOST du fichier .env correspondent bien à ceux saisis sous phpMyAdmin.
  • R : Assurez-vous que MySQL (ou la base sélectionnée) fonctionne dans ServBay.
  • R : Vérifiez l’attribution des droits sur la base pour l’utilisateur.

• Q : Pourquoi mon thème ou plugin fraîchement installé n’apparaît pas dans l’admin WordPress ?

  • R : Si installé via Composer, assurez-vous d’avoir bien lancé composer install ou composer require dans la racine du projet, sans erreur.
  • R : Les thèmes et plugins Composer vont dans web/app/themes et web/app/plugins, vérifiez leur présence.
  • R : Activez-les via l’admin WordPress > Apparence/Thèmes ou Extensions.

• Q : Comment mettre à jour Bedrock, WordPress, un thème ou un plugin ?

  • R : La gestion via Composer s’effectue généralement avec composer update à la racine du projet pour tout mettre à jour, ou composer update vendor/package-name pour un package précis. Après cela, il pourra être nécessaire d’effectuer la mise à jour de la base de données depuis l’admin WordPress.

Conclusion

Si vous avez suivi toutes ces étapes, votre projet Bedrock est désormais parfaitement opérationnel dans l’environnement local de développement ServBay. Avec la gestion facilitée de ServBay et la structure moderne de Bedrock, vous pouvez développer et maintenir vos sites WordPress de manière beaucoup plus efficace et sécurisée. Il ne vous reste plus qu’à tirer parti de tous les avantages de Bedrock pour créer votre prochain site WordPress !