Installer et configurer Craft CMS dans l’environnement ServBay

Vue d’ensemble

Craft CMS est un système de gestion de contenu (CMS) puissant, apprécié des développeurs pour sa modélisation de contenu flexible, son interface utilisateur intuitive et ses fonctionnalités conviviales pour les développeurs. Il est particulièrement adapté à la création de sites web complexes et personnalisés.

Utiliser ServBay comme environnement de développement local pour Craft CMS offre de nombreux avantages : PHP, bases de données (MySQL ou PostgreSQL) et serveurs web (Caddy ou Nginx) préconfigurés, ainsi que Composer et des outils en ligne de commande intégrés, ce qui simplifie grandement l’installation et la configuration.

Ce guide décrit pas à pas comment installer et configurer un projet Craft CMS dans l’environnement ServBay.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

1. ServBay installé et démarré : Vérifiez que ServBay est installé sur votre macOS, que la version de PHP requise (consultez la documentation officielle de Craft CMS) et les paquets nécessaires de base de données (généralement MySQL ou PostgreSQL) sont lancés. ServBay prend en charge plusieurs versions de PHP et plusieurs bases de données, que vous pouvez facilement basculer et configurer selon les besoins de Craft CMS.
2. Connaître les bases de la ligne de commande : Vous aurez besoin d’utiliser le terminal pour exécuter quelques commandes, comme créer des dossiers ou lancer Composer.
3. Comprendre Composer : Craft CMS gère ses dépendances via Composer. ServBay intègre déjà Composer, mais vous devez savoir comment exécuter la commande composer create-project.

Étapes pour installer Craft CMS

Voici les étapes détaillées pour installer et configurer Craft CMS dans ServBay.

Étape 1 : Créez le dossier du projet

Dans le répertoire racine web par défaut de ServBay (/Applications/ServBay/www), créez d’abord votre nouveau dossier de projet. Ce répertoire est déjà configuré comme racine web sur ServBay, ce qui permet un accès direct à vos projets.

Ouvrez le Terminal et exécutez :

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

Cela crée un nouveau dossier appelé servbay-craft-app dans /Applications/ServBay/www et vous y place directement.

Étape 2 : Créez le projet Craft CMS via Composer

Composer étant préinstallé dans ServBay, vous pouvez créer directement votre projet Craft CMS depuis ce dossier. L’équipe Craft CMS recommande officiellement cette méthode.

Dans le dossier servbay-craft-app, lancez :

composer create-project craftcms/craft .

Cette commande télécharge la dernière version de Craft CMS et toutes ses dépendances dans le dossier courant (.). Patientez jusqu'à la fin du processus.

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

Craft CMS a besoin d’une base de données pour stocker le contenu et les paramètres de configuration. Utilisons phpMyAdmin ou Adminer intégrés à ServBay pour créer la base de données et l’utilisateur associé. Ici, nous prendrons phpMyAdmin comme exemple.

1. Accédez à l’outil de gestion de base de données (phpMyAdmin) fourni par ServBay

   Ouvrez votre navigateur et allez sur le panneau de développement local de ServBay https://servbay.host/. Trouvez et cliquez sur le lien « phpMyAdmin » pour accéder à l’outil de gestion.

   Astuce : L’utilisateur par défaut de phpMyAdmin dans ServBay est généralement root, avec le mot de passe ServBay.dev. Pour la sécurité, il est conseillé de changer le mot de passe de root ou de créer un nouvel utilisateur administrateur rapidement après la connexion.

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

   Bien qu’il soit possible de connecter Craft CMS avec l’utilisateur root, il est recommandé, pour des raisons de sécurité et de gestion des droits, de créer un utilisateur dédié à chaque application.

   1. Accédez à la gestion des comptes utilisateurs

      Sur la page d’accueil de phpMyAdmin, cliquez sur « Comptes utilisateurs » dans le menu en haut.

   2. Ajoutez un nouvel utilisateur

      Cliquez sur « Ajouter un compte utilisateur ». Remplissez les informations suivantes :

      • Nom d’utilisateur : Saisissez un nom pour l’utilisateur dédié à Craft CMS, par exemple craft_user.
      • Hôte : Choisissez localhost ou 127.0.0.1 pour limiter la connexion à la machine locale.
      • Mot de passe : Entrez un mot de passe sécurisé. N’utilisez jamais un exemple comme password123 en production. Pour le développement local, un mot de passe simple peut être toléré, mais la sécurité reste essentielle.
      • Confirmez : Retapez le mot de passe pour confirmation.
      • Dans la section « Créer une base de données du même nom et appliquer tous les privilèges », cochez cette option. Cela crée automatiquement une base craft_user avec tous les droits pour l’utilisateur craft_user.
      • Assurez-vous que l’option « Donner tous les privilèges » est sélectionnée.
      • Cliquez sur « Exécuter » en bas de la page.

   Votre nouvel utilisateur craft_user et la base de données portant le même nom sont à présent prêts, avec tous les droits nécessaires.

Étape 4 : Configurez le serveur web (création du site dans ServBay)

Pour que le serveur web de ServBay (Caddy ou Nginx) puisse servir votre projet Craft CMS, vous devez ajouter une configuration de « site web » dans ServBay.

1. Ouvrez l’application ServBay

   Lancez ServBay.

