Installer et configurer Contao CMS dans l’environnement ServBay

Contao est un système de gestion de contenu (CMS) open source puissant, particulièrement adapté à la création de sites pour PME, de portails ou d’applications web avancées. Ce guide vous explique en détail comment installer et configurer Contao dans l’environnement local pratique ServBay sous macOS afin de rapidement lancer votre projet Contao.

ServBay fournit un environnement tout-en-un intégrant PHP, Composer, des services de base de données (tels que MySQL/MariaDB, PostgreSQL) ainsi que des serveurs web (comme Caddy, Nginx, Apache). Cela simplifie grandement la mise en place d’un environnement de développement local. Grâce à ServBay, satisfaire aux exigences techniques de Contao devient aisé.

Qu’est-ce que Contao ?

Contao est un CMS open source basé sur PHP, reconnu pour sa convivialité, sa flexibilité et sa puissante interface d’administration. Il offre de nombreuses fonctionnalités : gestion fine des droits d’accès, contrôle de versions, support multilingue, gestion des images responsives et une architecture modulaire facilitant l’ajout de nouvelles fonctions via des extensions. La philosophie de Contao est de fournir une base solide permettant aux développeurs et designers de réaliser des sites personnalisés sans avoir à repartir de zéro.

Prérequis

Avant de commencer, assurez-vous de remplir les conditions suivantes :

1. ServBay est installé et lancé : Vous devez avoir installé ServBay sur macOS. Vérifiez que ServBay fonctionne, et que la version PHP requise (consultez la documentation officielle de Contao pour la version recommandée) ainsi que les services de base de données (MySQL ou MariaDB, par exemple) sont bien activés dans ServBay.
2. Composer : Composer est intégré par défaut à ServBay. Aucune installation additionnelle n’est nécessaire.
3. Accès au terminal : Vous devez pouvoir utiliser le terminal pour exécuter les commandes Composer.

Étapes pour installer Contao

Cette section vous guidera pas à pas dans l’installation et la configuration de Contao dans l’environnement ServBay.

Étape 1 : Créer le répertoire du projet

Naviguez dans le répertoire racine de ServBay, par défaut /Applications/ServBay/www, et créez un dossier pour votre projet Contao.

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

Contao sera installé dans le dossier servbay-contao-app.

Étape 2 : Créer un projet Contao avec Composer

L’installation et la gestion de Contao se font idéalement via Composer. ServBay dispose déjà de Composer : lancez simplement cette commande dans votre dossier projet :

composer create-project contao/managed-edition .

Cette commande télécharge la dernière version de Contao Managed Edition et toutes ses dépendances dans le dossier courant (.). Cette opération peut durer quelques minutes en fonction de votre connexion Internet.

À propos de la Managed Edition : contao/managed-edition est la version officielle packagée de Contao, comprenant le cœur du CMS, les dépendances recommandées et une structure standard prête à l’emploi. Notez que lorsque vous utilisez cette édition, le dossier racine accessible du site sera le sous-dossier web de votre projet.

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

Contao nécessite une base de données pour stocker ses contenus et configurations. ServBay fournit des outils de gestion des bases comme phpMyAdmin ou Adminer. Prenons ici l’exemple de phpMyAdmin :

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

   Ouvrez ServBay à l’adresse locale https://servbay.host/. Recherchez et cliquez sur le lien menant à phpMyAdmin.

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

   Par sécurité, il est conseillé de créer un utilisateur dédié pour l’application Contao.

   a. Accéder à la page des comptes utilisateurs

   Depuis la page d’accueil de phpMyAdmin, cliquez sur « Comptes utilisateurs » dans la barre du haut.
   

   b. Ajouter un nouvel utilisateur

   Cliquez sur « Ajouter un utilisateur ». Renseignez les champs suivants :
   
   *   **Nom d’utilisateur :** choisissez un nom pour la connexion à la base, par exemple `contao_user`.
   *   **Hôte :** sélectionnez `localhost`. Cela limite l’accès à une connexion locale, pour plus de sécurité.
   *   **Mot de passe :** saisissez un **mot de passe fort**. (Évitez des mots de passe simples comme `password123`, même s’ils peuvent servir d’exemple ici. Utilisez un générateur pour obtenir un mot de passe complexe.)
   *   **Confirmation :** resaisissez votre mot de passe.
   
   Pour la section « Créer une base portant le nom d’utilisateur et accorder tous les privilèges », laissez cochée cette option : elle créera une base de données nommée `contao_user` et y attribuera tous les droits à ce nouvel utilisateur.
   
   *   Assurez-vous de cocher « Accorder tous les privilèges ».
   *   Cliquez sur « Exécuter » en bas pour valider la création.
   

Étape 4 : Configurer le site dans ServBay

Configurez maintenant un site dans ServBay pointant sur le dossier de votre projet Contao.

1. Ouvrir ServBay et ajouter un nouveau site

   Lancez l’application ServBay. Dans la barre latérale, sélectionnez l’onglet « Sites », puis cliquez sur « Ajouter » pour créer une nouvelle configuration de site.

