Comment installer PyroCMS sur un serveur Ubuntu 24.04

PyroCMS est un CMS open-source basé sur PHP et les frameworks web Laravel. C’est un puissant système de gestion de contenu avec MySQL/MariaDB comme base de données et offre également une administration web intuitive et simple pour une gestion facilitée.

Dans ce tutoriel, nous vous guiderons à travers l’installation de PyroCMS sur Ubuntu 24.04 avec la pile LEMP (Linux, Nginx, MySQL/MariaDB et PHP-FPM) et Composer.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

Un serveur Ubuntu 24.04.
Un utilisateur non-root avec des privilèges d’administrateur.
Un nom de domaine pointant vers l’adresse IP du serveur.

Installation des dépendances

PyroCMS est un système de gestion de contenu basé sur Laravel avec MySQL/MariaDB comme base de données. Avant d’installer PyroCMS, vous devez installer la pile LEMP (Linux, Nginx, MySQL/MariaDB et PHP-FPM) et Composer sur votre système Ubuntu.

Tout d’abord, exécutez la commande apt suivante pour mettre à jour votre index de paquets et installer la pile LEMP (Linux, Nginx, MySQL/MariaDB et PHP-FPM) et Composer.

sudo apt update sudo apt install nginx mariadb-server composer php-cli php-fpm php-mysql php-curl php-sqlite3 php-mbstring php-gd php-xml

Entrez Y pour confirmer l’installation.

install deps

Après l’installation, vérifiez les services de la pile LEMP pour vous assurer que ces services fonctionnent.

Vérifiez le serveur web Nginx avec la commande systemctl ci-dessous.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Vérifiez maintenant l’état du serveur MariaDB avec ce qui suit :

check nginx

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadbn

Ensuite, exécutez la commande suivante pour vérifier le service PHP-FPM.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

check php-fpm

Enfin, vérifiez la version de Composer en utilisant la commande ci-dessous. Vous verrez que Composer 2.4.7 est installé.

sudo -u www-data composer --version

Configuration de PHP-FPM

Après avoir installé les dépendances, vous allez configurer PHP-FPM en modifiant certaines configurations par défaut via le fichier php.ini et en redémarrant le service PHP-FPM.

Ouvrez le fichier php.ini pour PHP-FPM avec l’éditeur nano.

sudo nano /etc/php/8.3/fpm/php.ini

Modifiez la configuration par défaut avec ce qui suit et ajustez les options date.timezone et memory_limit selon votre environnement actuel.

date.timezone = Europe/Amsterdam  
max_execution_time = 130  
memory_limit = 256M  
allow_url_fopen = On  
allow_url_include = Off  
post_max_size = 128M  
upload_max_filesize = 128M  
max_input_vars = 5000

Lorsque vous avez terminé, enregistrez le fichier et quittez l’éditeur.

Exécutez maintenant la commande systemctl ci-dessous pour redémarrer le service PHP-FPM et appliquer vos modifications sur php.ini.

sudo systemctl restart php8.3-fpm

Configuration du serveur MariaDB

Maintenant que vous avez configuré PHP-FPM, vous allez sécuriser l’installation du serveur MariaDB et créer une nouvelle base de données et un utilisateur pour PyroCMS.

Sécurisez votre installation du serveur MariaDB avec la commande mariadb-secure-installation ci-dessous.

sudo mariadb-secure-installation

Vous serez interrogé sur les configurations suivantes :

Passer à l’authentification unix_socket ? Entrez n et appuyez sur ENTRER.
L’utilisateur root par défaut de MariaDB est déjà protégé. En option, vous pouvez également l’activer en tapant y pour oui.
Changer le mot de passe root. Entrez y pour confirmer et configurez votre nouveau mot de passe root MariaDB.
Supprimer les utilisateurs anonymes ? Entrez y pour confirmer.
Interdire la connexion root à distance ? Entrez y pour confirmer. Seule la connexion locale sera autorisée si vous utilisez MariaDB.
Supprimer la base de données de test et y accéder. Entrez y pour confirmer et supprimer la base de données par défaut ‘test’.
Enfin, entrez y à nouveau pour recharger tous les privilèges de table sur votre serveur MariaDB et appliquer les nouvelles modifications.

Après avoir configuré MariaDB, vous allez créer une nouvelle base de données et un utilisateur pour PyroCMS.

Connectez-vous au serveur MariaDB avec la commande mariadb ci-dessous. Entrez votre mot de passe root lorsqu’on vous le demande.

sudo mariadb -u root -p

Exécutez maintenant les requêtes suivantes pour créer une nouvelle base de données pyrocmsdb, un nouvel utilisateur pyrocms@localhost, et le mot de passe est passw0rd. Modifiez les détails du nom de la base de données, du nom d’utilisateur et du mot de passe selon vos besoins.

CREATE DATABASE pyrocmsdb;  
GRANT ALL PRIVILEGES ON pyrocmsdb.* TO pyrocms@localhost IDENTIFIED BY 'passw0rd';  
FLUSH PRIVILEGES;

create database and user