2. Ajoutez un nouveau site

   Cliquez sur l’onglet « Sites » dans la barre de navigation à gauche (Certains anciens ServBay affichent « Hôtes »). Cliquez sur le bouton « + » ou sur « Ajouter un site web ».

   Remplissez les champs suivants :

   • Nom (Name) : Donnez un nom facilement identifiable, par exemple Mon Site Craft.
   • Domaines (Domains) : Entrez le domaine que vous souhaitez utiliser en local, par exemple servbay-craft.local. ServBay configure automatiquement le DNS local pour permettre un accès direct via ce domaine.
   • Type de site (Type) : Sélectionnez PHP.
   • Version PHP (PHP Version) : Choisissez la version de PHP compatible, confirmée dans les prérequis. ServBay permet d’installer et d’utiliser simultanément différentes versions de PHP.
   • Racine du site (Website Root) : Cette étape est cruciale. Les fichiers du site accessibles publiquement (dont index.php) sont dans le sous-dossier web de votre projet. Pour des raisons de sécurité, la racine du serveur web doit pointer uniquement vers ce dossier, et non pas le répertoire racine du projet entier. Indiquez donc : /Applications/ServBay/www/servbay-craft-app/web Vérifiez bien que le chemin pointe sur le dossier web du projet créé à l’étape 1.

3. Enregistrez la configuration

   Cliquez sur « Enregistrer » pour valider. ServBay recharge sa configuration et active le nouveau site web. Vous retrouverez servbay-craft.local dans la liste des sites.

Étape 5 : Lancez l’installation de Craft CMS

Vous pouvez maintenant lancer l’installateur web de Craft CMS depuis votre navigateur.

1. Rendez-vous sur la page d’installation

   Allez à l’adresse configurée, par exemple https://servbay-craft.local/. Craft CMS détectera qu’aucune installation n’a encore été effectuée et redirigera automatiquement vers la page d’installation, généralement https://servbay-craft.local/index.php?p=admin/install.

2. Entrez les informations de connexion à la base de données

   Lors de l’étape de configuration de la base dans Craft CMS, indiquez les données suivantes :

   • Serveur de base de données : localhost
   • Nom de la base : craft_user (ou le nom choisi à l’étape 3)
   • Nom d’utilisateur : craft_user (ou celui de l’étape 3)
   • Mot de passe : Le mot de passe défini pour craft_user à l’étape 3.

   Cliquez sur « Continuer ». Craft CMS testera la connexion. Si elle est correcte, passez à l’étape suivante.

3. Créez le compte administrateur

   Suivez les instructions pour définir votre compte administrateur Craft CMS : nom d’utilisateur, mot de passe et e-mail. Veillez à choisir un mot de passe solide.

   Passez à l’étape suivante.

4. Paramètres du site

   Remplissez les informations de base (nom du site, etc.).

   Cliquez sur « Terminer l’installation (Finish Up) ». Craft CMS finalisera en créant les tables et en générant les fichiers de configuration.

   Une fois l’installation terminée, vous êtes redirigé vers la page de connexion à l’admin.

Étape 6 : Première configuration et prise en main

Après connexion à l’administration de Craft CMS, vous pouvez effectuer les premières configurations et explorer les fonctionnalités :

1. Vérifiez le fichier .env : Craft CMS gère les variables d’environnement, dont la connexion à la base, via ce fichier généré automatiquement à la racine du projet (servbay-craft-app/). Vous pouvez éditer ses valeurs, par exemple pour mettre CRAFT_ENVIRONMENT=dev.
2. Installer des plugins : Depuis l’admin, rubrique « Plugins », vous pouvez parcourir, installer et gérer des extensions pour enrichir Craft CMS.
3. Définir la structure de contenu : Explorez la rubrique « Paramètres » pour créer vos champs personnalisés, sections, catégories, tags, etc.
4. Configurer l’envoi d’e-mails : Pour tester les emails en local, configurez Craft CMS pour utiliser Mailpit ou Mailhog intégrés à ServBay. Dans .env ou dans l’admin, renseignez l’envoi SMTP, généralement avec serveur localhost et le port affiché pour Mailpit/Mailhog sur le panneau ServBay.

FAQ (Foire Aux Questions)

• Q : Que faire si une erreur de connexion à la base de données apparaît à l’installation ?
  • R : Vérifiez que l’adresse du serveur (localhost), le nom de la base, l’utilisateur et le mot de passe renseignés correspondent exactement à ceux créés dans phpMyAdmin. Assurez-vous que les services base de données (MySQL ou PostgreSQL) sont bien démarrés dans ServBay.
• Q : J’obtiens une page 404 ou blanche en accédant à servbay-craft.local ?
  • R :
    • Vérifiez que la « racine du site » renseignée dans ServBay pointe EXACTEMENT sur /Applications/ServBay/www/servbay-craft-app/web. C’est l’erreur la plus courante.
    • Assurez-vous que les services web (Caddy/Nginx) et PHP sont bien actifs dans ServBay.
    • Vérifiez dans la liste ServBay que le site servbay-craft.local est bien activé.
• Q : Composer est très lent ou échoue lors de l’installation de Craft CMS ?
  • R : Cela peut provenir du réseau ou des sources des miroirs Composer. Essayez de basculer Composer sur un miroir plus rapide (par ex. miroir Alibaba Cloud ou Packagist China).
• Q : Après installation, l’admin ou le site n’a pas de styles, ou les images n’apparaissent pas ?
  • R : Cela provient souvent des droits d’écriture sur le système de fichiers. Vérifiez que l’utilisateur qui exécute ServBay a bien accès en écriture sur les dossiers storage et web/cpresources. ServBay gère normalement les permissions automatiquement, mais n’hésitez pas à les vérifier ou à les réinitialiser si besoin.

Conclusion

En suivant les étapes ci-dessus, vous devriez avoir réussi à installer et configurer Craft CMS dans l’environnement de développement local ServBay. L’approche intégrée de ServBay simplifie la gestion des versions de PHP, les bases de données et la configuration du serveur web, ce qui vous permet de vous concentrer sur le développement de votre application Craft CMS. Vous pouvez désormais profiter de la puissance de Craft CMS pour modéliser et créer votre site ou application sur-mesure.