Comment installer Laravel sur Debian 12

Laravel est un framework d’application web basé sur PHP pour la création d’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.

Associer le framework web Laravel avec un autre framework tel que React ou Vue vous permet de créer un frontend beau et interactif. De plus, il prend en charge plusieurs bases de données, y compris MySQL, PostgreSQL, SQLite et SQL Server. Laravel fournit également une structure pour une authentification sécurisée.

Dans ce guide, nous vous montrerons comment installer Laravel étape par étape sur Debian 12, afin que vous puissiez commencer avec le projet Laravel. Nous vous montrerons comment installer Laravel avec le serveur web Apache2, MariaDB et PHP 8.2.

Prérequis

Voici les exigences que vous devez suivre pour ce guide :

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

Installation de la pile LAMP

La première étape que vous devez effectuer est d’installer la pile LAMP (Apache2, MariaDB et PHP) sur votre serveur Debian. Ensuite, vous allez également vérifier les services Apache2 et MariaDB pour vous assurer que le service fonctionne.

Avant d’installer les paquets, exécutez la commande apt update pour mettre à jour et rafraîchir les dépôts Debian.

sudo apt update

Une fois le dépôt mis à jour, installez la pile LAMP (paquets Apache2, PHP et MariaDB) en exécutant la commande apt install ci-dessous. La commande suivante installe également certaines des extensions PHP nécessaires à Laravel.

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

Entrez y pour confirmer et procéder à l’installation.

Avec la pile LAMP installée, exécutez la commande systemctl ci-dessous pour vérifier les services apache2 et mariadb. Si le service fonctionne, vous devriez obtenir la sortie active (en cours d’exécution).

sudo systemctl status apache2  
sudo systemctl status mariadb

Pour le service apache2, vous devriez obtenir une sortie comme ceci :

Et ci-dessous se trouve l’état du service mariadb.

Ensuite, exécutez la commande php ci-dessous pour vérifier la version de PHP et les modules activés sur PHP. Vous devriez voir PHP 8.2 installé avec certains modules activés, tels que curl, date, dom et exif.

php -v  
php -m

