Comment installer le framework PHP Laravel sur Alma Linux 9

Laravel est un framework d’application web basé sur PHP qui est utilisé pour construire des applications web d’entreprise et robustes. Il suit l’architecture modèle-vue-contrôleur (MVC) et est basé sur Symfony. Laravel 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.

Ce tutoriel vous montrera comment installer Laravel sur le serveur Alma Linux 9. Nous vous guiderons à travers l’installation de Laravel avec la pile LAMP (Linux, Apache/Httpd, MariaDB et PHP) et Composer.

Prérequis

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

Un serveur Alma Linux 9.
Un utilisateur non-root avec des privilèges d’administrateur.
Un nom de domaine local.
Un SELinux en mode permissif.

Installation de la pile LAMP et de Composer

Laravel est l’un des frameworks PHP les plus populaires pour la création d’applications web. Pour installer Laravel, vous devez installer des dépendances, y compris la pile LAMP (Apache/Httpd, MariaDB et PHP) et Composer. Actuellement, Laravel nécessite PHP 8.3. Vous devez installer PHP 8.3 via un dépôt tiers.

Tout d’abord, ajoutez le dépôt tiers EPEL et Remi à votre serveur Alma Linux en utilisant la commande ci-dessous. Le dépôt EPEL sera utilisé pour installer des paquets comme Composer, tandis que le dépôt Remi fournit plusieurs versions de PHP pour Laravel.

sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

ajouter le dépôt

Maintenant, activez le dépôt PHP 8.3 via Remi en utilisant la commande ci-dessous.

sudo dnf reset php -y  
sudo dnf module enable php:remi-8.3 -y

Ensuite, installez la pile LAMP (Apache/Httpd, MariaDB et PHP) et les paquets Composer avec la commande suivante. Entrez y pour confirmer l’installation.

sudo dnf install httpd mariadb-server composer php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

installer les dépendances

Une fois l’installation terminée, démarrez et activez le service httpd avec la commande ci-dessous.

sudo systemctl start httpd  
sudo systemctl enable httpd

Ensuite, démarrez et activez le serveur MariaDB avec la commande suivante.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Maintenant, vérifiez les versions de PHP et de Composer en utilisant la commande ci-dessous. Vous devriez voir que PHP 8.3 et Composer 2.7.1 sont installés.

php -v  
sudo -u apache composer -v

vérifier php et composer

Enfin, exécutez la commande ci-dessous pour vérifier vos modules PHP. Assurez-vous que fileinfo, mbstring et openssl sont activés.

php -m

Configuration de MariaDB

Avec PHP configuré, vous allez sécuriser le serveur MariaDB et créer une nouvelle base de données et un utilisateur pour Laravel. Le serveur MariaDB fournit un utilitaire mariadb-secure-installation pour sécuriser le serveur MariaDB et le client MariaDB pour se connecter au serveur MariaDB via la ligne de commande.

Pour sécuriser le serveur MariaDB, exécutez la commande ci-dessous et vous serez invité à certaines configurations du serveur MariaDB. Entrez Y ou N pour accepter ou refuser d’appliquer les nouvelles modifications de MariaDB.

sudo mariadb-secure-installation

Voici quelques-unes des configurations du serveur MariaDB pour lesquelles vous serez interrogé :

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 définir votre nouveau mot de passe root MariaDB.
Supprimer l’utilisateur anonyme ? Entrez y pour confirmer.
Interdire la connexion root à distance ? Entrez y pour confirmer. Seule la connexion locale sera autorisée si vous utilisez l’utilisateur root de MariaDB.
Supprimer la base de données de test et l’accès à celle-ci ? 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 des tables sur votre serveur MariaDB et appliquer les nouvelles modifications.

Après avoir sécurisé MariaDB, vous allez créer une nouvelle base de données et un utilisateur pour Laravel via le client mariadb.

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

sudo mariadb -u root -p

Maintenant, exécutez les requêtes suivantes pour créer une nouvelle base de données et un utilisateur pour Laravel. Dans cet exemple, vous allez créer une nouvelle base de données laravelapp, un utilisateur laravel, avec le mot de passe p4ssw0rd. Ajustez les détails de la base de données et de l’utilisateur ci-dessous avec vos informations.

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

créer une base de données

Ensuite, exécutez la requête ci-dessous pour vérifier les privilèges de l’utilisateur laravel. Assurez-vous que l’utilisateur laravel peut accéder à la base de données laravelapp.

SHOW PRIVILEGES FOR laravel@localhost;

Enfin, tapez quit pour quitter le serveur MariaDB.

afficher les privilèges

Création du projet Laravel

