Installer et configurer ExpressionEngine CMS dans l’environnement local ServBay

Aperçu

ExpressionEngine est un système de gestion de contenu (CMS) puissant et flexible, largement utilisé pour la création de sites web et d’applications Web complexes. Il offre de nombreuses fonctionnalités de base et une architecture hautement modulaire qui permet aux développeurs et designers de concevoir des sites à la fois personnalisés et adaptés à leurs besoins.

ServBay est une solution tout-en-un spécialement conçue pour macOS, offrant un environnement de développement Web local convivial. Il intègre plusieurs serveurs Web populaires (tels que Nginx, Caddy, Apache), des environnements d’exécution de langages (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), des bases de données (MySQL, PostgreSQL, MongoDB, Redis) ainsi que des outils pour développeurs (Composer, npm/yarn, phpMyAdmin/Adminer). Grâce à ServBay, les développeurs créent et gèrent très simplement leur environnement de développement local.

Ce guide décrit en détail comment installer et configurer ExpressionEngine dans l’environnement ServBay, afin de lancer rapidement votre projet ExpressionEngine.

Pourquoi choisir ServBay pour installer ExpressionEngine ?

Installer ExpressionEngine en local avec ServBay présente de nombreux avantages :

• Environnement intégré : ServBay regroupe tous les composants nécessaires à ExpressionEngine, tels que PHP, MySQL et un serveur Web — inutile d’installer et de configurer séparément chaque élément.
• Support multi-versions : Il est facile de choisir ou de basculer entre les différentes versions de PHP selon les exigences de la version d’ExpressionEngine à utiliser.
• Gestion aisée de la base de données : ServBay intègre phpMyAdmin ou Adminer pour faciliter la création et la gestion de la base de données nécessaire à ExpressionEngine.
• Configuration rapide du site local : L’interface graphique de ServBay permet de créer simplement un site local pointant vers le répertoire de votre projet ExpressionEngine.
• Isolation et gestion des projets : Chaque projet peut bénéficier de sa propre configuration de site, évitant ainsi les conflits entre environnements différents.

Prérequis

Avant de commencer, veuillez vérifier que vous remplissez les conditions suivantes :

1. ServBay est déjà installé et opérationnel sur votre système macOS. Si ce n’est pas le cas, rendez-vous sur le site officiel de ServBay pour obtenir le guide d’installation.
2. Vous avez des notions de base sur l’utilisation du terminal en ligne de commande.
3. Vous comprenez les concepts fondamentaux relatifs aux bases de données (comme base, utilisateur).
4. Le dossier racine par défaut de ServBay /Applications/ServBay/www est accessible en écriture.

Étapes d’installation

Nous installerons et configurerons ExpressionEngine dans ServBay en suivant les étapes ci-dessous.

Étape 1 : Préparer le dossier du projet et télécharger ExpressionEngine

Commencez par ouvrir votre terminal. Rendez-vous dans le répertoire racine du site de ServBay /Applications/ServBay/www, créez un nouveau dossier pour votre projet (ex. servbay-ee-app), puis accédez à ce dossier.

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

Ensuite, utilisez la commande curl pour télécharger la dernière version d’ExpressionEngine dans le dossier courant. L’option -L suit les redirections et -o spécifie le nom du fichier de sortie.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Étape 2 : Décompresser les fichiers d’ExpressionEngine

Une fois le téléchargement terminé, exécutez la commande unzip pour extraire le fichier expressionengine.zip dans le dossier servbay-ee-app. Vous pouvez ensuite supprimer le fichier compressé.

unzip expressionengine.zip
rm expressionengine.zip

Après extraction, la structure des fichiers d’ExpressionEngine sera visible dans le dossier servbay-ee-app.

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

ExpressionEngine a besoin d’une base de données pour stocker son contenu et sa configuration. ServBay inclut MySQL et phpMyAdmin pour faciliter la gestion des bases.

