Comment installer le framework web PHP Laravel sur Ubuntu 20.04

Laravel est un framework PHP open-source largement utilisé pour le développement d’applications web. Le modèle architectural MVC (Modèle-Vue-Contrôleur) est implémenté dans Laravel. Le projet Laravel a été lancé par Taylor Otwell en 2011 comme une alternative sophistiquée au framework CodeIgniter (CI).

Les versions 1 et 2 de Laravel ont été publiées en 2011. Un schéma de versionnage, une politique de support, des balises de composants Blade et des améliorations, des opérations de chaînes fluides, des améliorations de liaison de modèle de route et d’autres améliorations ont été ajoutées à la version actuelle 8.x.

Sur le serveur Ubuntu 20.04, cet article vous apprendra comment installer la dernière version de Laravel 8.x en utilisant le serveur web Apache. Nous vous montrerons comment installer le framework web Laravel sur Linux de deux manières distinctes.

Prérequis

• Système Ubuntu 20.04
• 2 Go de RAM ou plus
• Privilèges root
• Compréhension de l’utilisation de base du système Debian/Ubuntu

Que allons-nous faire ?

• Installer le serveur web Apache
• Installer et configurer PHP 7.4
• Installer Composer pour la gestion des paquets PHP
• Installer le framework web Laravel
• Configurer l’hôte virtuel Apache pour le projet Laravel
• Tester

Étape 1 - Installer le serveur web Apache

Tout d’abord, nous allons installer le serveur web Apache sur le système Ubuntu 20.04 et configurer le pare-feu UFW qui n’autorise que les connexions entrantes pour certains services, y compris SSH, HTTP et HTTPS.

Mettez à jour tous les dépôts disponibles sur votre système et installez le serveur web Apache en utilisant la commande apt ci-dessous.

sudo apt update  
sudo apt install apache2

Une fois toutes les installations terminées, démarrez le service Apache et ajoutez-le au démarrage du système.

systemctl start apache2  
systemctl enable apache2

Maintenant, vérifiez l’état du service Apache en utilisant la commande suivante.

systemctl status apache2

Voici le résultat que vous obtiendrez.

En conséquence, le service Apache est opérationnel.

Ensuite, ajoutez les services SSH, HTTP et HTTPS au pare-feu UFW en utilisant la commande suivante.

for svc in ssh http https  
do   
ufw allow $svc  
done

Maintenant, activez les services du pare-feu UFW.

sudo ufw enable

Tapez ‘ y ‘ pour continuer, et le pare-feu UFW a été activé.

Ensuite, ouvrez votre navigateur web et tapez l’adresse IP de votre serveur dans la barre d’adresse.

http://10.5.5.25/

Et vous obtiendrez la page index.html par défaut d’Apache.

En conséquence, l’installation du serveur web Apache et la configuration du pare-feu UFW ont été complétées.

Étape 2 - Installer et configurer PHP 7.4

Dans cette étape, nous allons installer et configurer PHP 7.4 pour notre installation de Laravel. Pour installer Laravel 8.x, vous devez avoir PHP >= 7.2.5 sur votre système. Et par défaut, le dépôt officiel d’Ubuntu 20.04 fournit des paquets PHP 7.4.

Installez les paquets PHP 7.4 en utilisant la commande apt ci-dessous.

sudo apt install libapache2-mod-php php php-common php-xml php-gd php-opcache php-mbstring php-tokenizer php-json php-bcmath php-zip unzip

Une fois toutes les installations terminées, allez dans le répertoire ‘/etc/php/7.4/‘ et éditez la configuration ‘php.ini’ pour le serveur web Apache2.

cd /etc/php/7.4/  
vim apache2/php.ini

Décommentez l’option ‘cgi.fix_pathinfo’ et changez la valeur en ‘0’.

cgi.fix_pathinfo=0 

Enregistrez et fermez.

Ensuite, redémarrez le service Apache pour appliquer la nouvelle configuration ‘php.ini’.

systemctl restart apache2

En conséquence, la configuration de base de PHP 7.4 a été complétée avec succès.

Étape 3 - Installer Composer pour la gestion des paquets PHP

Composer est un gestionnaire de dépendances pour PHP. C’est un gestionnaire de paquets au niveau de l’application pour PHP qui vous permet de télécharger des dépendances et des bibliothèques PHP supplémentaires pour votre projet PHP.

Dans ce tutoriel, nous utiliserons Composer pour installer Laravel, et nous installerons Composer en téléchargeant le fichier binaire de composer depuis le site officiel de composer.

Téléchargez le fichier binaire de Composer et déplacez le fichier dans le répertoire ‘/usr/local/bin’.

curl -sS https://getcomposer.org/installer | php  
sudo mv composer.phar /usr/local/bin/composer

Après cela, vérifiez la version de composer en utilisant la commande suivante.

composer --version

Voici le résultat que vous obtiendrez.

Comme vous pouvez le voir, la gestion des paquets PHP Composer a été installée dans le système Ubuntu.

Étape 4 - Installer Laravel 8.x sur Ubuntu 20.04

