Comment installer le framework PHP Laravel sur Ubuntu 24.04

Laravel est un framework d’application web basé sur PHP qui est utilisé pour construire des applications web d’entreprise. C’est un framework web gratuit et open source qui suit l’architecture modèle-vue-contrôleur (MVC) et est basé sur Symfony. Il fournit une syntaxe élégante qui vous permet de créer des applications avec un code propre et facile à lire et à comprendre.

Laravel est un framework web de niveau entreprise pour construire des applications web robustes et complètes. Les applications Laravel peuvent être livrées rapidement sans tracas, du processus de développement à la production.

Ce guide vous apprendra comment installer le framework web Laravel sur le serveur Ubuntu 24.04. Vous installerez Laravel avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) et le gestionnaire de paquets PHP Composer.

Prérequis

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

• Un serveur Ubuntu 24.04.
• Un utilisateur non-root avec des privilèges d’administrateur

Installation de la pile LAMP et de Composer

Laravel est un framework web PHP populaire pour le développement web moderne. Vous devez donc vous assurer que PHP et d’autres dépendances sont installés sur votre serveur Ubuntu. Dans cette section, vous installerez Laravel avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) et Composer.

Avant d’installer le paquet, exécutez la commande suivante pour mettre à jour votre dépôt Ubuntu.

sudo apt update

Maintenant, exécutez la commande suivante pour installer les dépendances de Laravel, y compris la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP), Composer et Git.

sudo apt install apache2 mariadb-server php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip composer git

Tapez Y pour continuer l’installation.

Une fois l’installation terminée, vérifiez l’état des services Apache et MariaDB. Ensuite, vérifiez les versions de PHP et de Composer.

Vérifiez l’état du service Apache avec la commande suivante. Le service Apache par défaut sur Ubuntu doit être activé et en cours d’exécution automatiquement.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Sortie :

Maintenant, vérifiez le service MariaDB en utilisant la commande ci-dessous. Le serveur MariaDB doit être activé et en cours d’exécution sur votre système Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Sortie :

Enfin, vérifiez les versions de PHP et de Composer en utilisant la commande ci-dessous. Vous verrez PHP 8.3 et Composer 2.7.1 installés sur votre système.

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

Optionnel : Installer Node.js et NPM (Gestionnaire de paquets Node.js)

Node.js et NPM sont nécessaires si vous utilisez Laravel avec un moteur de template tel que Blade et JavaScript. Dans cette section, vous installerez à la fois Node.js et NPM (Gestionnaire de paquets Node.js) via le dépôt Ubuntu.

Pour installer Node.js et NPM sur votre système Ubuntu, exécutez ce qui suit :

sudo apt install nodejs npm

Tapez Y pour confirmer l’installation.

Lorsque l’installation est terminée, entrez la commande ci-dessous pour vérifier la version de Node.js et de NPM.

node --version  
npm --version

La sortie suivante montre que Node.js 18 et NPM 9.5 sont installés.

Configurer PHP

Pour exécuter Laravel, vous devez vous assurer que certaines extensions PHP sont activées, telles que fileinfo, mbstring, et openssl. Vous devez donc charger ces extensions PHP en modifiant le fichier ‘php.ini’.

À l’aide de l’éditeur nano, éditez le fichier de configuration PHP par défaut ‘/etc/php/8.3/apache2/php.ini’.

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

Décommentez les lignes suivantes pour activer les extensions PHP fileinfo, mbstring, et openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Enregistrez le fichier et quittez l’éditeur.

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

sudo systemctl restart apache2

Ensuite, vérifiez les extensions PHP fileinfo, mbstring, et openssl avec la commande suivante. Si ces extensions sont activées, chaque nom d’extension sera affiché.

sudo php -m | grep 'fileinfo\|mbstring\|openssl'

De plus, vous pouvez vérifier la liste des extensions PHP activées via PHPINFO. Créez un nouveau fichier PHPINFO avec la commande suivante.

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

Ensuite, visitez http://192.168.5.30/info.php. Vérifiez les extensions fileinfo, mbstring, et openssl pour vous assurer que ces extensions sont activées.

Configurer le serveur MariaDB

Après avoir configuré PHP, vous devez sécuriser votre serveur MariaDB et créer une nouvelle base de données et un utilisateur pour Laravel.

Exécutez la commande ‘mariadb-secure-installation’ ci-dessous pour sécuriser votre serveur MariaDB. Vous serez maintenant invité à configurer le serveur MariaDB.

sudo mariadb-secure-installation

Lorsque vous y êtes invité, saisissez Y pour appliquer la nouvelle configuration ou tapez N pour la rejeter.

• L’installation par défaut de MariaDB se fait sans mot de passe. Appuyez sur ENTRER lorsque vous êtes invité à entrer 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 sécurisé le serveur MariaDB, vous devez créer une nouvelle base de données et un utilisateur pour votre projet Laravel.

