Installer et configurer Joomla CMS dans l'environnement ServBay sur macOS

Vue d'ensemble

Ce guide détaille comment installer et configurer le système de gestion de contenu Joomla (CMS) dans ServBay, un puissant environnement de développement web local. ServBay fournit un cadre intégré et pratique pour PHP, MySQL et d'autres technologies, idéal pour créer et tester des sites Joomla. Grâce à ServBay, vous pouvez facilement gérer différentes versions de PHP, bases de données et serveurs web (Caddy ou Nginx), offrant une base flexible et performante pour le développement Joomla.

Qu'est-ce que Joomla ?

Joomla est un système de gestion de contenu (CMS) open source largement utilisé, développé en PHP et s'appuyant généralement sur une base de données MySQL. Riche en fonctionnalités et hautement extensible, il est adapté aussi bien à la création de blogs personnels, de sites de PME, qu'à des portails d'entreprise ou des plateformes e-commerce de grande envergure. Joomla bénéficie d'une large communauté, de nombreux modules et modèles, facilitant le développement, la gestion et la maintenance des sites web.

Cas d'utilisation

• Développer, tester ou déboguer un site Joomla en local dans ServBay.
• Apprendre à utiliser Joomla et explorer ses extensions.
• Travailler sur des projets Joomla en mode hors-ligne.
• Préparer vos configurations Joomla pour un futur déploiement en production.

Prérequis

Avant de commencer l'installation de Joomla, assurez-vous de remplir les conditions suivantes :

1. ServBay est installé et en cours d'exécution : Vérifiez que ServBay est correctement installé et démarré sur macOS. ServBay fournit l'environnement nécessaire (PHP, serveur web – Caddy ou Nginx –, base de données – MySQL ou MariaDB).
2. Connaissances de base en ligne de commande : L'installation implique l'exécution de certaines commandes dans le Terminal.
3. Connexion Internet : Une connexion est nécessaire pour télécharger le paquet d'installation de Joomla.

Étapes pour installer Joomla

Suivez les étapes ci-dessous pour installer et configurer Joomla dans votre environnement ServBay.

Étape 1 : Télécharger Joomla

Commencez par vous rendre dans le dossier racine recommandé par ServBay pour vos sites web : /Applications/ServBay/www. C'est un emplacement centralisé et pratique pour stocker vos projets locaux. Créez-y un nouveau dossier projet pour votre site Joomla, puis téléchargez l'archive d'installation de Joomla.

# Accéder au dossier racine des sites de ServBay
cd /Applications/ServBay/www

# Créer un nouveau dossier projet, par exemple servbay-joomla-app
mkdir servbay-joomla-app

# Entrer dans le dossier projet nouvellement créé
cd servbay-joomla-app

# Télécharger l’archive d’installation de Joomla
# Remarque : le lien ci-dessous pointe peut-être vers une version 3 de Joomla.
# Il est recommandé de visiter le site officiel (https://downloads.joomla.org/) pour obtenir le lien de la dernière version stable.
curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip

Remarque : La commande curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip télécharge la dernière version stable de Joomla 3 à la date de rédaction. Les versions plus récentes (ex : Joomla 4 ou 5) sont disponibles sur le site officiel. Pour bénéficier des fonctionnalités et correctifs de sécurité les plus récents, il est fortement recommandé de consulter la page de téléchargement officielle et d'utiliser le lien vers la version stable actuelle en adaptant l’URL ci-dessus.

Étape 2 : Extraire l’archive Joomla

Décompressez l’archive téléchargée dans le dossier servbay-joomla-app puis supprimez l’archive pour garder le dossier propre.

# Décompresser l’archive Joomla
unzip joomla.zip

# Supprimer l’archive
rm joomla.zip

Après extraction, le dossier servbay-joomla-app contient tous les fichiers nécessaires à l’installation de Joomla.

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

Joomla requiert une base de données pour stocker son contenu, ses paramètres et ses utilisateurs. Nous allons utiliser l’outil phpMyAdmin fourni avec ServBay pour créer la base et l’utilisateur associé.

1. Accédez au panneau de contrôle ServBay

   Ouvrez votre navigateur à l'adresse du panneau de contrôle local de ServBay : https://servbay.host/. Ce tableau de bord permet d’accéder à phpMyAdmin, phpInfo et bien d’autres outils.