1. Accéder à l’outil phpMyAdmin intégré à ServBay

   Ouvrez votre navigateur et rendez-vous à l’adresse d’administration locale de ServBay : https://servbay.host/. Cliquez sur le lien « phpMyAdmin » afin d’ouvrir la page de connexion. Utilisez les identifiants par défaut de ServBay (habituellement, aucun mot de passe n’est requis pour accéder à localhost si vous n’avez rien modifié explicitement).

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

   Une fois connecté à phpMyAdmin, nous allons créer un utilisateur dédié ainsi qu’une base au même nom.

   • Aller sur la page des comptes utilisateurs : Sur la page d’accueil de phpMyAdmin, cliquez sur « Comptes d’utilisateurs » dans le menu principal.
   • Ajouter un nouvel utilisateur : Cliquez sur « Ajouter un compte utilisateur ».
   • Renseigner les informations :
     • Nom d’utilisateur : Saisissez, par exemple, ee_user pour la connexion d’ExpressionEngine.
     • Hôte : Choisissez localhost (connexion possible uniquement en local, pour plus de sécurité).
     • Mot de passe : Saisissez un mot de passe fort qui sera utilisé par ExpressionEngine pour se connecter à la base. Pensez à le retenir. Exemple pour la démonstration : password123, mais en production, choisissez un mot de passe complexe.
     • Retaper le mot de passe : Confirmez le mot de passe.
     • Créer une base avec le même nom : Cochez la case « Créer une base portant son nom et donner tous les privilèges » afin de générer un schéma ee_user et d’attribuer tous les droits à cet utilisateur.
   • Vérification des droits : Assurez-vous de ne pas accorder de privilèges globaux non nécessaires (les droits sur la base suffisent).
   • Valider : Cliquez sur le bouton en bas de page pour créer l’utilisateur et la base.

   Vous disposez désormais d’un utilisateur ee_user et d’une base de données portant le même nom, sur laquelle il possède tous les droits requis.

Étape 4 : Configurer le site dans ServBay

Nous allons maintenant configurer ServBay pour que les requêtes vers un nom de domaine local (ex. servbay-ee.local) dirigent vers votre dossier ExpressionEngine.

1. Ouvrir ServBay et ajouter un nouveau site

   Lancez l’interface graphique de ServBay. Dans la barre latérale gauche, sélectionnez « Sites ». Cliquez ensuite sur le bouton « + » ou « Ajouter » pour ajouter une nouvelle configuration.

   • Nom : Attribuez un nom clair à votre configuration, par exemple Mon site ExpressionEngine.
   • Domaine : Saisissez le domaine que vous souhaitez utiliser en local (ex. servbay-ee.local). ServBay ajoutera automatiquement ce domaine dans votre fichier hosts pour le faire pointer sur l’adresse locale (127.0.0.1).
   • Type de site : Sélectionnez PHP, car ExpressionEngine fonctionne sous PHP.
   • Version PHP : Choisissez la version compatible avec votre instance d’ExpressionEngine. ServBay propose plusieurs versions.
   • Racine du site : Cliquez sur Parcourir et sélectionnez le dossier du projet ExpressionEngine créé à l’étape 1, c’est-à-dire /Applications/ServBay/www/servbay-ee-app.
   • Serveur Web : Adoptez le serveur de votre choix (Nginx, Caddy, Apache). ServBay générera la configuration adéquate. Pour le développement local, les valeurs par défaut conviennent généralement.

2. Enregistrer et appliquer les modifications

   Après avoir tout renseigné, cliquez sur « Enregistrer » ou « Appliquer ». ServBay pourra redémarrer son serveur Web pour appliquer la modification. Suivez les indications et attendez que le système ait fini de redémarrer.

   Désormais, lorsque vous accéderez à https://servbay-ee.local/ dans votre navigateur, ServBay redirigera bien vers le dossier de votre projet ExpressionEngine.

Étape 5 : Lancer le programme d’installation Web d’ExpressionEngine

ExpressionEngine propose un installateur Web qui va vous guider dans la configuration finale.

1. Accéder à la page d’installation

   Dans le navigateur, ouvrez le domaine local configuré dans ServBay et ajoutez /admin.php à l’URL. Par défaut, l’installateur s’y trouve.

   Exemple d’adresse : https://servbay-ee.local/admin.php

   La page d’accueil ou l’assistant d’installation d’ExpressionEngine doit s’afficher.

2. Suivre les instructions de l’assistant

   Renseignez les informations demandées, en particulier :

   • Informations de connexion à la base de données :
     • Hôte de la base : localhost
     • Nom de la base : ee_user (le nom choisi à l’étape 3)
     • Nom d’utilisateur : ee_user (idem)
     • Mot de passe : saisissez celui utilisé lors de la création de l’utilisateur.
   • Informations du compte administrateur : Créez le compte super administrateur d’ExpressionEngine (nom d’utilisateur, mot de passe, adresse e-mail). Utilisez toujours un mot de passe fort.
   • Configuration du site : Renseignez le nom du site, l’URL, etc.

3. Finaliser l’installation

   Vérifiez soigneusement vos informations puis cliquez sur « Installer » dans l’assistant. ExpressionEngine créera les tables nécessaires et terminera la configuration initiale.

   Une fois l’installation achevée, vous serez généralement redirigé vers la page de connexion ou le tableau de bord d’administration.