Connectez-vous au serveur MariaDB en utilisant la commande ci-dessous. 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 et un utilisateur ‘laravelapp‘, avec le mot de passe ‘password‘.

CREATE DATABASE laravelapp;  
CREATE USER laravelapp@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON laravelapp.* TO laravelapp@localhost;  
FLUSH PRIVILEGES;

Ensuite, exécutez la requête suivante pour vérifier les privilèges de l’utilisateur ‘laravelapp‘. Cela garantira que votre utilisateur peut accéder à la base de données Laravel ‘laravelapp‘.

SHOW GRANTS FOR laravelapp@localhost;

Enfin, tapez quit pour quitter le serveur MariaDB.

Installer Laravel via Composer

Maintenant que vous avez configuré PHP et créé une base de données MySQL/MariaDB et un utilisateur, vous pouvez installer Laravel. Dans cette section, vous allez configurer le répertoire du projet, installer Laravel via Composer et intégrer Laravel avec la base de données MySQL/MariaDB.

Tout d’abord, exécutez la commande ci-dessous pour créer les répertoires /var/www/.cache (pour le cache de Composer), /var/www/.config (pour la configuration supplémentaire de Composer), et /var/www/laravelapp (pour votre projet Laravel).

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

Maintenant, changez la propriété des répertoires /var/www/.cache, /var/www/.config, et /var/www/laravelapp à l’utilisateur ‘www-data‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

Ensuite, allez dans le répertoire /var/www/laravelapp et installez Laravel avec la commande Composer ci-dessous.

cd /var/www/laravelapp/  
sudo -u www-data composer create-project laravel/laravel .

L’installation de Laravel devrait commencer comme suit :

Maintenant, ouvrez le fichier ‘.env’ en utilisant la commande de l’éditeur nano ci-dessous.

nano .env

Changez le ‘ APP_URL ‘ par défaut avec votre nom de domaine local. Dans cet exemple, Laravel s’exécutera sur le domaine ‘laravelapp.local’.

APP_URL=http://laravelapp.local

Changez le ‘ DB_CONNECTION ‘ par défaut en ‘ mysql ‘, décommentez et changez les détails de la base de données avec vos informations.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravelapp  
DB_PASSWORD=password

Enregistrez et quittez le fichier.

Enfin, exécutez la commande ci-dessous pour migrer la base de données pour votre projet Laravel.

sudo -u www-data php artisan migrate

Sortie de la migration de la base de données Laravel :

Configurer un hôte virtuel pour Laravel

Dans cette section, vous allez configurer le fichier d’hôte virtuel pour Laravel. Assurez-vous d’avoir le nom de domaine local prêt pour votre développement Laravel.

Avant de créer un hôte virtuel, activez le module ‘ rewrite ‘ d’Apache avec la commande ci-dessous.

sudo a2enmod rewrite

Créez une nouvelle configuration d’hôte virtuel ‘/etc/apache2/sites-available/laravelapp.conf‘ avec l’éditeur nano.

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

Ajoutez la configuration suivante et changez l’option ServerName avec votre nom de domaine Laravel, tel que ‘laravelapp.local‘.

  
  
 ServerAdmin [email protected]  
 ServerName laravelapp.local  
 DocumentRoot /var/www/laravelapp/public  
  
   
 Options FollowSymLinks  
 AllowOverride None  
   
   
 AllowOverride All  
   
  
 ErrorLog ${APACHE_LOG_DIR}/error.log  
 CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande ci-dessous pour activer l’hôte virtuel ‘ laravelapp.conf ‘ et vérifier votre syntaxe Apache. S’il n’y a pas d’erreur, vous devriez voir la sortie ‘Syntax OK‘.

sudo a2ensite laravelapp.conf  
sudo apachectl configtest

Redémarrez le service Apache pour appliquer le nouveau fichier d’hôte virtuel Laravel. Après le redémarrage d’Apache, votre installation de Laravel est prête.

sudo systemctl restart apache2

Accéder au projet Laravel

À ce stade, vous êtes prêt à accéder à votre installation Laravel via le fichier ‘hosts’.

Pour les utilisateurs de Linux ou MacOS, modifiez le fichier ‘/etc/hosts‘ avec des privilèges root. Pour les utilisateurs de Windows, ouvrez le fichier ‘C:\Windows\System32\drivers\etc\hosts‘ en tant qu’administrateur.

Ajoutez l’adresse IP de votre serveur Ubuntu suivie du nom de domaine Laravel comme suit :

192.168.5.30 laravelapp.local

Enregistrez et quittez le fichier.

Maintenant, visitez http://laravelapp.local/ avec votre navigateur web. Si votre installation de Laravel est réussie, vous devriez obtenir la page suivante :

Conclusion

Félicitations ! Vous avez terminé l’installation de Laravel sur Ubuntu 24.04. Vous avez Laravel fonctionnant avec la pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) et appris la commande Composer de base pour créer un projet.