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 :

1. 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.
2. 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).
3. 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.
4. 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

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.

1. 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.

2. 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.
   • 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 utilisateur drupal_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.

1. Ouvrir l’interface ServBay : Lancez l’application ServBay.
2. Ajouter un nouveau site : Cliquez sur l’onglet « Sites » dans le menu latéral.
3. Cliquer sur le bouton d’ajout : Sur la page liste des sites, appuyez sur le bouton « + » (ou équivalent) pour créer une nouvelle configuration.
4. 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.
5. 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.

1. 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.

2. Choix de la langue

   Choisissez la langue principale pour votre site Drupal puis cliquez sur « Enregistrer et continuer ».

3. 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 ».

4. 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.

5. 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.

6. 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.

1. Connexion à l’administration Drupal : Rendez-vous à https://servbay-drupal.local/user ou https://servbay-drupal.local/admin et connectez-vous avec le compte admin créé à l’étape 5.
2. 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.
3. 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.).

1. 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.).
2. 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.

1. Créer un menu : Dans « Structure » → « Menus », ajoutez-en un nouveau ou modifiez les existants.
2. 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...).

1. 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.
2. 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 fichier php.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.