Comment installer TYPO3 CMS sur Ubuntu 24.04

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

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

Dans ce guide, vous installerez TYPO3 sur le serveur Ubuntu 24.04. Vous installerez TYPO3 avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP), Composer et GraphicsMagick.

Prérequis

Pour commencer ce guide, assurez-vous d’avoir ce qui suit :

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

Installation des dépendances

TYPO3 est un système de gestion de contenu open-source écrit en PHP et prend en charge des bases de données telles que MySQL/MariaDB et PostgreSQL. Dans cette section, vous installerez les dépendances pour TYPO3, qui incluent la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP), Composer comme gestionnaire de dépendances PHP, et GraphicsMagick pour le traitement d’images.

Avant de commencer, mettez à jour votre index de paquets Ubuntu avec la commande ci-dessous.

sudo apt update

Maintenant, installez les dépendances de paquets pour TYPO3 CMS avec la commande ‘apt install’ suivante. Avec cette commande, vous installerez des dépendances telles que la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP), Composer comme gestionnaire de paquets PHP, Git et GraphicsMagick pour le traitement automatique des images.

sudo apt install apache2 mariadb-server composer graphicsmagick php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-gmagick php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

Tapez Y pour continuer avec l’installation.

Lorsque l’installation est terminée, vérifiez l’état des services Apache et MariaDB, puis vérifiez les versions de PHP, Composer et GraphicsMagick.

Vérifiez l’état du service Apache avec la commande ci-dessous. Vous devriez obtenir la sortie du service Apache comme ‘ enabled ‘ et ‘active (running)’.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Ensuite, vérifiez l’état du service MariaDB en utilisant la commande suivante. La sortie devrait être similaire à Apache, vous verrez que le serveur MariaDB est ‘ enabled ‘ et ‘ active (running) ‘.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Maintenant, exécutez la commande ci-dessous pour vérifier les versions de PHP et Composer. Sur Ubuntu 24.04, la version PHP par défaut est 8.3, et Composer est 2.7.1.

php -v  
sudo -u www-data composer --version

Enfin, vérifiez la version de GraphicsMagick en utilisant la commande ci-dessous. Vous devriez voir GraphicsMagick 1.3 installé sur votre système Ubuntu.

gm version

Configuration de PHP

Pour installer TYPO3, vous devez modifier le fichier de configuration PHP par défaut ‘php.ini’. Vous devez éditer le fichier ‘php.ini’ pour Apache et PHP CLI, puis changer certaines configurations par défaut pour l’installation de TYPO3.

Éditez le fichier ‘php.ini’ pour Apache et PHP CLI avec la commande de l’éditeur nano suivante.

sudo nano /etc/php/8.3/apache2/php.ini  
sudo nano /etc/php/8.3/cli/php.ini

Changez la configuration par défaut avec ce qui suit. Assurez-vous d’ajuster les options ‘ memory_limit ‘ et ‘ date.timezone ‘ selon votre environnement serveur.

date.timezone = Europe/Amsterdam  
memory_limit = 512M  
max_execution_time = 240  
max_input_vars = 1500  
post_max_size = 50M  
upload_max_filesize = 50M

Enregistrez le fichier et quittez.

Maintenant, exécutez la commande ci-dessous pour redémarrer le service Apache et appliquer vos modifications sur PHP.

sudo systemctl restart apache2

Après cela, exécutez la commande suivante pour créer un nouveau fichier ‘info.php’ dans le répertoire ‘ /var/www/html ‘.

echo "" > /var/www/html/info.php

Enfin, visitez http://192.168.5.30/info.php en utilisant votre navigateur web préféré. Vous verrez les détails de vos configurations PHP, assurez-vous que tout ce que vous avez configuré via ‘ php.ini ‘ est appliqué.

Vérifiez la section ‘Core’ pour voir le ‘ memory_limit ‘, ‘ post_max_size ‘, ‘ max_execution_time ‘, et d’autres de votre installation PHP.

Configuration du serveur MariaDB

Maintenant que vous avez configuré PHP, vous devez sécuriser le serveur MariaDB, puis créer une nouvelle base de données et un utilisateur pour TYPO3. Dans cette section, vous sécuriserez MariaDB en utilisant l’utilitaire ‘ mariadb-secure-installation ‘ et créerez une nouvelle base de données et un utilisateur depuis la ligne de commande.