Pour cette étape, nous allons vous montrer deux façons différentes d’installer le framework web Laravel. Nous allons installer Laravel via l’installateur Laravel et l’installer via Composer.

- Installer Laravel via l’installateur Laravel

Ce type d’installation est le plus adapté pour les développeurs Laravel. Parce que lorsque vous utilisez l’installateur Laravel, vous pouvez installer Laravel partout avec un utilisateur non-root.

Cette section installera le framework web Laravel avec l’utilisateur non-root nommé ‘hakase’.

Vous pouvez ajouter l’utilisateur et définir son mot de passe en utilisant la commande suivante.

useradd -m -s /bin/bash hakase  
passwd hakase

Après cela, connectez-vous à l’utilisateur ‘hakase’.

su - hakase

Ensuite, installez le paquet de l’installateur Laravel en utilisant la commande composer ci-dessous.

composer global require laravel/installer

Une fois toutes les installations terminées, vous obtiendrez le résultat suivant.

Comme vous pouvez le voir, tous les paquets ont été installés dans le répertoire ‘~/.config/composer’.

Ensuite, nous devons ajouter le répertoire ‘bin’ à la variable d’environnement PATH via la configuration ~/.bashrc.

Éditez la configuration ~/.bashrc en utilisant l’éditeur vim.

vim ~/.bashrc

Collez la configuration suivante à la fin de la ligne.

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

Enregistrez et fermez.

Maintenant, chargez la nouvelle version de la configuration ~/.bashrc et vérifiez la variable d’environnement $PATH.

source ~/.bashrc  
echo $PATH

Voici le résultat que vous obtiendrez.

Le répertoire ‘bin’ pour les paquets composer a été ajouté à la variable d’environnement $PATH. Et en conséquence, vous pouvez utiliser la commande ‘laravel’ pour démarrer et créer un nouveau projet.

En conséquence, vous pouvez maintenant utiliser la commande ‘laravel’ pour créer un nouveau projet.

Pour créer un nouveau projet Laravel nommé ‘blog’, exécutez la commande laravel ci-dessous.

laravel new blog

Maintenant, vous obtiendrez le répertoire de projet Laravel ‘blog’.

Pour le rendre accessible au serveur web Apache pour accéder à votre répertoire de projet Laravel, changez le groupe propriétaire du répertoire du projet en groupe ‘www-data’ et rendez le répertoire ‘storage’ inscriptible.

sudo chgrp -R www-data /home/hakase/blog  
sudo chmod -R 775 /home/hakase/blog/storage

En conséquence, Laravel est installé en utilisant l’installateur Laravel, et vous êtes prêt à configurer l’hôte virtuel Apache pour votre projet Laravel.

- Installer Laravel via Composer create-project

Une autre façon d’installer le framework web Laravel est d’utiliser la gestion des paquets PHP Composer.

Allez dans le répertoire ‘/var/www/‘ et créez un nouveau projet Laravel nommé ‘blog’ en utilisant la commande ‘composer’ ci-dessous.

cd /var/www/  
composer create-project --prefer-dist laravel/laravel blog

Maintenant, vous obtiendrez le nouveau répertoire de projet nommé ‘blog’.

Ensuite, changez la propriété du répertoire de projet ‘blog’ à l’utilisateur ‘www-data’ et rendez le répertoire ‘storage’ inscriptible.

sudo chown -R www-data:www-data /var/www/blog  
sudo chmod -R 775 /var/www/blog/storage

En conséquence, vous avez installé le framework web Laravel en utilisant la commande Composer.

Étape 5 - Configurer Apache pour le projet Laravel

Dans cette étape, nous allons configurer l’hôte virtuel Apache pour le projet Laravel.

Maintenant, allez dans le répertoire ‘/etc/apache/sites-available’ et créez une nouvelle configuration d’hôte virtuel ‘laravel.conf’ en utilisant l’éditeur vim.

cd /etc/apache2/sites-available/  
vim laravel.conf

Changez le nom de domaine et le répertoire webroot avec les vôtres et collez la configuration dedans.

  
    ServerName hakase-labs.io  
  
    ServerAdmin [email protected]  
    DocumentRoot /home/hakase/blog/public  
  
      
    Options Indexes MultiViews  
    AllowOverride None  
    Require all granted  
      
  
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  

Enregistrez et fermez.

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

sudo a2enmod rewrite  
sudo a2ensite laravel.conf

Après cela, testez la configuration d’Apache, assurez-vous qu’il n’y a pas d’erreur, et redémarrez le service Apache.

apachectl configtest  
systemctl restart apache2

En conséquence, la configuration de l’hôte virtuel Apache pour Laravel a été complétée.

Étape 6 - Tester

Ouvrez votre navigateur web et tapez l’adresse IP de votre serveur ou le nom de domaine dans la barre d’adresse.

http://hakase-labs.io/

Voici le résultat que vous obtiendrez.

En conséquence, l’installation et la configuration de Laravel avec le serveur web Apache ont été complétées avec succès.

Référence

• https://laravel.com/docs/8.x/installation