Enfin, lancez votre navigateur web et visitez l’adresse IP de votre serveur Debian (c’est-à-dire : http://192.168.10.15/). Si l’installation est réussie, vous devriez obtenir la page index.html du serveur web Apache.

Configuration de PHP

Pour installer Laravel, il y a certaines extensions PHP que vous devez activer, telles que fileinfo, mbstring et openssl. Vous pouvez activer ces extensions via le fichier php.ini.

Utilisez l’éditeur nano suivant pour ouvrir le fichier de configuration PHP /etc/php/8.2/apache2/php.ini.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

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

Ensuite, exécutez la commande systemctl suivante pour redémarrer le service apache2 et appliquer les modifications.

sudo systemctl restart apache2

Ensuite, assurez-vous que les extensions PHP fileinfo, mbstring et openssl sont activées en exécutant la commande php ci-dessous.

sudo php -m

Créez maintenant un nouveau fichier phpinfo /var/www/html/info.php en utilisant la commande ci-dessous. Si votre installation de PHP et du serveur web Apache2 réussit, cela vous montrera des informations détaillées sur votre installation PHP.

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

Ouvrez votre navigateur web préféré et visitez l’adresse IP du serveur suivie du chemin du fichier info.php (c’est-à-dire : http://192.168.10.15/info.php). Si cela réussit, vous devriez voir une sortie comme ceci :

Configuration du serveur MariaDB

Après avoir configuré PHP, vous allez configurer votre serveur MariaDB, ce qui inclut la sécurisation du serveur MariaDB via l’utilitaire mariadb-secure-installation, puis la création d’une nouvelle base de données et d’un utilisateur pour votre projet Laravel.

Tout d’abord, exécutez la commande mariadb-secure-installation ci-dessous pour sécuriser votre installation du serveur MariaDB. Au cours du processus, vous serez interrogé sur certaines configurations de MariaDB, saisissez Y pour confirmer la configuration ou n pour Non.

sudo mariadb-secure-installation

Voici quelques-unes des configurations de MariaDB sur lesquelles vous serez interrogé pendant le processus :

• Appuyez sur ENTER lorsque vous êtes invité à entrer le mot de passe root de MariaDB.
• Saisissez n lorsque vous êtes interrogé sur la méthode d’authentification unix_socket.
• Saisissez Y pour configurer un nouveau mot de passe pour l’utilisateur root de MariaDB. Ensuite, saisissez le nouveau mot de passe et répétez.
• Saisissez Y pour supprimer l’utilisateur anonyme par défaut de MariaDB.
• Ensuite, saisissez Y à nouveau pour désactiver la connexion à distance pour l’utilisateur root de MariaDB.
• Saisissez Y pour supprimer la base de données de test par défaut de MariaDB.
• Enfin, saisissez Y à nouveau pour recharger les privilèges des tables et appliquer les modifications.

Après avoir configuré 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 via la commande mariadb ci-dessous. Saisissez votre mot de passe MariaDB lorsque vous y êtes invité.

sudo mariadb -u root -p

Exécutez maintenant les requêtes suivantes pour créer une nouvelle base de données testapp, l’utilisateur testapp et le mot de passe password. Assurez-vous de changer le mot de passe dans la requête suivante.

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

Ensuite, exécutez la requête ci-dessous pour vous assurer que l’utilisateur testapp peut accéder à la base de données testapp.

SHOW GRANTS FOR testapp@localhost;

La sortie ci-dessous confirme que l’utilisateur testapp peut accéder à la base de données testapp.

Enfin, tapez quit pour quitter le serveur MariaDB et terminer cette étape.

Installation de Composer

Laravel peut être installé de plusieurs manières, et la plus simple est de l’installer via Composer, le gestionnaire de paquets PHP. Maintenant, vous allez installer Composer sur votre serveur Debian.

Pour installer le gestionnaire de paquets PHP Composer, exécutez la commande apt install ci-dessous. Tapez y lorsque vous y êtes invité pour procéder à l’installation.

sudo apt install composer

Après l’installation, exécutez la commande suivante pour localiser le fichier binaire de Composer et vérifier la version de Composer.

which composer  
sudo -u www-data composer --version

Le fichier binaire de Composer est situé à /usr/bin/composer et Composer 2.5.5 est installé.

Création du premier projet Laravel

Avec tout en place, vous êtes prêt à installer et créer le premier projet Laravel. Vous allez créer le premier projet Laravel avec MariaDB comme base de données.

Tout d’abord, créez un nouveau répertoire racine de document /var/www/testapp pour votre projet et changez la propriété à l’utilisateur www-data via la commande ci-dessous. Vous allez également créer les répertoires /var/www/.cache et /var/www/.config qui seront utilisés par Composer.

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

Déplacez-vous maintenant dans le répertoire /var/www/testapp/ et exécutez la commande composer ci-dessous pour créer le premier projet Laravel. Votre premier projet Laravel est stocké dans le répertoire /var/www/testapp/.

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

Pendant l’installation, vous devriez obtenir une sortie similaire à ceci :

Avec le projet Laravel créé, vous allez maintenant configurer la base de données pour votre projet via le fichier de configuration .env. Le fichier .env est utilisé comme configuration de base pour votre projet Laravel.

Utilisez la commande d’éditeur nano suivante pour ouvrir le fichier .env.

nano .env

Changez le paramètre APP_URL avec le nom de domaine local de votre projet Laravel. De cette façon, vous pouvez accéder à votre projet via un nom de domaine local. Dans ce cas, le nom de domaine est testapp.local.

APP_URL=http://testapp.local

Changez maintenant la configuration de la base de données DB_CONNECTION en mysql et changez les détails de DB_DATABASE, DB_USERNAME et DB_PASSWORD avec vos détails de base de données et d’utilisateur MariaDB.

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

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

Exécutez maintenant la commande suivante pour migrer la base de données. Cela créera des tables pour le projet Laravel.

sudo -u www-data php artisan migrate

Configuration de l’hôte virtuel Apache

Dans l’étape suivante, vous allez créer une nouvelle configuration d’hôte virtuel Apache2 pour votre projet Laravel. Après cela, vous devez activer l’hôte virtuel et vérifier les configurations d’Apache2, puis redémarrer le serveur web Apache2 pour appliquer les modifications.

Avant de créer la configuration d’hôte virtuel Apache2 pour Laravel, vous devez activer le module rewrite sur Apache2 via la commande ci-dessous.

sudo a2enmod rewrite

Utilisez la commande d’éditeur nano suivante pour créer la configuration d’hôte virtuel Apache2 /etc/apache2/sites-available/laravel.conf.

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

Insérez la configuration suivante et changez le paramètre ServerName avec votre nom de domaine.

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

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

Ensuite, exécutez la commande suivante pour activer la configuration d’hôte virtuel laravel.conf et vérifier les configurations d’Apache2. Si vous avez des configurations correctes, vous devriez obtenir un message tel que Syntax OK.

sudo a2ensite laravel.conf  
sudo apachectl configtest

Enfin, redémarrez le service apache2 en exécutant la commande ci-dessous et en appliquant les modifications que vous avez effectuées.

sudo systemctl restart apache2

Accéder à Laravel

Si vous êtes sur un client Linux, modifiez le fichier /etc/hosts via la commande d’éditeur nano ci-dessous.

sudo nano /etc/hosts

Si vous êtes sur une machine Windows, modifiez le fichier C:\Windows\System32\drivers\etc\hosts.

Insérez le nom de domaine de votre projet Laravel et l’adresse IP de votre serveur Debian comme ceci :

192.168.10.15   testapp.local

Enregistrez le fichier et quittez l’éditeur.

Enfin, lancez votre navigateur web et visitez le nom de domaine local de votre projet Laravel (c’est-à-dire : http://testapp.local). Si cela réussit, vous devriez obtenir une page similaire à Laravel comme ceci :

Conclusion

En conclusion, vous avez installé Laravel avec la pile LAMP (Apache2, MariaDB et PHP) sur le serveur Debian 12. Vous avez également installé Composer, le gestionnaire de paquets PHP, et l’avez utilisé comme moyen d’installation pour Laravel. Avec cela en tête, vous pouvez maintenant développer votre application en utilisant le framework web Laravel et MariaDB comme base de données pour vos applications.