Comment installer le framework PHP Laravel avec Apache 2 sur Ubuntu 22.04

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 tutoriel, vous apprendrez comment installer Laravel sur le dernier Ubuntu 22.04 LTS. Cela inclura également comment configurer la pile LAMP pour le développement Laravel.

Prérequis

• Une machine Ubuntu 22.04. Cet exemple utilise le serveur Ubuntu.
• Un utilisateur non-root avec des privilèges d’administrateur sudo, ou vous pouvez également utiliser l’utilisateur root.

Installation du serveur web Apache

Dans cette première étape, vous allez installer le serveur web Apache2 sur votre système Ubuntu. Dans cet exemple, vous exécuterez le framework web Laravel avec le serveur web Apache.

Maintenant, exécutez la commande apt ci-dessous pour mettre à jour et rafraîchir votre dépôt Ubuntu.

sudo apt update

Ensuite, installez le paquet du serveur web Apache2 en utilisant la commande suivante.

sudo apt install apache2

Entrez Y pour confirmer et appuyez sur ENTRER pour commencer l’installation. L’installation du serveur web Apache commencera.

Après l’installation d’Apache2, vous devrez ajouter les services HTTP et HTTPS au pare-feu UFW.

Exécutez la commande ufw ci-dessous pour ajouter les services HTTP et HTTPS au pare-feu UFW.

sudo ufw allow "Apache Full"