Sécurisez votre installation de serveur MariaDB en exécutant la commande ‘ mariadb-secure-installation ‘ ci-dessous.

sudo mariadb-secure-installation

Maintenant, vous serez invité à configurer le serveur MariaDB. Entrez Y pour accepter le paramètre par défaut ou n pour le rejeter.

• L’installation par défaut de MariaDB se fait sans mot de passe, appuyez sur ENTRÉE lorsque vous êtes invité pour le mot de passe.
• Maintenant, saisissez Y pour configurer le mot de passe root de MariaDB. Ensuite, tapez le nouveau mot de passe pour MariaDB et répétez le mot de passe.
• Saisissez Y pour supprimer l’utilisateur anonyme de votre installation MariaDB.
• Saisissez Y à nouveau lorsque vous êtes invité à désactiver la connexion à distance pour l’utilisateur root de MariaDB.
• Saisissez Y pour supprimer la base de données par défaut test de votre MariaDB.
• Enfin, saisissez Y pour recharger les privilèges des tables et appliquer les nouvelles modifications.

Après avoir configuré le serveur MariaDB, connectez-vous à MariaDB avec la commande suivante. Saisissez votre mot de passe root MariaDB lorsque vous y êtes invité.

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données, ‘typo3db’, et un nouvel utilisateur, ‘typo3’, avec le mot de passe ‘Typo3Password’. Changez les informations de la base de données selon vos besoins.

CREATE DATABASE typo3db;  
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'Typo3Password';  
FLUSH PRIVILEGES;

Ensuite, exécutez la requête ci-dessous pour vérifier les privilèges de l’utilisateur ‘ typo3 ‘. Cela garantira que l’utilisateur ‘ typo3 ‘ peut accéder à la base de données ‘ typo3db ‘ pour votre installation TYPO3 CMS.

SHOW GRANTS FOR typo3@localhost;

La sortie ci-dessous vous montre que l’utilisateur ‘ typo3 ‘ peut accéder à la base de données ‘ typo3db ‘.

Enfin, tapez quit pour quitter le serveur MariaDB.

Téléchargement de TYPO3 via Composer

Il existe plusieurs façons d’installer et de télécharger le code source de TYPO3. Maintenant, vous allez configurer le répertoire d’installation de TYPO3, puis télécharger TYPO3 en utilisant Composer (gestion des dépendances PHP).

Tout d’abord, exécutez la commande suivante pour créer de nouveaux répertoires pour le cache et la configuration de Composer, et le répertoire d’installation de TYPO3 ‘ /var/www/typo3 ‘.

sudo mkdir -p /var/www/{.cache,.config,typo3}

Maintenant, exécutez la commande ci-dessous pour changer la propriété des répertoires ci-dessus à l’utilisateur ‘ www-data ‘, puis activez l’accès en lecture et en écriture au répertoire ‘/var/www/typo3 ‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,typo3}  
sudo chmod u+rw /var/www/typo3

Ensuite, allez dans le répertoire ‘ /var/www/typo3 ‘ et installez TYPO3 CMS avec la commande ‘ composer ‘ ci-dessous. Dans cet exemple, vous installerez la dernière version de TYPO3 CMS v12 sur votre serveur Ubuntu.

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

Vous pouvez voir ci-dessous le processus de téléchargement et d’installation de TYPO3 CMS :

Configuration de TYPO3 via la ligne de commande

Après avoir téléchargé le code source de TYPO3 CMS, vous allez configurer l’installation de TYPO3 en utilisant la ligne de commande. Vous pouvez également configurer l’installation de TYPO3 en utilisant un navigateur web, mais maintenant vous allez configurer l’installation de TYPO3 CMS depuis votre terminal.

Pour configurer l’installation de TYPO3 CMS via la commande, exécutez ce qui suit :

./vendor/bin/typo3 setup

Vous serez invité avec les configurations suivantes :

