Comment installer TYPO3 CMS sur Rocky Linux 9

TYPO3 est un système de gestion de contenu de niveau entreprise, gratuit et open-source. Il offre plusieurs fonctionnalités de niveau entreprise telles qu’un CMS évolutif avec support multisite, des installations multilingues, une mise en œuvre de sécurité robuste, une rapidité fulgurante, et peut être exécuté partout.

Utiliser TYPO3 CMS vous permet de créer des sites Web flexibles et fiables. Le TYPO3 CMS est soutenu par une communauté professionnelle dynamique. Et par conception, le TYPO3 CMS est un système de gestion de contenu extensible avec une architecture adaptable et découplée.

Dans ce guide, vous allez installer TYPO3 CMS - Système de Gestion de Contenu de Niveau Entreprise - sur un serveur Rocky Linux 9. Vous allez configurer TYPO3 CMS avec le serveur web httpd, la base de données MariaDB, et la dernière version de PHP 8.0. Ce guide inclut la mise en œuvre de HTTPS via Certbot et Letsencrypt, qui seront utilisés pour sécuriser le déploiement de TYPO3.

Prérequis

Tout d’abord, vous devez avoir les exigences suivantes pour compléter ce guide :

• Un serveur Rocky Linux 9 - Cet exemple utilise un Rocky Linux avec le nom d’hôte ‘TYPO3-Roc k’.
• Un utilisateur non-root avec des privilèges sudo/root.
• Un SELinux fonctionnant en mode permissif.
• Un nom de domaine pointant vers une adresse IP de serveur - Cet exemple utilise le domaine ‘howtoforge.local‘.

C’est tout. Lorsque toutes les exigences sont prêtes, vous pouvez maintenant commencer l’installation.

Installation du serveur web httpd

TYPO3 est un CMS (Système de Gestion de Contenu) de niveau entreprise et une application web écrite en PHP. Il peut être exécuté avec différents types de serveurs web. Dans cet exemple, vous allez installer et exécuter TYPO3 CMS avec le serveur web httpd.

Avant d’installer un paquet, entrez la commande dnf suivante pour ajouter le dépôt EPEL (Extra Package for Enterprise Linux) à votre système. Ce dépôt sera nécessaire plus tard pour installer des paquets supplémentaires.

sudo dnf install epel-release

Maintenant, exécutez la commande dnf suivante pour installer le serveur web httpd. Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRÉE pour continuer.

sudo dnf install httpd

Une fois httpd installé, entrez la commande systemctl suivante pour démarrer et activer le serveur web httpd. Cela lancera le serveur web httpd et l’activera pour qu’il démarre automatiquement au démarrage du système.

sudo systemctl start httpd  
sudo systemctl enable httpd

Vérifiez l’état du serveur web httpd en utilisant la commande systemctl ci-dessous. Vous devriez recevoir une sortie telle que ‘enabled‘, ce qui confirme que le service httpd sera exécuté automatiquement au démarrage. Et l’état du serveur web httpd est en cours d’exécution.

sudo systemctl is-enabled httpd  
sudo systemctl status httpd

Avant d’accéder à votre installation httpd, vous devez ouvrir les protocoles HTTP et HTTPS sur votre système Rocky Linux via firewalld.

Entrez la commande firewall-cmd suivante pour ajouter les ports HTTP et HTTPS au firewalld. Ensuite, rechargez le firewalld pour appliquer les modifications.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

La sortie ‘success‘ confirme le succès de l’opération. Vous pouvez maintenant vérifier la liste des règles firewalld via la commande suivante.

sudo firewall-cmd --list-all

Dans la section ‘services’, vous devriez voir les protocoles HTTP et HTTPS ajoutés au firewalld.

Maintenant que vous avez installé le serveur web httpd et configuré firewalld. Ensuite, vous allez commencer l’installation du serveur de base de données MariaDB.

Installation du serveur MariaDB

Dans cette section, vous allez installer le serveur de base de données MariaDB et sécuriser le déploiement automatiquement en utilisant la commande ‘mariadb-secure-installation’.

Pour commencer, entrez la commande dnf suivante pour installer le serveur de base de données MariaDB.

sudo dnf install mariadb-server

Saisissez y lorsque vous y êtes invité et appuyez sur ENTRÉE pour continuer.

Maintenant, démarrez et activez le service MariaDB en utilisant la commande systemctl suivante. Le service MariaDB devrait maintenant être en cours d’exécution et également activé, ce qui signifie que le service MariaDB démarrera automatiquement au démarrage.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Entrez la commande systemctl suivante pour vérifier le service MariaDB et vous assurer que le service est en cours d’exécution et activé.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Une sortie ‘enabled‘ confirme que le serveur MariaDB est activé et sera exécuté automatiquement au démarrage du système. La sortie ‘active (running)‘ confirme que le serveur MariaDB est en cours d’exécution.

