Installer et configurer Drupal dans l’environnement local ServBay
Vue d'ensemble
Drupal est un système de gestion de contenus (CMS) open source puissant, flexible et évolutif, largement utilisé pour la création de sites web variés, du blog personnel et site de petite entreprise jusqu’aux portails d'entreprise et applications web complexes. Il offre de nombreux outils de gestion de contenu, un contrôle précis des permissions utilisateurs, ainsi qu’une architecture modulaire robuste, convenant parfaitement aux développeurs ayant besoin de personnalisation poussée et de performances élevées.
ServBay est un outil de développement web local conçu spécialement pour macOS, qui intègre des serveurs web populaires (comme Caddy, Nginx), divers environnements d’exécution (PHP, Node.js, Python, Go, Java, etc.), des bases de données (MySQL, PostgreSQL, MongoDB, Redis), ainsi que des outils de développeur comme Composer, npm, etc. Installer et configurer Drupal dans ServBay permet de profiter d’une plateforme de développement locale stable, pratique et riche en fonctionnalités.
Ce guide vous explique en détail comment installer et configurer Drupal dans l’environnement ServBay afin de rapidement mettre en place un environnement de développement local pour Drupal.
Prérequis
Avant de commencer l’installation de Drupal, veillez à réunir les conditions suivantes :
- ServBay est déjà installé et en cours d’exécution : Assurez-vous d’avoir installé ServBay sur macOS et que l’application fonctionne correctement.
- Connaissance de base de ServBay : Savoir comment gérer les packages, ajouter des sites via l’interface de ServBay et accéder aux outils intégrés (comme phpMyAdmin).
- PHP et MySQL/MariaDB installés : ServBay propose plusieurs versions de PHP ainsi que MySQL ou MariaDB. Vérifiez que la version de PHP désirée est activée et que le service de base de données est opérationnel.
- Composer installé : ServBay intègre Composer par défaut. C’est l’outil de gestion des dépendances incontournable pour les projets PHP modernes, utilisé dans ce guide pour créer le projet Drupal.
Étapes pour installer Drupal
Voici les étapes détaillées pour installer et configurer Drupal dans ServBay.
Étape 1 : Créer un dossier de projet
Commencez par créer un sous-dossier dédié à votre projet Drupal dans le dossier racine des sites ServBay, c’est-à-dire sous /Applications/ServBay/www
.
Ouvrez votre terminal et exécutez les commandes suivantes :
cd /Applications/ServBay/www
mkdir servbay-drupal-app
cd servbay-drupal-app
2
3
Vous venez ainsi de créer un dossier servbay-drupal-app
dans /Applications/ServBay/www
puis d’y accéder.
Étape 2 : Créer un projet Drupal avec Composer
Composer est déjà intégré dans ServBay, inutile d’installer autre chose. Il est recommandé par l’équipe officielle de Drupal pour gérer l’installation et les dépendances du projet.
Dans le dossier servbay-drupal-app
créé à l’étape précédente, lancez la commande Composer suivante :
composer create-project drupal/recommended-project .
Cette commande utilise le template drupal/recommended-project
pour installer Drupal dans le dossier courant (.
). Composer va automatiquement télécharger les fichiers de base de Drupal, ainsi que toutes les dépendances. Selon votre vitesse de connexion, l’opération peut prendre quelques minutes.
La structure produite place tous les fichiers accessibles au public (comme index.php
, les feuilles de style CSS, les fichiers JavaScript, etc.) dans un sous-dossier nommé web
. C’est la norme pour les projets Drupal récents, ce qui améliore la sécurité.
Étape 3 : Créer une base de données et un utilisateur
Drupal a besoin d’une base de données pour stocker contenus, configurations et utilisateurs. Nous allons utiliser l’outil phpMyAdmin inclus dans ServBay pour créer la base et l’utilisateur dédiés.
Accéder à l’outil de gestion de base de données phpMyAdmin de ServBay
Dans votre navigateur, accédez au tableau de bord ServBay à l’adresse :
https://servbay.host/
. Une fois sur la page d’accueil, trouvez et cliquez sur le lien « phpMyAdmin » (généralement dans la section "Outils" ou "Base de données") pour accéder à l’interface.servbay.host
est le domaine spécifique utilisé pour gérer facilement ServBay en local.Créer un utilisateur de base de données
Pour plus de sécurité, il est recommandé de créer un utilisateur dédié à votre projet Drupal.
- Page des utilisateurs : Dans l’interface principale de phpMyAdmin, cliquez sur « Comptes d’utilisateurs » dans le menu supérieur.
- Ajouter un nouvel utilisateur : Cliquez sur « Ajouter un compte utilisateur ».
- Saisir les informations du compte :
- Nom d’utilisateur : choisissez par exemple
drupal_user
. - Hôte : sélectionnez ou saisissez
localhost
(limite l’accès à la base aux connexions locales). - Mot de passe : choisissez un mot de passe fort (n’utilisez pas
password123
en production ! Servez-vous d’un générateur de mot de passe pour renforcer la sécurité). - Retapez le mot de passe.
- Nom d’utilisateur : choisissez par exemple
- Privilèges de base de données : Cochez « Créer une base du même nom et donner tous privilèges sur cette base » pour automatiquement associer la base à l’utilisateur.
- Privilèges globaux : Ne cochez pas « Donner tous les privilèges globaux » (sauf si vous savez ce que vous faites).
- Exécuter : Après vérification des infos saisies, cliquez sur « Exécuter » en bas à droite.
Vous venez de créer une base de données
drupal_user
et un utilisateurdrupal_user
disposant de tous les droits uniquement sur cette base.
Étape 4 : Configurer le serveur web (ajouter un site dans ServBay)
Ensuite, il faut configurer un site dans ServBay pour faire pointer un domaine local sur le dossier web
de votre projet Drupal.
- Ouvrir l’interface ServBay : Lancez l’application ServBay.
- Ajouter un nouveau site : Cliquez sur l’onglet « Sites » dans le menu latéral.
- Cliquer sur le bouton d’ajout : Sur la page liste des sites, appuyez sur le bouton « + » (ou équivalent) pour créer une nouvelle configuration.
- Remplir les informations du site :
- Nom : Donnez un nom lisible, par exemple
My Drupal Site
. - Domaine : Choisissez un domaine local, par exemple
servbay-drupal.local
. ServBay gère automatiquement les domaines en.local
, sans besoin de modifier votre fichier hosts. - Type de site : Sélectionnez
PHP
. - Version de PHP : Choisissez la version PHP compatible avec votre version de Drupal (voir documentation officielle).
- Racine du site : Très important : indiquez le chemin du dossier contenant le fichier d’entrée
index.php
. Avec le template de l’étape 2, il s’agit de :/Applications/ServBay/www/servbay-drupal-app/web
.
- Nom : Donnez un nom lisible, par exemple
- Sauvegarder la configuration : Une fois tous les champs remplis, cliquez sur « Enregistrer ». ServBay mettra à jour les réglages du serveur web et appliquera les changements.
Étape 5 : Lancer l’installation web de Drupal
Vous pouvez désormais débuter l’installation de Drupal via votre navigateur.
Accéder à la page d’installation
Rendez-vous sur votre navigateur à l’adresse composée du domaine local choisi à l’étape 4 suivi de
/core/install.php
, par exemple :https://servbay-drupal.local/core/install.php
.La page d’assistant d’installation de Drupal devrait s’ouvrir.
Choix de la langue
Choisissez la langue principale pour votre site Drupal puis cliquez sur « Enregistrer et continuer ».
Choisir la configuration d’installation
Sélectionnez le profil qui vous convient. L’option « Standard » vous permet de créer un site avec la configuration de base et les fonctionnalités courantes. Cliquez sur « Enregistrer et continuer ».
Configurer la base de données
On vous demandera ensuite de saisir les informations de connexion à la base de données créées à l’étape 3 :
- Type de base :
MySQL, MariaDB, Percona Server ou équivalent
- Nom de la base :
drupal_user
- Utilisateur :
drupal_user
- Mot de passe : celui défini lors de la création à l’étape 3
- Hôte :
localhost
- Options avancées : N’en modifiez qu’en cas de configuration spéciale (port non standard, etc.)
Cliquez ensuite sur « Enregistrer et continuer ». Drupal procède à la connexion et importe les données initiales.
- Type de base :
Renseigner les informations du site
Une fois la base de données connectée, l’installation passe à la configuration du site :
- Nom du site : Titre de votre site.
- Adresse e-mail du site : Pour les notifications, etc.
- Identifiant administrateur : Nom d’utilisateur du compte d’admin.
- Mot de passe administrateur : Choisissez un mot de passe fort.
- Pays/Région : Sélectionnez votre pays.
- Fuseau horaire : Choisissez votre fuseau.
Enregistrez vos réglages pour terminer l’installation, générer les fichiers de configuration et poser les bases de votre site.
Terminer l’installation
À la fin, vous êtes redirigé vers la page d’accueil de votre nouveau site Drupal. Félicitations, Drupal est bien installé dans ServBay !
Étape 6 : Installer modules et thèmes (initiation)
La force de Drupal repose sur son écosystème de modules et de thèmes. Après l’installation, commencez à étendre et personnaliser votre site selon vos besoins.
- Connexion à l’administration Drupal : Rendez-vous à
https://servbay-drupal.local/user
ouhttps://servbay-drupal.local/admin
et connectez-vous avec le compte admin créé à l’étape 5. - Installer des modules : Dans le menu d’admin, cliquez sur « Extensions » (Extend). Recherchez et installez les modules nécessaires pour ajouter des fonctionnalités à votre site.
- Installer des thèmes : Dans « Apparence » (Appearance), installez et configurez des thèmes pour modifier le design de votre site.
Configuration et utilisation après installation
Votre site Drupal installé, vous pouvez commencer sa construction. Voici quelques actions courantes pour bien démarrer.
Créer des types de contenu et du contenu
Les types de contenu définissent la structure de vos informations (articles, pages, etc.).
- Créer un type de contenu : Dans l’administration Drupal, allez dans « Structure » → « Types de contenu ». Modifiez ceux déjà présents ou cliquez sur « Ajouter type de contenu », puis définissez les champs (titre, corps, image, etc.).
- Ajouter un contenu : Accédez à « Contenu » → « Ajouter un contenu », sélectionnez le type désiré et renseignez les champs avant de sauvegarder et publier.
Configurer un menu de navigation
Les menus organisent la navigation sur votre site.
- Créer un menu : Dans « Structure » → « Menus », ajoutez-en un nouveau ou modifiez les existants.
- Ajouter des éléments de menu : Dans la configuration d’un menu, cliquez sur « Ajouter un lien », renseignez le label et l’URL cible (interne comme
/node/1
ou une URL externe), puis enregistrez.
Personnaliser la disposition des blocs
Les blocs vous permettent d’afficher du contenu modulable dans différentes zones (sidebar, pied de page...).
- Ajouter un bloc : Dans « Structure » → « Disposition des blocs », visualisez les zones du thème actif et faites glisser les blocs (menus, blocs personnalisés, etc.) où vous le souhaitez.
- Configurer un bloc : Utilisez le bouton « Configurer » d’un bloc pour en modifier le titre, préciser où et pour qui il apparaît, etc.
Conseils et FAQ
- Comment modifier la configuration de PHP ? Si Drupal requiert des extensions PHP spécifiques ou plus de mémoire (
memory_limit
), allez dans l’onglet « Packages » de ServBay pour votre version de PHP et éditez le fichierphp.ini
. Sauvegardez et redémarrez le service PHP (ServBay s’en charge généralement automatiquement). - Pourquoi mon site n’est pas accessible ?
- Assurez-vous que ServBay est lancé.
- Vérifiez la configuration du site dans ServBay (nom de domaine et racine du site doivent correspondre, par exemple
.../servbay-drupal-app/web
). - Vérifiez que le serveur web (Caddy ou Nginx) fonctionne dans ServBay.
- Accédez bien à
https://servbay-drupal.local
et à la bonne URL d’installation (https://servbay-drupal.local/core/install.php
).
- Problème de connexion à la base de données ?
- Vérifiez que le nom de base, l’utilisateur et le mot de passe saisis lors de l’installation Drupal correspondent bien à ceux créés dans phpMyAdmin.
- La valeur d’hôte doit être
localhost
. - Vérifiez que MySQL/MariaDB tourne dans ServBay.
- Erreur lors de l’installation des dépendances Composer ? Vérifiez votre connexion internet et la disponibilité de packagist.org. Parfois, il faut vider le cache de Composer ou mettre à jour le binaire (ServBay garantit généralement une version récente).
- Problèmes de droits de fichiers ? Drupal doit pouvoir écrire dans certains dossiers (
web/sites/default/files
,web/sites/default/settings.php
...). Comme ServBay exécute sous votre utilisateur macOS, les soucis de permissions sont rares, mais vérifiez celles des dossiers si besoin.
Conclusion
En suivant ce guide, vous avez installé et configuré Drupal avec succès dans votre environnement local ServBay. ServBay offre une solution intégrée, performante et flexible pour le développement Drupal, en rassemblant tous les composants nécessaires. Vous pouvez maintenant profiter de la puissance de Drupal pour construire votre site, et utiliser ServBay pour développer, tester et déboguer localement. Plus vous approfondirez votre maîtrise de Drupal, plus la flexibilité de ServBay vous permettra de gérer facilement différentes versions de PHP, bases de données et services pour vos projets.