• Tapez apache comme serveur web.
• Tapez mysqli comme pilote de base de données.
• Saisissez les détails de votre utilisateur MariaDB, mot de passe, port et hôte qui seront utilisés pour TYPO3 CMS.
• Tapez typo3db comme nom de base de données.
• Tapez votre utilisateur administrateur, mot de passe et adresse e-mail pour TYPO3 CMS. Votre mot de passe doit contenir au moins un caractère spécial.
• Pour le nom du projet, laissez-le par défaut.
• Appuyez sur ENTRÉE lorsque vous êtes invité à créer le site de base.

Si votre installation est réussie, vous verrez une sortie ‘ Félicitations - La configuration de TYPO3 est terminée ‘.

Enfin, réexécutez la commande suivante pour changer la propriété du répertoire ‘ /var/www/typo3 ‘ à l’utilisateur ‘ www-data ‘.

sudo chown -R www-data:www-data /var/www/typo3

Configuration de l’hôte virtuel Apache

Maintenant que vous avez configuré TYPO3 depuis le terminal, passons à la configuration de l’hôte virtuel Apache pour votre installation TYP3. Assurez-vous donc que vous avez préparé votre nom de domaine.

Tout d’abord, activez le module ‘ rewrite ‘ d’Apache avec la commande suivante.

sudo a2enmod rewrite

Ensuite, créez un nouveau fichier d’hôte virtuel ‘ /etc/apache2/sites-available/typo3.conf ‘ en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/apache2/sites-available/typo3.conf

Insérez la configuration suivante et assurez-vous de changer l’option ServerName avec votre nom de domaine TYPO3 CMS. Dans cet exemple, TYPO3 CMS fonctionnera sur le domaine ‘ howtoforge.local ‘.

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

Maintenant, exécutez la commande ci-dessous pour activer le fichier d’hôte virtuel ‘typo3.conf’ et vérifier votre syntaxe Apache. La sortie ‘ Syntax OK ‘ sera affichée, si vous avez une syntaxe Apache correcte.

sudo a2ensite typo3.conf  
sudo apachectl configtest

Enfin, redémarrez le service Apache avec la commande ci-dessous pour appliquer votre hôte virtuel TYPO3 CMS. Lorsque vous l’exécutez, votre installation TYPO3 CMS sera prête.

sudo systemctl restart apache2

Sécurisation de TYPO3 CMS avec HTTPS

Dans cette section, vous sécuriserez TYPO3 CMS avec HTTPS en utilisant Certbot et Letsencrypt. Certbot sera utilisé pour générer des certificats SSL/TLS de Letsencrypt. De plus, vous utiliserez le plugin Certbot Apache pour configurer HTTPS automatique sur vos hôtes virtuels.

Installez Certbot et le plugin Certbot Apache avec la commande ci-dessous. Tapez Y pour continuer avec l’installation.

sudo apt install certbot python3-certbot-apache

Après l’installation, exécutez la commande ‘certbot’ ci-dessous pour générer des certificats SSL/TLS pour votre nom de domaine TYPO3 CMS. Assurez-vous donc de changer le nom de domaine et l’adresse e-mail avec vos informations.

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

Lorsque le processus est terminé, votre TYPO3 CMS sera sécurisé avec HTTPS automatiquement. Vos certificats SSL/TLS sont disponibles dans le répertoire ‘ /etc/letsencrypt/live/domain.com ‘.

Accéder à TYPO3

Visitez la page de connexion TYPO3 CMS à https://howtoforge.local/typo3 en utilisant votre navigateur web préféré. Si votre installation est réussie, vous devriez obtenir la page de connexion TYPO3 CMS.

Saisissez votre utilisateur admin et mot de passe, puis cliquez sur Connexion pour confirmer.

Après vous être connecté, vous verrez le tableau de bord d’administration TYPO3 CMS comme suit :

Dans le menu en haut à droite, cliquez sur l’icône d’information pour obtenir des détails sur votre pile TYPO3 CMS. Comme vous pouvez le voir ci-dessous, le TYPO3 CMS 12.4 est installé avec Apache 2.4.58, le serveur MariaDB 10.11, PHP 8.3, et le mode Composer est activé.

Conclusion

Félicitations ! Vous avez installé TYPO3 CMS sur le serveur Ubuntu 24.04. Vous avez TYPO3 CMS fonctionnant avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP), le traitement d’images GraphicsMagick, et le mode Composer activé. Vous avez également sécurisé TYPO3 CMS avec HTTPS en utilisant Certbot et Letsencrypt.