Ensuite, exécutez la requête ci-dessous pour vérifier les privilèges pour l’utilisateur pyrocms@localhost. Vous verrez que la base de données pyrocmsdb est accessible avec l’utilisateur pyrocms@localhost.

SHOW GRANTS FOR pyrocms@localhost;

Enfin, tapez quit pour quitter le serveur MariaDB.

show db privileges

Téléchargement du code source de PyroCMS

Créez de nouveaux répertoires pour Composer et PyroCMS, allez dans le /var/www/pyrocms, puis changez la propriété des nouveaux répertoires à l’utilisateur www-data. Dans ce cas, le /var/www/pyrocms sera utilisé comme racine de document pour PyroCMS.

mkdir -p /var/www/{.config,.cache,pyrocms}; cd /var/www/pyrocms  
sudo chown -R www-data:www-data /var/www/{.config,.cache,pyrocms}

Exécutez maintenant la commande composer ci-dessous pour télécharger le code source de PyroCMS, et installer et mettre à jour les dépendances PHP.

sudo -u www-data composer create-project pyrocms/pyrocms .  
sudo -u www-data composer update

Vous pouvez voir ci-dessous l’installation de PyroCMS via la commande composer :

download and install pyrocms dependencies

Après l’installation, passez à la section suivante.

Configuration du bloc serveur Nginx

Dans cette section, vous allez créer une nouvelle configuration de bloc serveur Nginx pour l’installation de PyroCMS. Assurez-vous donc d’avoir un nom de domaine pointant vers l’adresse IP de votre serveur Ubuntu. Dans cet exemple, vous utiliserez un nom de domaine howtoforge.local.

Créez un nouveau bloc serveur Nginx /etc/nginx/sites-available/pyrocms.conf avec l’éditeur nano.

sudo nano /etc/nginx/sites-available/pyrocms.conf

Copiez et collez la configuration suivante et assurez-vous de changer le server_name avec votre nom de domaine.

server {  
 listen 80;  
 server_name howtoforge.local;  
  
 index index.php index.html;  
 root /var/www/pyro/public;  
   
 location / {  
  try_files $uri $uri/ /index.php?$args;  
 }  
  
 location ~ \.php$ {  
  include fastcgi_params;  
  fastcgi_pass unix:/run/php/php-8.3-fpm.sock;  
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
  fastcgi_index index.php;  
 }  
}

Lorsque vous avez terminé, enregistrez et quittez le fichier.

Exécutez maintenant la commande ci-dessous pour créer un lien symbolique du fichier pyrocms.conf vers le répertoire /etc/nginx/sites-enabled et vérifiez votre syntaxe Nginx.

sudo ln -s /etc/nginx/sites-available/pyrocms.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Si vous avez une syntaxe Nginx correcte, vous verrez un message test is successful - syntax is ok.

setup nginx

Enfin, exécutez la commande systemctl suivante pour redémarrer le serveur web Nginx et appliquer vos modifications.

sudo systemctl restart nginx

Sécuriser PyroCMS avec HTTPS via Letsencrypt

Pour sécuriser PyroCMS, vous allez mettre en œuvre HTTPS via Letsencrypt. Pour cela, vous devez installer Certbot pour générer des certificats SSL/TLS et mettre automatiquement en œuvre HTTPS sur votre installation de PyroCMS.

Installez les paquets certbot et python3-certbot-nginx avec la commande suivante. Entrez Y pour confirmer l’installation.

sudo apt install certbot python3-certbot-nginx

Exécutez maintenant la commande certbot ci-dessous pour générer des certificats SSL et sécuriser PyroCMS avec HTTPS.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Après le processus, vous obtiendrez vos certificats dans le répertoire /etc/letsencrypt/live/domain.com, et votre PyroCMS est maintenant sécurisé avec HTTPS.

Installation de PyroCMS via l’installateur web

Ouvrez votre navigateur web et visitez votre nom de domaine tel que https://howtoforge.local/. Vous verrez maintenant une seule page d’installation de PyroCMS :

Sélectionnez J’accepte pour accepter la licence pour l’installation de PyroCMS.
Entrez votre nom de base de données, utilisateur et mot de passe.
Entrez un nouvel utilisateur admin, une adresse e-mail et un mot de passe pour votre PyroCMS.
Entrez les détails du site pour votre installation, tels que le nom de domaine, la langue et le fuseau horaire.
Cliquez sur Installer pour confirmer l’installation.

install pyrocms

Après l’installation, vous verrez la page suivante :

install complete

Cliquez sur Voir le site pour accéder à la page d’accueil de PyroCMS. Vous pouvez voir ci-dessous la page d’index par défaut pour PyroCMS.

homepage

Cliquez sur Connexion pour accéder à l’écran de connexion de PyroCMS. Entrez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion.

Si cela réussit, vous verrez le tableau de bord admin de PyroCMS comme suit :

dashboard

Conclusion

Félicitations ! Vous avez terminé l’installation de PyroCMS sur le serveur Ubuntu 24.04. Vous avez installé PyroCMS avec la pile LEMP (Linux, Nginx, MySQL/MariaDB et PHP-FPM). Vous avez également téléchargé PyroCMS avec Composer et sécurisé PyroCMS avec HTTPS via Certbot et Letsencrypt.