Installer et configurer OctoberCMS dans l’environnement ServBay

Présentation

OctoberCMS est un système de gestion de contenu (CMS) open source, construit sur le puissant framework Laravel, réputé pour sa simplicité, sa flexibilité et son orientation développeur. Ce document a pour but de vous guider dans l'installation et la configuration réussies d’OctoberCMS au sein de ServBay — une solution tout-en-un destinée au développement Web local sur macOS — afin que vous puissiez rapidement démarrer vos projets basés sur OctoberCMS.

Qu’est-ce qu’OctoberCMS ?

OctoberCMS offre une interface d’administration intuitive et de puissantes capacités de développement frontal, permettant aux développeurs d’utiliser les concepts familiers de Laravel (comme Eloquent ORM, le moteur de templates Blade, etc.) pour créer tout type de site web, du simple blog à la plateforme d'entreprise complexe.

Prérequis

Avant de commencer l’installation d’OctoberCMS, assurez-vous de remplir les conditions suivantes :

1. ServBay est installé et fonctionne sur votre système macOS.
2. Les paquets PHP (version 7.4 ou supérieure recommandée) et MySQL/MariaDB sont activés et en cours d’exécution dans ServBay.
3. Le paquet Composer est activé dans ServBay.
4. Vous possédez des connaissances de base en ligne de commande.

Étapes d’installation d’OctoberCMS

Voici le détail des étapes pour installer et configurer OctoberCMS dans l’environnement ServBay :

Étape 1 : Créer le dossier du projet

Commencez par vous rendre dans le répertoire racine suggéré par ServBay pour les sites Web, à savoir /Applications/ServBay/www. Créez ensuite un nouveau dossier pour votre projet OctoberCMS.

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

Étape 2 : Installer OctoberCMS via Composer

Composer est déjà intégré et configuré avec ServBay, assurez-vous simplement que le paquet Composer est activé depuis le panneau de contrôle ServBay. Exécutez maintenant la commande Composer suivante dans votre nouveau dossier pour télécharger et installer les fichiers principaux d’OctoberCMS :

composer create-project october/october .

Cette commande télécharge la dernière version d’OctoberCMS depuis le dépôt officiel dans le répertoire courant (.).

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

OctoberCMS nécessite une base de données pour stocker le contenu, les utilisateurs, les paramètres, etc. Nous utiliserons l’outil phpMyAdmin intégré à ServBay pour créer la base de données ainsi que l'utilisateur associé.

1. Accéder à phpMyAdmin fourni par ServBay

   Ouvrez votre navigateur et accédez au panneau de développement local de ServBay : https://servbay.host/. Cliquez ou naviguez vers le lien phpMyAdmin de ServBay, généralement https://servbay.host/phpmyadmin/, afin d’ouvrir l’outil d’administration des bases de données.

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

   Par sécurité et pour l’isolation, il est conseillé de créer un utilisateur et une base spécifique pour chaque application.

   1. Accéder à la page des comptes utilisateurs

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

   2. Ajouter un nouvel utilisateur

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

      • Nom d'utilisateur : Choisissez un nom d'utilisateur pour la connexion d’OctoberCMS à la base, par exemple october_user.
      • Hôte : Sélectionnez localhost ou 127.0.0.1, ce qui limite les connexions à la machine locale pour plus de sécurité.
      • Mot de passe : Saisissez un mot de passe fort et unique. N’utilisez jamais le mot de passe password123 en production.
      • Retaper : Saisissez à nouveau le mot de passe choisi.
      • Dans la section « Créer une base de données pour l'utilisateur », cochez « Créer une base de données portant le même nom et accorder tous les privilèges » pour générer automatiquement une base october_user et attribuer tous les droits à l’utilisateur du même nom.
      • Vérifiez que l’option « Accorder tous les privilèges » dans les « Privilèges globaux » est activée (normalement coché automatiquement si vous créez la base en même temps).
      • Cliquez sur le bouton « Exécuter » en bas de page pour terminer la création.

Étape 4 : Configurer le serveur Web (ajouter un site dans ServBay)

Pour pouvoir accéder à votre application OctoberCMS via le navigateur, configurez un site local dans ServBay.

1. Ajouter un nouveau site

   Dans le panneau de contrôle ServBay, sélectionnez l’onglet « Sites » dans la barre latérale gauche (attention : sur d’anciennes versions cela peut apparaître sous « Hôtes »). Cliquez sur le bouton « Ajouter un site ».

   Renseignez les informations suivantes :

   • Nom : Un nom facile à reconnaître, par exemple My OctoberCMS Site.
   • Nom de domaine : Indiquez le domaine local souhaité, par exemple servbay-octobercms.local. Utilisez le suffixe .local pour éviter les collisions de domaines réels.
   • Type de site : Choisissez PHP.
   • Version PHP : Sélectionnez la version PHP désirée, qui doit correspondre à la version activée dans ServBay et aux prérequis d’OctoberCMS.
   • Racine du site : Cliquez sur parcourir et sélectionnez le dossier créé à l’étape 1, soit /Applications/ServBay/www/servbay-octobercms-app.

2. Enregistrer la configuration et redémarrer ServBay

   Après avoir saisi les informations, cliquez sur « Enregistrer ». ServBay vous demandera d’appliquer les changements, ce qui nécessite généralement de redémarrer certains paquets (Caddy ou Nginx, et parfois ServBay lui-même). Suivez les instructions à l’écran pour prendre en compte les modifications. Le domaine servbay-octobercms.local sera automatiquement lié à l’adresse locale (127.0.0.1).

Étape 5 : Configurer les variables d’environnement d’OctoberCMS

OctoberCMS (comme tout projet Laravel) utilise un fichier .env pour la gestion des variables d’environnement, notamment les informations de connexion à la base de données et la clé de l'application.