Enfin, ouvrez votre navigateur web et saisissez l’adresse IP du serveur dans la barre d’adresse (par exemple http://192.168.10.15). Vous devriez maintenant voir la page index.html par défaut du serveur web Apache2.

Installation de PHP 8.1

Après l’installation du serveur web Apache, vous allez installer et configurer PHP sur la machine Ubuntu 22.04. Le dépôt par défaut d’Ubuntu 22.04 fournit le paquet PHP v8.1, et il est bien supporté pour le framework web Laravel.

Exécutez la commande apt ci-dessous pour installer les paquets PHP pour le framework web Laravel.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

Entrez Y pour confirmer l’installation et appuyez sur ENTRER pour continuer. L’installation de PHP commencera.

Maintenant, après l’installation de PHP, éditez le fichier de configuration php.ini en utilisant l’éditeur nano.

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

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

extension=fileinfo  
extension=mbstring  
extension=openssl

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, redémarrez le service Apache2 pour appliquer les nouvelles modifications à votre configuration PHP.

sudo systemctl restart apache2

Enfin, testez et vérifiez votre configuration PHP en exécutant la commande suivante.

Vérifiez la version de PHP installée sur votre machine Ubuntu.

php --version

Dans la capture d’écran ci-dessous, vous pouvez voir que PHP 8.1.2 est installé sur la machine Ubuntu.

Vérifiez toutes les extensions activées dans votre environnement PHP.

php -m

Installation du serveur MariaDB

Vous avez maintenant installé le serveur web Apache2 et les paquets PHP. Maintenant, vous allez installer et configurer le serveur de base de données MariaDB sur la machine Ubuntu 22.04. Vous allez également créer une nouvelle base de données MariaDB et un utilisateur pour le projet Laravel.

Pour installer la base de données MariaDB sur la machine Ubuntu, vous pouvez exécuter la commande apt ci-dessous.

sudo apt install mariadb-server

Entrez Y pour confirmer et appuyez sur ENTRER pour commencer l’installation.

Après l’installation de MariaDB, connectez-vous à l’interface de commande de MariaDB en tant qu’utilisateur root en utilisant la commande ci-dessous.

sudo mysql -u root -p

Maintenant, exécutez les requêtes MariaDB ci-dessous pour créer une nouvelle base de données et un utilisateur pour le projet Laravel. Dans cet exemple, vous allez créer la base de données laravelapp avec l’utilisateur laravel et le mot de passe est “ password “.

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

Maintenant, exécutez la requête “ EXIT “ pour vous déconnecter de l’interface de commande de MariaDB. Vous avez maintenant installé le serveur de base de données MariaDB et créé une nouvelle base de données et un utilisateur pour le projet Laravel.

Installation de Composer

Dans cette section, vous allez installer Composer. C’est un gestionnaire de paquets pour le langage de programmation PHP, il est comme pip sur Python, le gem sur Ruby, npm ou yarn pour Node.js.

Le framework web Laravel peut être installé de plusieurs manières. Dans cet exemple, vous allez installer le framework web Laravel en utilisant Composer.

Maintenant, exécutez la commande ci-dessous pour télécharger l’installateur pour Composer.

curl -sS https://getcomposer.org/installer -o composer-setup.php

Maintenant, exécutez le script d’installation “composer-setup.php” pour installer Composer. Cela installera Composer dans le répertoire /usr/local/bin.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Ci-dessous se trouve la capture d’écran lors de l’installation de Composer.

Maintenant, après l’installation, exécutez la commande ci-dessous pour vérifier et valider l’installation de Composer.

Vérifiez la version de Composer.

sudo -u www-data composer --version

Montrez le contenu d’aide de Composer.

sudo -u www-data composer --help

Maintenant, vous êtes prêt à commencer l’installation de Laravel.

Commencer l’installation de Laravel

Avant de commencer l’installation de Laravel, créons de nouveaux répertoires pour le projet Laravel.

Dans cet exemple, vous allez créer trois répertoires, “.cache” pour stocker le cache des paquets PHP, le répertoire “.config” pour stocker la configuration supplémentaire de Composer, et le répertoire “laravelapp” pour le projet Laravel lui-même. Tous ces répertoires seront disponibles sous le répertoire “ /var/www
“.

Exécutez la commande ci-dessous pour créer de nouveaux répertoires pour l’installation de Laravel.

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

Maintenant, changez la propriété des répertoires Laravel et Composer à l’utilisateur et au groupe www-data.

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

Ensuite, déplacez-vous dans le répertoire /var/www/laravelapp en utilisant la commande suivante.

cd /var/www/laravelapp/

Puis installez le framework web Laravel en utilisant la commande composer ci-dessous. Le point à la fin de la commande installera Laravel dans le répertoire de travail actuel /var/www/laravelapp.

sudo -u www-data composer create-project laravel/laravel .

Ci-dessous se trouve la capture d’écran du processus d’installation de Laravel.

Et ci-dessous se trouve le résultat après l’installation de Laravel.

Ensuite, après l’installation, éditez le fichier “.env” en utilisant l’éditeur nano. Cette configuration est la configuration principale de l’environnement pour Laravel, qui inclut l’URL de l’installation, les détails de la base de données, etc.

nano .env

Changez la configuration APP_URL avec votre domaine pour l’installation de Laravel. Dans cet exemple, Laravel sera exécuté sur le nom de domaine laravelapp.howtoforge.local.

APP_URL=http://laravelapp.howtoforge.local

Maintenant, changez les détails de la base de données avec votre configuration de base de données.

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

Enregistrez et fermez le fichier lorsque vous avez terminé.

Vous avez maintenant terminé l’installation du framework web Laravel avec le serveur de base de données MariaDB.

Configuration de l’hôte virtuel Apache

Il est maintenant temps de configurer l’hôte virtuel Apache2 pour le framework web Laravel. Dans cet exemple, le projet Laravel sera exécuté sur le domaine local laravelapp.howtoforge.local.

Créez un nouveau fichier “ /etc/apache2/sites-available/laravel.conf “ en utilisant l’éditeur nano.

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

Ajoutez la configuration suivante au fichier. Si vous utilisez votre nom de domaine, vous pouvez changer le domaine. Assurez-vous également de changer le chemin de la racine du document pour le projet Laravel.

  
  
    ServerAdmin [email protected]  
    ServerName laravelapp.howtoforge.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 et fermez le fichier lorsque vous avez terminé.

Ensuite, activez le module de réécriture Apache2 et activez la configuration de l’hôte virtuel laravel.conf en utilisant la commande suivante.

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Maintenant, vérifiez la configuration d’Apache2 et assurez-vous qu’il n’y a pas d’erreur.

sudo apachectl configtest

Maintenant, redémarrez le service Apache2 pour appliquer une nouvelle configuration d’hôte virtuel pour le projet Laravel en utilisant la commande ci-dessous.

sudo systemctl restart apache2

Vous avez maintenant terminé la configuration de l’hôte virtuel Apache pour Laravel.

Sur votre machine, éditez le fichier /etc/hosts en utilisant l’éditeur nano/vim.

sudo nano /etc/hosts

Ajoutez la configuration suivante. Assurez-vous de changer le nom de domaine et l’adresse IP avec les détails de votre serveur.

192.168.10.15 laravelapp.howtoforge.local

Enregistrez et fermez le fichier lorsque vous avez terminé.

Enfin, retournez à votre navigateur web et saisissez l’URL d’installation de Laravel (c’est-à-dire http://laravelapp.howtoforge.local) dans la barre d’adresse. Vous devriez voir la page d’index par défaut du framework web Laravel. De plus, en bas, vous pouvez voir la version de Laravel que vous venez d’installer et la version de PHP que vous utilisez actuellement.

Conclusion

Félicitations ! Vous avez maintenant installé avec succès le framework web Laravel sur Ubuntu 22.04. Vous avez également appris la configuration de base de la pile LAMP pour le framework web Laravel.