Vous avez donc configuré à la fois PHP et MariaDB, téléchargeons et installons Laravel sur votre système. Vous allez créer et configurer le répertoire du projet, puis télécharger et installer le projet Laravel via Composer.

Créez de nouveaux répertoires pour le projet Laravel /var/www/laravelapp et des répertoires supplémentaires .cache et .config pour stocker le cache et la configuration de Composer. Ensuite, changez la propriété de ces répertoires à l’utilisateur apache.

mkdir -p /var/www/laravelapp /usr/share/httpd/.composer/{.cache,.config}  
sudo chown -R apache:apache /var/www/laravelapp /usr/share/httpd/.composer

Allez dans le répertoire /var/www/laravelapp et exécutez la commande composer ci-dessous pour télécharger et installer Laravel.

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

Le processus de téléchargement devrait ressembler à ceci :

installer Laravel

Une fois Laravel téléchargé, ouvrez le fichier .env en utilisant la commande de l’éditeur nano suivante.

nano .env

Changez l’APP_URL avec votre nom de domaine local, puis changez les détails de la base de données avec vos informations de base de données MariaDB.

APP_URL=http://dev.hwdomain.local  
DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=laravelapp  
DB_USERNAME=laravel  
DB_PASSWORD=password

Une fois terminé, enregistrez le fichier et quittez.

Maintenant, exécutez la commande ci-dessous pour migrer la base de données et remplir vos tables avec de nouvelles données d’exemple.

sudo -u apache php artisan migrate  
sudo -u apache php artisan db:seed

migrer la base de données

Configuration de l’hôte virtuel Httpd

Après avoir installé Laravel, vous allez créer une nouvelle configuration d’hôte virtuel Httpd que Laravel utilisera. Pour cela, assurez-vous d’avoir un nom de domaine local ou tout autre domaine aléatoire que vous souhaitez. Vous pouvez configurer ce domaine plus tard.

Créez une nouvelle configuration d’hôte virtuel httpd /etc/httpd/conf.d/laravel.conf en utilisant la commande de l’éditeur nano suivante.

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

Insérez la configuration suivante et assurez-vous de changer l’option ServerName avec votre nom de domaine Laravel.

  
  
 ServerAdmin [email protected]  
 ServerName dev.hwdomain.local  
 DocumentRoot /var/www/laravelapp/public  
  
   
 Options FollowSymLinks  
 AllowOverride None  
   
   
 AllowOverride All  
   
  
 ErrorLog /var/log/httpd/laravel-error.log  
 CustomLog /var/log/httpd/laravel-access.log combined

Enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande ci-dessous pour vérifier votre configuration httpd. Si vous avez la bonne syntaxe httpd, vous devriez obtenir une sortie Syntax OK.

sudo apachectl configtest

Enfin, redémarrez le service httpd pour appliquer votre nouvelle configuration d’hôte virtuel pour Laravel.

sudo systemctl restart httpd

configurer vhost

Configuration de Firewalld

Avant d’accéder à votre installation Laravel, vous devez ouvrir les ports HTTP et HTTPS sur votre système, ce qui peut être fait via Firewalld.

Ouvrez le trafic HTTP et HTTPS à votre serveur Alma Linux avec la commande ci-dessous.

sudo firewall-cmd --add-service=http --permanent  
sudo firewall-cmd --add-service=https --permanent

Maintenant, rechargez firewalld pour appliquer les modifications.

sudo firewall-cmd --reload

Enfin, vérifiez les règles de la liste firewalld en utilisant la commande suivante. Vous verrez les services HTTP et HTTPS ajoutés à firewalld.

sudo firewall-cmd --list-all

configurer firewalld

Accéder à Laravel depuis un ordinateur local

Pour configurer un nom de domaine local pour votre installation Laravel, utilisez ce qui suit :

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

Insérez la configuration ci-dessous et assurez-vous de changer l’adresse IP et le nom de domaine avec vos informations.

192.168.5.60 dev.hwdomain.local

Enregistrez et quittez le fichier.

Maintenant, ouvrez votre navigateur web et visitez votre installation Laravel http://dev.hwdomain.local/. Si votre installation est réussie, vous devriez obtenir la page d’index Laravel suivante.

laravel

Conclusion

Félicitations ! Vous avez terminé l’installation de Laravel sur Alma Linux 9 avec la pile LAMP (Linux, Apache/Httpd, MariaDB et PHP) et Composer. Vous avez également configuré firewalld pour ouvrir les ports HTTP et HTTPS, puis configuré le nom de domaine local pour votre développement Laravel via le fichier /etc/hosts ou le fichier C:\Windows\System32\drivers\etc\hosts.