Étape 6 : Premiers réglages post-installation

Après avoir installé le noyau d’ExpressionEngine, vous pouvez ajouter des plugins, des modèles ou ajuster les réglages de base selon vos besoins.

1. Connexion à l’interface d’administration d’ExpressionEngine

   Connectez-vous avec le compte administrateur créé lors de l’installation en allant sur https://servbay-ee.local/admin.php et en entrant vos identifiants.

2. Installer des plugins

   Dans le back-office, naviguez vers « Développeur » -> « Add-Ons » -> « Plugins ». Parcourez et installez les plugins adaptés à votre projet.

3. Créer et configurer les modèles (templates)

   Rendez-vous à « Design » -> « Templates ». Créez groupes et modèles, puis rédigez le code HTML/CSS/EE servant à afficher vos contenus.

Utiliser ExpressionEngine pour construire votre site

Vous venez d’installer et de configurer ExpressionEngine avec succès dans ServBay. Vous pouvez désormais l’utiliser pour gérer votre contenu. Voici quelques opérations de base pour bien débuter :

Créer des canaux et des entrées

L’élément central d’ExpressionEngine est le « canal » qui définit le type et la structure du contenu, tandis qu’une « entrée » en est une instance concrète.

1. Créer un canal : Dans le panneau d’administration, allez dans « Content Structure » -> « Channels ». Cliquez sur « Create New Channel », définissez le nom, sélectionnez le groupe de champs, etc., puis sauvegardez.
2. Créer une entrée : Naviguez vers « Content » -> « Publish ». Sélectionnez le canal créé, complétez le titre, les champs de contenu (selon la structure du canal), puis sauvegardez.

Configurer le menu de navigation

Le menu de navigation s’implémente généralement via des modèles (templates).

1. Créer ou modifier un modèle : Dans « Design » -> « Templates », trouvez ou créez un modèle destiné à la navigation (par exemple, un modèle nav dans un groupe site).
2. Écrire le code de navigation : Utilisez les tags de modèles ExpressionEngine pour lister les canaux, pages ou entrées et générer la structure HTML du menu.
3. Inclure la navigation dans la mise en page : Dans votre template principal, incluez le menu avec {% include 'site:nav' %} (si vous utilisez Blade) ou tout autre tag adéquat.

Personnaliser des widgets ou barres latérales

Même principe que pour la navigation : créez des modèles spécifiques pour les widgets et zones latérales.

1. Créer le template de widget : Depuis « Design » -> « Templates », créez le modèle destiné à afficher des contenus de widget (ex. site:sidebar).
2. Coder le widget : Affichez, par exemple, les entrées récentes, une liste de catégories, des publicités, etc.
3. Inclure les widgets dans les pages : Ajoutez l’inclusion du modèle de widget où souhaité dans vos layouts.

Questions fréquentes (FAQ)

• Question : Je reçois une erreur de permission en accédant à https://servbay-ee.local/. Que faire ?
  • Réponse : Vérifiez les droits sur le dossier du projet (/Applications/ServBay/www/servbay-ee-app) et ses sous-dossiers/fichiers. Assurez-vous que l’utilisateur exécutant ServBay (vous, en général) possède les droits de lecture/écriture. Vous pouvez corriger avec chmod ou chown, ex. : sudo chown -R votrenom:votregroupe /Applications/ServBay/www/servbay-ee-app.
• Question : L’assistant d’installation d’ExpressionEngine n’arrive pas à se connecter à la base de données ?
  • Réponse : Revérifiez toutes les informations saisies (hôte, base, utilisateur, mot de passe), elles doivent correspondre exactement à celles créées sous phpMyAdmin. Assurez-vous aussi que le service MySQL/MariaDB de ServBay tourne bien.
• Question : Puis-je utiliser une autre base de données de ServBay (comme PostgreSQL) ?
  • Réponse : ExpressionEngine ne prend officiellement en charge que MySQL/MariaDB. Si ExpressionEngine évolue pour supporter PostgreSQL, et que vous installez les pilotes nécessaires, alors, en théorie, vous pourrez utiliser le service PostgreSQL fourni par ServBay, mais cela dépend de la compatibilité propre à ExpressionEngine. Consultez la documentation officielle pour plus d’informations.

Conclusion

En suivant les étapes de ce guide, vous avez installé et configuré ExpressionEngine CMS dans l’environnement de développement local ServBay. ServBay offre une plateforme efficace et pratique pour le développement local avec ExpressionEngine grâce à l’intégration de tous les composants nécessaires. Vous pouvez désormais exploiter toute la puissance d’ExpressionEngine pour construire votre site ou application Web. Bon développement !