2. Compléter la configuration du site

   • Nom : Donnez un nom facile à reconnaître, comme Mon site Contao.
   • Domaine : Indiquez un nom de domaine local, idéalement en .local ou .servbay.demo, par exemple servbay-contao.local. ServBay gérera la résolution du domaine vers votre machine.
   • Type de site : Sélectionnez PHP.
   • Version PHP : Choisissez la version conforme aux exigences de Contao (consultez la documentation officielle).
   • Racine du site : Étape cruciale. Pour une installation avec contao/managed-edition, les fichiers publics, y compris index.php, sont dans le dossier web de votre projet. Saisissez donc le chemin absolu : /Applications/ServBay/www/servbay-contao-app/web.

3. Sauvegarder la configuration

   Après avoir renseigné tous les champs, cliquez sur « Enregistrer » en bas. ServBay applique immédiatement la nouvelle configuration de site.

Étape 5 : Lancer l’assistant d’installation web de Contao

Votre site étant configuré, accédez au domaine configuré avec le chemin /contao/install pour démarrer l’installation web de Contao.

1. Se rendre sur la page d’installation

   Depuis votre navigateur, allez sur le domaine de votre site suivi de /contao/install, par exemple : https://servbay-contao.local/contao/install.

   Si la configuration est correcte, la page d’installation de Contao devrait s’afficher.

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

   L’assistant demande les identifiants de connexion à la base : reprenez ceux créés à l’étape 3 :

   • Hôte de la base de données : localhost
   • Nom de la base : contao_user (si la base a été créée avec le même nom que l’utilisateur)
   • Nom d’utilisateur : contao_user
   • Mot de passe : votre mot de passe défini à l’étape 3.

3. Renseigner les informations administrateur

   Suivez les instructions : créez le compte administrateur de l’interface Contao : nom d’utilisateur, mot de passe robuste, email, etc.

4. Finaliser l’installation

   Poursuivez les étapes : installation des tables de la base de données, configuration finale. Cliquez sur les boutons appropriés pour terminer le processus.

Étape 6 : Vérifier l’installation et se connecter à l’administration

L’installation terminée, vérifiez que Contao fonctionne et accédez à son interface d’administration.

1. Accéder au site en frontend

   Rendez-vous sur le domaine configuré, par exemple : https://servbay-contao.local/. Vous devriez voir la page d’accueil par défaut de Contao, ou une page vide selon la configuration. Cela signifie que le serveur web fonctionne et que Contao est accessible.

2. Accéder au back-office Contao

   Accédez à la page de connexion de l’administration, généralement https://servbay-contao.local/contao.

   Connectez-vous avec le nom d’utilisateur et le mot de passe de l’administrateur créés à l’étape 5. Une fois connecté, vous pourrez créer des contenus, installer des extensions et configurer votre site.

FAQ (Questions fréquentes)

Q : Que faire si j’obtiens une erreur en accédant à https://servbay-contao.local/ ou https://servbay-contao.local/contao/install ?

R :

• Vérifiez que ServBay fonctionne bien : Assurez-vous que l’application, PHP et le serveur web (Caddy ou Nginx) sont lancés.
• Vérifiez la configuration du site dans ServBay : Relisez soigneusement les réglages : domaine, type de site, version PHP, et surtout la racine du site (pour contao/managed-edition, elle doit pointer vers web).
• Vérifiez la résolution DNS : ServBay gère automatiquement les domaines en .local. En cas de souci, redémarrez ServBay ou examinez le fichier hosts de votre système (normalement géré par ServBay).
• Consultez les logs du serveur web : Jetez un œil aux logs de Caddy ou Nginx dans ServBay pour des détails sur l’erreur.

Q : Que faire si la connexion à la base échoue ?

R :

• Vérifiez que la base de données est active : Le service MySQL/MariaDB ou PostgreSQL doit être lancé dans ServBay.
• Vérifiez les identifiants : Vérifiez soigneusement l’hôte (localhost), le nom de la base, le nom d’utilisateur et le mot de passe.
• Vérifiez les droits de l’utilisateur en base : L’utilisateur créé doit avoir tous les droits sur la base Contao.

Q : Que faire si j’ai une erreur de droits d’accès lors de l’installation ?

R : L’assistant Contao doit pouvoir écrire dans certains dossiers. Si nécessaire, appliquez ces commandes dans le terminal sur le dossier du projet :

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # Remplacez your_username par votre nom d’utilisateur macOS
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao requiert l’écriture dans ces dossiers

Attention avec chmod 777 : à n’utiliser qu’en local pour dépanner, jamais en production. Cela permet de résoudre temporairement les problèmes de droits.

Conclusion

En suivant ce guide, vous aurez installé et configuré avec succès Contao CMS dans ServBay sur votre environnement local. L’approche intégrée de ServBay facilite la gestion des dépendances via Composer, la configuration de la base de données et du serveur web, vous permettant de vous concentrer sur le développement de votre projet Contao. Vous pouvez dès à présent créer des contenus, dessiner vos pages, installer des extensions et thèmes depuis l’administration, et bâtir votre site !

Pour en savoir plus sur l’utilisation et les fonctionnalités de Contao, consultez la documentation officielle Contao.