Enfin, exécutez la commande ‘mariadb-secure-installation’ suivante pour sécuriser le déploiement de MariaDB.

sudo mariadb-secure-installation

Vous serez maintenant invité avec les configurations suivantes - Vous pouvez saisir y pour confirmer ou n pour non.

• Changer l’authentification en unix_socket ? saisissez n.
• Changer le mot de passe root de MariaDB ? saisissez y pour confirmer, saisissez le nouveau mot de passe pour votre serveur MariaDB et répétez le mot de passe.
• Désactiver la connexion root à distance ? saisissez y pour confirmer - l’utilisateur root ne doit pas être autorisé à se connecter à distance.
• Supprimer l’utilisateur anonyme ? saisissez y pour confirmer.
• Supprimer la base de données par défaut ‘test’ ? saisissez y pour confirmer et supprimer la base de données test.
• Enfin, saisissez y pour recharger les privilèges des tables et appliquer les nouvelles modifications.

Lorsque le déploiement de MariaDB est terminé, vous êtes prêt à créer une nouvelle base de données et un utilisateur pour le déploiement de TYPO3 CMS.

Création de la base de données et de l’utilisateur MariaDB

Dans cette section, vous allez créer une nouvelle base de données MariaDB et un utilisateur qui seront utilisés pour l’installation de TYPO3 CMS.

Tout d’abord, connectez-vous à l’interface de commande MariaDB via la commande ‘mariadb‘ ci-dessous. Saisissez votre mot de passe root MariaDB et appuyez sur ENTRÉE.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes MariaDB suivantes pour créer une nouvelle base de données et un utilisateur. Dans cet exemple, vous allez créer une nouvelle base de données ‘typo3db‘ avec l’utilisateur ‘typo3‘. Assurez-vous de changer le mot de passe dans les requêtes suivantes, et assurez-vous d’utiliser ‘utf8mb4‘ comme jeu de caractères par défaut pour votre base de données.

CREATE DATABASE typo3db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;  
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'typo3password';  
FLUSH PRIVILEGES;

Ensuite, vérifiez la liste des utilisateurs disponibles sur MariaDB en utilisant la requête suivante. Vous devriez voir le nouvel utilisateur ‘typo3‘ ajouté et disponible sur votre serveur MariaDB.

SELECT USER,host FROM mysql.user;

Enfin, vérifiez les privilèges pour l’utilisateur MariaDB ‘typo3‘ en utilisant la requête suivante. Vous devriez voir que l’utilisateur ‘typo3‘ a tous les privilèges sur la base de données ‘typo3db‘.

SHOW GRANTS FOR typo3@localhost;

Maintenant, tapez quit pour vous déconnecter de l’interface de commande MariaDB.

Avec cela, vous avez maintenant terminé la configuration de la base de données MariaDB pour l’installation de TYPO3 CMS. Passez à l’étape suivante pour commencer l’installation de PHP.

Installation de PHP 8.0

TYPO3 CMS est principalement écrit en PHP, et au moment de la rédaction de ce document, la dernière version de TYPO3 CMS prend en charge les paquets PHP 8.x. Dans cette section, vous allez installer PHP 8.0, qui est disponible par défaut dans le dépôt Rocky Linux 9.

Entrez la commande dnf suivante pour installer les paquets PHP 8.0. Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRÉE pour continuer.

sudo dnf install php php-common php-mysqlnd php-gd php-curl php-json php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

Une fois PHP installé, ouvrez le fichier de configuration ‘/etc/php.ini’ en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/php.ini

Changez les configurations par défaut de php.ini avec les lignes suivantes.

memory_limit = 512M  
max_execution_time = 300  
max_input_vars = 2000  
  
date.timezone = Europe/Stockholm  
  
post_max_size = 30M  
upload_max_filesize = 30M

Enregistrez et quittez le fichier ‘/etc/php.ini‘ lorsque vous avez terminé.

Maintenant, exécutez la commande systemctl suivante pour redémarrer le service httpd et appliquer les nouvelles modifications que vous avez apportées au fichier ‘php.ini’.

sudo systemctl restart httpd

Vous pouvez également vérifier la version actuelle de PHP via la commande ‘php’ ci-dessous. Vous devriez recevoir une sortie indiquant que PHP 8.0 est installé sur votre système.

php --version

Maintenant, vous avez installé les paquets PHP 8.0 et configuré le fichier php.ini. À l’étape suivante, vous allez installer Composer - le gestionnaire de dépendances pour PHP - qui sera utilisé pour installer les dépendances PHP de TYPO3 CMS.

Installation de Composer

