User Documentation
Télécharger
Lancer

Installation de Joomla en ligne de commande (CLI)

Introduction

Le CMS Joomla est habituellement installé via une interface de navigateur web. Cependant, les utilisateurs expérimentés peuvent souhaiter installer Joomla à l'aide de commandes dans une interface de terminal. Cela permet un déploiement rapide de plusieurs instances de Joomla.

Configuration requise

Joomla nécessite PHP, une base de données et un serveur web. Pour obtenir les dernières informations sur les logiciels pris en charge ainsi que les versions minimales et recommandées, veuillez consulter la page Configuration technique requise.

L'installation peut être effectuée de deux manières différentes :

  1. Installation manuelle
  2. Installation automatique pilotée par script

Installation manuelle

L'installation manuelle offre un bon contrôle pendant le processus d'installation. Chaque étape est visible dans le terminal et peut être interrompue avec Ctrl+C en cas de saisie incorrecte.

Étapes à accomplir

  1. Transférer le fichier zip ou tar du pack d'installation vers le serveur web.
  2. Décompresser le fichier zip ou tar.
  3. Renommer le dossier décompressé et le déplacer vers un emplacement approprié dans la racine documentaire du serveur web.
  4. Se déplacer vers le dossier contenant le code de Joomla et exécuter la commande suivante :
    php installation/joomla.php install
  5. Il vous sera demandé de saisir les paramètres requis pour l'installation, comme dans l'exemple de transcription suivant :
php installation/joomla.php install

Install Joomla
==============

Checking system requirements...OK
Collecting configuration...

 Enter the name of your Joomla site:
 > J51
 Enter the real name of your Super User:
 > John Doe
 Set the username for your Super User account:
 > johndoe
 Set the password for your Super User account:
 >
 Enter the email address of the website Super User:
 > Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser.
 Database type. Supported: mysql, mysqli, pgsql [mysqli]:
 >
 Database host [localhost]:
 >
 Database username:
 > j4
 Database password:
 >
 Database name [joomla_db]:
 > j51
 Prefix for the database tables [u5dke_]:
 >
 Encryption for the database connection. Values: 0=None, 1=One way, 2=Two way [0]:
 >
 Relative or absolute path to the public folder []:
 >
OK
Validating DB connection...OK
Creating and populating the database...OK
Writing configuration.php and additional setup ...OK
Deleting /installation folder...OK
 [OK] Joomla has been installed

Une fois le script exécuté avec succès, le nouveau site web peut être accédé via votre navigateur web.

Remarques

  • Faites attention à votre saisie. Il n'est pas possible de revenir en arrière dans le script. Si la saisie est incorrecte, le script doit être interrompu.
  • Le nom de votre site Joomla apparaît dans la barre de titre de l'Administration, il doit donc être court et distinctif. Il peut être modifié ultérieurement.
  • Le nom réel de votre Super Utilisateur peut être modifié ultérieurement.
  • L'identifiant de votre compte Super Utilisateur doit éviter un nom similaire à admin. Ce choix est potentiellement peu sûr car il peut être facilement deviné par un pirate.
  • Le mot de passe de l'utilisateur doit comporter 12 caractères.
  • Le type de base de données par défaut est mysqli. Les types de bases de données pris en charge sont MySQL (mysql) et PostgreSQL (pgsql), ainsi que les types compatibles tels que MariaDB.
  • L'hôte de la base de données est presque toujours localhost. Une adresse IP ou un nom d'hôte ne doit être saisi ici que si le serveur de base de données responsable est installé sur un autre hôte. Cependant, l'utilisateur du terminal doit disposer des droits d'écriture sur l'hôte sélectionné. Vous obtiendrez cette information auprès de votre fournisseur d'accès internet (FAI).
  • L'identifiant de la base de données est généralement différent du nom du Super Utilisateur.
  • Le mot de passe de la base de données Joomla est presque toujours différent du mot de passe du Super Utilisateur.
  • Le nom de la base de données par défaut est joomla_db mais d'autres noms sont souvent utilisés.
  • Le préfixe des tables de la base de données est défini à partir d'une sélection aléatoire de cinq caractères. Cette valeur est utilisée pour séparer les tables de Joomla des autres tables contenues dans la base de données si celle-ci est également utilisée par d'autres applications.
  • Le paramètre de cryptage de la connexion à la base de données est rarement utilisé. Sauf indication contraire de votre FAI, laissez cette valeur à la valeur par défaut [0].

Installation automatique pilotée par script

L'installation de Joomla est contrôlée par un fichier joomla.php situé dans le sous-dossier installation après avoir décompressé le fichier du pack Joomla. Tout langage de programmation permettant d'appeler et d'exécuter des fichiers PHP vous permet de créer un script qui automatise les préparations nécessaires et l'installation proprement dite en utilisant des variables personnalisées. Une liste des paramètres peut être obtenue avec la commande suivante:

php installation/joomla.php help install

Voici un exemple de script shell nommé jinstall.sh placé dans le dossier racine de Joomla, créé pour une installation simple de Joomla:

#!/bin/bash

php installation/joomla.php install \
--site-name=SITE-NAME \
--admin-user=ADMIN-USER \
--admin-username=ADMIN-USERNAME \
--admin-password=ADMIN-PASSWORD \
--admin-email=Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser. \
--db-type=mysqli \
--db-host=localhost \
--db-user=j51 \
--db-pass=Garbage1n0ut \
--db-name=j51 \
--db-prefix=xyz12_ \
--db-encryption=0 \
--public-folder=j51

Avec ses droits définis à 700, il est simple d'appeler le script depuis la ligne de commande avec ./jinstall.sh et Joomla est installé littéralement en un éclair. Le script aurait pu être modifié pour changer les valeurs des paramètres, ou celles-ci pourraient être modifiées ultérieurement après connexion à l'Administration.

Si vous utilisez cette approche, pensez à supprimer votre script jinstall.sh ou à le déplacer hors de votre arborescence web pour une utilisation ultérieure ailleurs. Le dossier d'installation est supprimé à la fin du processus d'installation. Exécuter le script jinstall.sh une seconde fois ne fonctionnera donc pas.