2. Accéder à phpMyAdmin

   Sur le panneau de contrôle ServBay, cliquez sur le lien « phpMyAdmin » pour ouvrir l’interface de gestion SQL.

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

   Pour plus de sécurité, il est recommandé de créer un utilisateur de base de données spécifique pour chaque application.

   1. Allez dans la gestion des comptes utilisateurs

      Dans le menu supérieur de phpMyAdmin, cliquez sur « Utilisateurs ».

   2. Ajouter un nouvel utilisateur

      Cliquez sur « Ajouter un utilisateur » et renseignez :

      • Nom d’utilisateur : Choisissez un nom, par exemple servbay_joomla_user.
      • Hôte : Sélectionnez localhost (l’utilisateur pourra alors se connecter uniquement en local, renforçant la sécurité).
      • Mot de passe : Saisissez un mot de passe fort et conservez-le précieusement (par exemple, password123 — remplacez-le en pratique par un mot de passe complexe).
      • Retapez le mot de passe : Pour confirmation.
      • Créer une base de données au nom de l'utilisateur et accorder tous les privilèges : Cochez cette case ; cela crée une base nommée comme l’utilisateur (ex : servbay_joomla_user) et accorde tous les droits sur cette base spécifique.
      • Privilèges globaux : Ne pas cocher la case « Accorder tous les privilèges » en global : l’utilisateur ne gèrera que sa base.

   3. Validez la création

      Après vérification, cliquez sur « Exécuter » pour créer l’utilisateur et la base.

Étape 4 : Configurer le serveur web (ajout du site)

Il faut maintenant indiquer à ServBay sous quel nom de domaine accéder à vos fichiers Joomla, en ajoutant un nouveau site dans la configuration de ServBay.

1. Ouvrez l’application ServBay

   Lancez ou revenez sur l’interface de l’application ServBay.

2. Naviguer vers la gestion des sites

   Cliquez sur l’onglet « Sites » dans le menu de gauche.

3. Ajouter un nouveau site

   Cliquez sur le bouton « Ajouter » en haut à droite.

   • Nom : Saisissez un nom descriptif pour identifier votre site, ex : My ServBay Joomla Site.
   • Domaine : Indiquez le domaine local que vous utiliserez, ex : servbay-joomla.local. ServBay configure automatiquement le DNS local pour que ce domaine pointe sur votre environnement.
   • Type de site (Site Type) : Sélectionnez PHP.
   • Version PHP : Choisissez la version de PHP compatible avec votre version de Joomla (consultez la documentation officielle pour vérifier la compatibilité).
   • Racine du site (Site Root) : Cliquez sur l’icône de dossier, puis sélectionnez /Applications/ServBay/www/servbay-joomla-app.

4. Sauvegarder la configuration

   Après avoir renseigné ces champs, cliquez sur « Enregistrer ». ServBay applique la configuration et peut redémarrer temporairement les services concernés (Caddy ou Nginx).

Étape 5 : Lancer l’installateur Joomla

Vous pouvez maintenant accéder à l’interface d’installation web de Joomla via le nom de domaine configuré.

1. Accédez à la page d'installation

   Dans votre navigateur, allez sur le domaine défini à l’étape précédente, ex : https://servbay-joomla.local/. Le serveur web configuré par ServBay pointera automatiquement sur votre dossier de site. Joomla détectera la première visite et redirigera vers l’assistant d’installation (/installation/index.php). Si cela ne fonctionne pas automatiquement, accédez manuellement à https://servbay-joomla.local/installation/index.php.

2. Suivez l'assistant d'installation

   L’assistant d’installation graphique de Joomla va s’afficher. Suivez chaque étape :

   • Configuration : Indiquez le nom et la description de votre site, ainsi que les identifiants de l’administrateur (nom d’utilisateur, mot de passe, e-mail). Utilisez un identifiant et un mot de passe administrateur sécurisés.
   • Base de données : Saisissez les informations requises, configurées à l’étape 3 :
     • Type de base de données : Généralement MySQLi.
     • Hôte : localhost
     • Nom d'utilisateur : ex : servbay_joomla_user
     • Mot de passe : ex : password123
     • Nom de la base : ex : servbay_joomla_user
     • Préfixe des tables : Laissez le préfixe généré ou personnalisez-le (ex : jos_).
     • Action sur une base existante : Pour une nouvelle installation, peu importe le choix (« sauvegarder » ou « supprimer »). Sur une base vide, cette option n’aura pas d’effet.
   • Finalisation : Vérifiez votre configuration et assurez-vous que ServBay répond aux exigences de Joomla (PHP, extensions, etc.). Cliquez ensuite sur « Installer ».