1. Copier le modèle de configuration d’environnement

   Depuis le dossier racine du projet (/Applications/ServBay/www/servbay-octobercms-app), copiez le fichier .env.example sous le nom .env :

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. Éditer le fichier .env

   Ouvrez le fichier .env avec votre éditeur de texte favori. Repérez les paramètres de connexion à la base de données et modifiez-les selon les détails saisis à l’étape 3 :

   # ... autres paramètres ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Remplacez par le nom de la base créée
   DB_USERNAME=october_user  # Remplacez par le nom d'utilisateur créé
   DB_PASSWORD=password123   # Remplacez par le mot de passe choisi
   
   # ... autres paramètres ...

   Important : Veillez à bien remplacer DB_DATABASE, DB_USERNAME et DB_PASSWORD par les valeurs réellement utilisées à l’étape 3.

Étape 6 : Lancer l’assistant d’installation d’OctoberCMS

OctoberCMS propose un assistant d’installation Web pour finaliser la configuration, comprenant les migrations de base de données et la création du compte administrateur.

1. Accéder à la page d’installation

   Ouvrez le navigateur et accédez au domaine local saisi à l’étape 4, en ajoutant le chemin /install.php. Par exemple :

   https://servbay-octobercms.local/install.php

   Vous devriez voir apparaître la page de l’assistant d’installation d’OctoberCMS.

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

   L’assistant vous demandera les identifiants de connexion à la base. Saisissez les mêmes valeurs que dans le fichier .env :

   • Type de base : MySQL
   • Hôte de la base : localhost ou 127.0.0.1
   • Nom de la base : october_user
   • Nom d'utilisateur : october_user
   • Mot de passe : password123

   (Encore une fois, utilisez votre vrai mot de passe sélectionné précédemment)

3. Renseigner les informations administrateur

   Complétez les informations pour le compte administrateur qui servira à vous connecter au back-office d’OctoberCMS (identifiant, mot de passe, email, etc.).

4. Finaliser l’installation

   Cliquez sur « Installer » (ou le bouton équivalent sur la page). L’installateur effectuera les migrations et génèrera la clé de l’application. Patientez le temps de l’opération.

Étape 7 : Installer des plugins et thèmes (optionnel)

Après l’installation, vous pouvez vous connecter à l’interface d’administration d’OctoberCMS (https://servbay-octobercms.local/backend).

1. Installer des plugins

   Depuis l’admin, rendez-vous dans « Système » -> « Mises à jour » -> « Plugins ». Parcourez et installez les plugins du Marketplace OctoberCMS selon vos besoins.

2. Installer un thème

   Allez dans « Système » -> « Mises à jour » -> « Thèmes ». Parcourez et sélectionnez un thème adapté à votre projet.

Configuration de base et navigation après installation

Après la réussite de l’installation d’OctoberCMS, vous pouvez commencer à construire votre site. Voici quelques actions courantes de prise en main :

• Accéder au site public : Rendez-vous sur votre domaine local, https://servbay-octobercms.local/, pour découvrir la page d’accueil (généralement avec le thème par défaut).
• Accéder à l’admin: Rendez-vous sur https://servbay-octobercms.local/backend et connectez-vous avec le compte administrateur créé à l’installation.
• Créer une page : Naviguez dans le back-office vers « CMS » -> « Pages » pour créer et modifier vos pages web.
• Créer un bloc de contenu : Dans l’admin, rendez-vous dans « CMS » -> « Contenu » pour gérer les fragments de contenu réutilisables.
• Configurer le thème : Sous « CMS » -> « Thèmes », ajustez le thème actif, la mise en page, les composants, etc.
• Gérer utilisateurs et droits : Sous « Système » -> « Gestion », administrez les utilisateurs du back-office et leurs permissions.

Questions fréquentes (FAQ)

• Q : Je vois la page par défaut ServBay ou une erreur en allant sur servbay-octobercms.local ?
  • R : Vérifiez que le site servbay-octobercms.local a bien été ajouté depuis le panneau ServBay et que le dossier racine est bien /Applications/ServBay/www/servbay-octobercms-app. Après modification de la configuration, assurez-vous d’avoir redémarré ServBay pour appliquer les changements. Confirmez aussi que Caddy/Nginx et les paquets PHP sont bien en cours d’exécution.
• Q : La page https://servbay-octobercms.local/install.php est vide ou en erreur ?
  • R : Il s’agit généralement d’une erreur PHP. Consultez les logs d’erreur PHP dans le panneau ServBay pour identifier le problème. Causes courantes : droits d’accès insuffisants (vérifiez que les dossiers storage, themes, plugins et leurs sous-dossiers sont accessibles en écriture par le serveur Web), version PHP inadaptée, extensions PHP manquantes.
• Q : Erreur de connexion à la base lors de l’installation ?
  • R : Vérifiez soigneusement la correspondance entre les informations de connexion au sein du .env (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) et les données créées dans phpMyAdmin. Assurez-vous que MySQL/MariaDB fonctionne dans ServBay.
• Q : Échec de la commande composer create-project ?
  • R : Vérifiez que Composer est bien activé depuis le panneau ServBay et que le bon paquet PHP est en route. Assurez-vous également que votre connexion Internet est fonctionnelle, nécessaire pour le téléchargement via Composer.

Conclusion

Grâce à l’environnement complet proposé par ServBay, vous pouvez installer et configurer OctoberCMS rapidement et facilement sur macOS. En suivant attentivement les étapes de ce guide, vous obtiendrez une plateforme locale puissante et adaptée pour le développement Web moderne sous OctoberCMS. Il ne vous reste plus qu’à explorer les nombreuses fonctionnalités et à concevoir des sites web exceptionnels !