Composer est un gestionnaire de dépendances PHP au niveau de l’application. Il peut être installé manuellement via le script d’installation officiel, ou vous pouvez l’installer via le dépôt EPEL.

Entrez la commande dnf suivante pour installer Composer depuis le dépôt EPEL. Lorsque vous y êtes invité, saisissez y pour confirmer et appuyez sur ENTRÉE pour continuer.

sudo dnf install composer

Une fois Composer installé, entrez la commande suivante pour vérifier la version de Composer.

sudo -u apache composer -V

La sortie ci-dessous confirme que Composer v2.5.1 est installé sur votre système Rocky Linux.

Avec Composer installé, l’étape suivante consiste à installer Certbot qui sera utilisé pour générer des certificats SSL/TLS de Letsencrypt.

Installation de Certbot

Certbot est un outil en ligne de commande pour générer des certificats SSL/TLS de Letsencrypt. Pour les distributions basées sur RHEL, vous pouvez installer Certbot depuis le dépôt EPEL.

Entrez la commande dnf suivante pour installer les paquets ‘certbot‘ et ‘python3-certbot-apache‘ sur votre système. Saisissez y lorsque vous y êtes invité et appuyez sur ENTRÉE pour continuer.

sudo dnf install certbot python3-certbot-apache

Une fois l’installation terminée, exécutez la commande suivante pour vérifier votre installation.

which certbot  
certbot --version

Le chemin binaire de la commande ‘certbot‘ est disponible à ‘/bin/certbot‘. Et la version de certbot que vous avez installée est v2.1.0.

Avec Composer et Certbot installés, vous êtes prêt à installer TYPO3 CMS.

Téléchargement du code source de TYPO3 CMS

Dans cette section, vous allez configurer le répertoire d’installation cible et télécharger le code source de TYPO3 CMS.

Entrez la commande suivante pour créer un nouveau répertoire ‘/var/www/typo3‘. Cela sera utilisé comme répertoire d’installation racine de TYPO3 CMS.

mkdir -p /var/www/typo3

Changez la propriété du répertoire ‘/var/www/typo3‘ à l’utilisateur et au groupe ‘apache‘. De plus, vous devez vous assurer que le propriétaire de ce répertoire peut lire et écrire dedans. Avec cela, vous donnerez accès au code source de TYPO3 CMS au serveur web httpd qui s’exécute par défaut avec un utilisateur ‘apache‘.

sudo chown -R apache:apache /var/www/typo3  
sudo chmod u+rw /var/www/typo3

Maintenant, allez dans le répertoire ‘/var/www/typo3‘ et téléchargez le code source de TYPO3 CMS en utilisant la commande composer suivante.

cd /var/www/typo3  
sudo -u apache composer create-project typo3/cms-base-distribution:^11 .

Sortie :

Une fois le code source de TYPO3 CMS téléchargé, entrez la commande suivante pour vérifier la liste des fichiers et des répertoires dans le répertoire ‘/var/www/typo3‘.

ls -lah /var/www/typo3

La sortie ci-dessous confirme que le code source de TYPO3 CMS est téléchargé. De plus, vous devez vous assurer que la propriété du code source de TYPO3 CMS est l’utilisateur et le groupe ‘apache‘.

Maintenant que vous avez téléchargé le code source de TYPO3 CMS, vous allez créer et configurer la configuration d’hôte virtuel httpd qui sera utilisée pour exécuter TYPO3 CMS.

Configuration de l’hôte virtuel httpd

Dans cette section, vous allez créer une nouvelle configuration d’hôte virtuel httpd qui sera utilisée pour exécuter TYPO3 CMS. Vous allez également générer des certificats SSL/TLS de Letsencrypt via la commande Certbot.

Avant de commencer, assurez-vous que vous avez le nom de domaine pointé vers l’adresse IP de votre serveur et une adresse e-mail qui sera utilisée pour s’inscrire à Letsencrypt.

Créez un nouveau fichier de configuration d’hôte virtuel httpd ‘/etc/httpd/conf.d/typo3.conf‘ en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/httpd/conf.d/typo3.conf

Ajoutez les lignes suivantes au fichier et assurez-vous de changer le nom de domaine de l’installation de TYPO3 CMS.

  
    ServerAdmin [email protected]  
    DocumentRoot /var/www/typo3/public  
    ServerName howtoforge.local  
  
    Protocols h2 http/1.1  
  
       
          Options FollowSymlinks  
          AllowOverride All  
          Require all granted  
       
  
     ErrorLog /var/log/httpd/typo3-error.log  
     CustomLog /var/log/httpd/typo3-access.log combined  
      
       
            RewriteEngine on  
            RewriteBase /  
            RewriteCond %{REQUEST_FILENAME} !-f  
            RewriteRule ^(.*) index.php [PT,L]  
      