3. Finaliser l'installation et supprimer le dossier d'installation

   L’installation peut durer quelques minutes. Une fois terminée, Joomla signalera la réussite et vous invitera à supprimer le dossier installation pour des raisons de sécurité.

   Vous pouvez aussi le faire depuis le Terminal :

   # Placer dans le dossier du projet Joomla
   cd /Applications/ServBay/www/servbay-joomla-app
   
   # Supprimer le dossier installation
   rm -rf installation

   Après cette étape, votre site Joomla est accessible. Vous pouvez visiter l’interface publique ou l'admin.

Étape 6 : Explorer l'administration Joomla

Accédez à la partie d'administration via /administrator, par exemple : https://servbay-joomla.local/administrator. Connectez-vous avec les identifiants définis lors de l’installation. Vous pouvez alors configurer votre site, installer des extensions et modèles, créer du contenu, etc.

Premiers pas avec Joomla (aperçu)

Après une installation réussie, profitez du potentiel de Joomla pour construire votre site ! Quelques actions de base :

• Créer des articles et des catégories : Gérez vos contenus depuis le menu « Contenus ».
• Gérer les menus : Créez et éditez la navigation dans « Menus ».
• Configurer les modules : Gérez les modules (barre latérale, pied de page…) dans « Extensions » > « Modules ».
• Choisir et personnaliser un template : Adaptez le design dans « Extensions » > « Templates ».
• Installer des extensions : Ajoutez des composants, modules, plugins et templates via « Extensions » > « Gérer » pour enrichir Joomla.

Remarques importantes

• Sécurité : Adoptez un mot de passe robuste pour les comptes Joomla et la base de données. Supprimez toujours le dossier installation après l’installation.
• Compatibilité PHP : Vérifiez que la version PHP sélectionnée dans ServBay correspond à celle requise par votre version de Joomla. Consultez la documentation officielle à ce sujet.
• Informations de connexion BDD : Vérifiez vos paramètres (hôte : localhost, identifiants BDD).
• Mises à jour ServBay : Gardez ServBay à jour pour profiter des derniers correctifs et améliorations.
• Sauvegardes : ServBay propose des fonctionnalités de sauvegarde (manuelles et automatiques) pour vos fichiers de site, bases de données, certificats SSL et paramètres ServBay. Effectuez régulièrement des sauvegardes, surtout avant tout changement majeur, pour prévenir toute perte de données.

FAQ (Foire Aux Questions)

• Q : J’obtiens une erreur « Site inaccessible » ou 404 avec mon domaine local, que faire ?R : Vérifiez les points suivants :

  1. ServBay est-il bien démarré ?
  2. Dans l’onglet « Sites » de ServBay, le site Joomla est-il activé ?
  3. La racine du site pointe-t-elle vers /Applications/ServBay/www/servbay-joomla-app ?
  4. Le domaine local (servbay-joomla.local) correspond-il bien à votre configuration ServBay ?

• Q : Erreur de connexion à la base de données lors de l'installation, que faire ?R : Celle-ci provient généralement d’informations de connexion incorrectes. Vérifiez :

  1. L’hôte BDD est bien localhost
  2. Les informations d'identification (servbay_joomla_user / password123) correspondent exactement à celles créées dans phpMyAdmin.
  3. Le nom de la base est correct (servbay_joomla_user).
  4. Le service base de données (MySQL/MariaDB) est bien en marche dans ServBay.

• Q : Mot de passe root MySQL oublié sur ServBay, que faire ?R : ServBay propose une fonction de réinitialisation du mot de passe root MySQL/MariaDB disponible via l’application, pour réinitialiser le mot de passe de manière sécurisée.

• Q : Après installation, j’ai une page blanche ou une erreur ?R : Assurez-vous que le dossier installation a bien été supprimé. Consultez les logs d’erreur de Joomla (s’ils sont configurés) ou les logs PHP (paramètres via ServBay : error_reporting, display_errors) pour plus d’infos. Vérifiez aussi la compatibilité de la version PHP.

Conclusion

Avec ServBay, installer et configurer Joomla CMS sous macOS est un processus simple et rapide. ServBay fournit un environnement pré-configuré, intégrant serveur web, base de données et PHP, ce qui simplifie grandement la gestion et l’installation de Joomla. En suivant ce guide, vous pouvez mettre en place un environnement de développement Joomla local en quelques minutes et commencer la création de votre site. Pensez à maintenir vos versions de ServBay et Joomla à jour, et appliquez les bonnes pratiques de sécurité.