Enregistrez et quittez le fichier ‘/etc/httpd/conf.d/typo3.conf‘ lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour vérifier et vous assurer que vous avez des configurations httpd appropriées. Lorsque cela réussit, vous devriez recevoir une sortie telle que ‘syntax OK‘.

sudo apachectl configtest

Maintenant, entrez la commande systemctl suivante pour redémarrer le service httpd et appliquer les modifications.

sudo systemctl restart httpd

Avec cela, vous avez maintenant terminé la configuration de l’hôte virtuel httpd pour TYPO3 CMS.

Maintenant, entrez la commande certbot suivante pour générer des certificats SSL/TLS pour votre nom de domaine TYPO3 CMS. Assurez-vous également de changer le nom de domaine et l’adresse e-mail dans la commande suivante.

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

Lorsque vous avez terminé, vos certificats SSL/TLS seront disponibles dans le répertoire ‘/etc/letsencrypt/live/yourdomain.com/‘. De plus, votre configuration d’hôte virtuel httpd sera automatiquement configurée avec des certificats SSL et la redirection automatique de HTTP vers HTTPS.

Avec cela, vous avez maintenant terminé la configuration du serveur web httpd pour TYPO3 CMS. Vous avez également généré des certificats SSL/TLS pour votre nom de domaine TYPO3 CMS. Vous pouvez maintenant accéder à votre installation TYPO3 CMS.

Démarrer l’installation de TYPO3

Avant de commencer l’installation de TYPO3 CMS, vous devez créer un nouveau fichier vide ‘FIRST_INSTALL‘ dans le répertoire ‘/var/www/typo3/public/‘. Cela indiquera que vous installez TYPO3 CMS pour la première fois sur ce serveur.

Entrez la commande suivante pour créer un nouveau fichier ‘FIRST_INSTALL‘ dans le répertoire ‘/var/www/typo3/public/‘.

sudo -u apache touch /var/www/typo3/public/FIRST_INSTALL

Maintenant, ouvrez votre navigateur web et saisissez le nom de domaine de votre installation TYPO3 CMS (c’est-à-dire : https://howtoforge.local/).

L’installateur de TYPO3 CMS vérifiera et validera votre environnement système sur la première page. Assurez-vous d’obtenir le bouton ‘Aucun problème détecté, continuer avec l’installation‘, ce qui confirme que votre système est prêt pour l’installation de TYPO3 CMS.

Maintenant, saisissez vos détails de l’utilisateur MariaDB qui seront utilisés pour l’installation de TYPO3 CMS.

Sélectionnez l’option ‘Utiliser une base de données vide existante‘ et sélectionnez la base de données ‘typo3db‘ dans le menu déroulant. Ensuite, cliquez sur Continuer.

Maintenant, saisissez le nom d’utilisateur, l’adresse e-mail et le mot de passe pour l’utilisateur admin de TYPO3 CMS. Assurez-vous d’utiliser un mot de passe fort pour cela.

Cliquez sur Continuer pour procéder.

Lorsque vous avez terminé, vous devriez recevoir une sortie telle que ‘Installation terminée‘.

Maintenant, sélectionnez l’option ‘Emmenez-moi directement au backend‘ et cliquez sur le bouton ‘Ouvrir le backend TYPO3‘ pour continuer.

Et vous serez redirigé vers la page de connexion de TYPO3 CMS. Saisissez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion.

Si cela réussit, vous devriez voir le tableau de bord d’administration de TYPO3 CMS.

Vous pouvez vérifier les détails du logiciel que vous utilisez pour l’installation de TYPO3 CMS en cliquant sur le menu ‘Informations sur l’application’ sur le côté gauche du profil utilisateur.

Vous devriez voir des détails similaires dans la capture d’écran suivante - Au moment de la rédaction de ce document, vous avez installé TYPO3 CMS v11.5 avec des serveurs web httpd/Apache, PHP 8.0, et le serveur de base de données MariaDB.

Conclusion

Dans ce guide, vous avez installé un système de gestion de contenu de niveau entreprise TYPO3 CMS sur un serveur Rocky Linux 9. Vous avez installé TYPO3 CMS avec le serveur web httpd, le serveur de base de données MariaDB, et PHP 8.0.

En plus de cela, vous avez également installé Certbot pour générer des certificats SSL de Letsencrypt. Et également sécurisé l’installation de TYPO3 CMS via des certificats SSL/TLS et configuré la redirection automatique de HTTP vers HTTPS via Certbot.

Avec cela, vous pouvez commencer votre configuration TYPO3 CMS en créant un enregistrement de site, en ajoutant des utilisateurs backend, et en ajoutant une langue backend pour activer le multilingue. Pour en savoir plus sur TYPO3 CMS, visitez la documentation officielle de TYPO3.