Installation et configuration de Laravel avec Nginx sur Ubuntu 20.04

Hark Labs2022-01-17 · 13 min read

Installation et configuration de Laravel avec Nginx sur Ubuntu 20.04

Introduction

Laravel est un framework d'application web qui est livré avec un ensemble d'outils et de ressources intégrés pour développer des applications PHP modernes. Il est réputé pour sa fiabilité, ses performances, son efficacité, sa modularité et sa sécurité. En raison de ses diverses fonctionnalités intégrées, Laravel a connu une croissance incroyable de sa popularité. De nombreux développeurs adoptent Laravel pour simplifier le processus de développement web.

Ce guide expliquera comment installer et configurer une nouvelle application Laravel sur Ubuntu 20.04.

Laravel sur Ubuntu

Nous utiliserons Composer, un gestionnaire de dépendances PHP, pour télécharger et gérer Laravel. Pour installer Composer, suivez les instructions de ce tutoriel. Le serveur Nginx servira l'application. Il établira une application Laravel de démonstration en utilisant la base de données MySQL.

Ce guide nécessite quelques prérequis. Nous supposons que vous disposez déjà d'un serveur Ubuntu 20.04 correctement configuré et opérationnel. Pour référence, voici un guide rapide sur la configuration d'un serveur Ubuntu. Il est également nécessaire d'avoir la pile LEMP (Linux, Nginx, MySQL et PHP) installée et configurée. Nous disposons d'un guide détaillé sur l'installation et la configuration de la pile LEMP.

Comme nous allons installer divers paquets, cela nécessite les privilèges root. Dans le cas d'Ubuntu, l'utilisateur root est désactivé par défaut. Nous devons donc avoir accès à un utilisateur non-root disposant des privilèges sudo. Voici comment accorder la permission sudo à d'autres utilisateurs.

Étape 1 – Installation des modules PHP

Avant d'installer Laravel, nous avons besoin de certains modules PHP importants pour le framework. Ces modules sont directement disponibles dans les dépôts de paquets par défaut d'Ubuntu. Ils prennent en charge des fonctionnalités telles que le codage des caractères, le XML et les mathématiques de précision.

Tout d'abord, mettez à jour le cache APT et installez les paquets :

$ sudo apt update
$ sudo apt install php-mbstring php-xml php-bcmath

1 2	$ sudo apt update $ sudo apt install php-mbstring php-xml php-bcmath

Étape 2 – Création d'une base de données pour l'application

Pour illustrer le fonctionnement de Laravel, nous allons créer une application de liste de voyage qui affiche la liste des lieux que l'utilisateur souhaite visiter, ainsi qu'une liste des lieux déjà visités. Nous pouvons stocker ces données dans une table place avec les champs name (nom du lieu) et visited (marquant comme visité ou non visité). Un champ supplémentaire comportera un identifiant unique pour chaque entrée. Pour connecter les données à notre application Laravel, nous allons créer un utilisateur MySQL dédié et lui accorder tous les privilèges sur la base de données travellist.

La bibliothèque PHP MySQL native mysqlnd ne prend plus en charge caching_sha2_authentication. Par conséquent, nous devons configurer notre base de données avec la méthode d'authentification mysql_native_password. Accédez au shell MySQL en tant que root:

$ sudo mysql

1	$ sudo mysql

Ensuite, créez une nouvelle base de données nommée travellist:

> CREATE DATABASE travellist;

1	> CREATE DATABASE travellist;

Après cela, créez un utilisateur dédié travellist_user avec un mot de passe approprié :

> CREATE USER 'travellist_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password123';

1	> CREATE USER 'travellist_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password123';

Donnez à l'utilisateur travellist_user tous les privilèges sur la base de données travellist. Cela empêchera également l'utilisateur de créer et de modifier toute autre base de données sur le serveur :

> GRANT ALL ON travellist.* TO 'travellist_user'@'%';

1	> GRANT ALL ON travellist.* TO 'travellist_user'@'%';

Quittez le shell MySQL :

> exit

> exit

Mettons le nouvel utilisateur à l'épreuve. La commande suivante permettra de se connecter au shell MySQL en tant qu'utilisateur travellist_user. Le drapeau -p demandera le mot de passe de l'utilisateur :

$ mysql -u travellist_user -p

1	$ mysql -u travellist_user -p

Affichez toutes les bases de données disponibles. Comme configuré précédemment, cela ne devrait afficher que travellist et information_schema uniquement :

> SHOW DATABASES;

1	> SHOW DATABASES;

Ensuite, nous devons créer la table de données places. Exécutez l'instruction MySQL suivante :

> CREATE TABLE travellist.places (
id INT AUTO_INCREMENT,
name VARCHAR(255),
visited BOOLEAN,
PRIMARY KEY(id)
);

> CREATE TABLE travellist.places (

id INT AUTO_INCREMENT,

name VARCHAR(255),

visited BOOLEAN,

PRIMARY KEY(id)

);

Peuplons la table avec quelques exemples de données :

> INSERT INTO travellist.places (name, visited)
VALUES ("Tokyo", false),
("Delhi", true),
("Shanghai", false),
("Moscow", true),
("Lisbon", true),
("Denver", false),
("Berlin", false),
("Istanbul", false),
("Rio", true),
("Beijing", false),
("Helsinki", false);

> INSERT INTO travellist.places (name, visited)

VALUES ("Tokyo", false),

("Delhi", true),

("Shanghai", false),

("Moscow", true),

("Lisbon", true),

("Denver", false),

("Berlin", false),

("Istanbul", false),

("Rio", true),

("Beijing", false),

("Helsinki", false);

Voyons si les données ont été stockées avec succès dans la base de données :

> SELECT * FROM travellist.places;

1	> SELECT * FROM travellist.places;

Comme nous pouvons le voir, la table de test est peuplée de données valides. Nous pouvons maintenant quitter le shell MySQL :

> exit

> exit

Étape 3 – Création d'une nouvelle application Laravel

Nous sommes maintenant prêts à créer une nouvelle application Laravel en utilisant Composer. Nous utiliserons travellist comme application de démonstration. Cette application affichera la liste des emplacements de la base de données MySQL, démontrant la configuration de base de Laravel. Allez dans le répertoire personnel de l'utilisateur :

$ cd ~

$ cd ~

L'étape suivante consiste à créer une nouvelle application Laravel à l'aide de Composer. Cela créera un répertoire dédié travellist avec une application Laravel minimale avec les paramètres par défaut. Exécutez la commande suivante :

$ composer create-project --prefer-dist laravel/laravel travellist

1	$ composer create-project --prefer-dist laravel/laravel travellist

Une fois l'application créée, nous pouvons vérifier si tous les composants ont été installés avec succès :

$ cd travellist
$ php artisan

1 2	$ cd travellist $ php artisan

La sortie vérifie que tous les fichiers de l'application sont en place. Elle garantit également que tous les outils en ligne de commande de Laravel sont fonctionnels. Cependant, elle nécessite encore une configuration de l'application pour configurer la base de données et quelques ajustements supplémentaires.

Étape 4 – Configuration de Laravel

Tous les fichiers de configuration de Laravel sont stockés dans un répertoire nommé config dans le répertoire racine de l'application. De plus, lors de l'installation de Laravel avec Composer, cela crée également un fichier d'environnement. Il contient divers paramètres spécifiques à l'environnement actuel. Les valeurs qui y sont déclarées prévaudront sur les valeurs définies dans les fichiers de configuration habituels dans config.

Chaque installation unique nécessitera son propre fichier d'environnement pour définir des valeurs telles que les paramètres de connexion à la base de données, l'URL de l'application, les options de débogage, etc. Notez que le fichier d'environnement contient des informations sensibles telles que les identifiants de base de données, les clés de sécurité, etc. C'est pourquoi il est fortement recommandé de ne jamais partager ce fichier publiquement.

Ouvrez le fichier d'environnement avec un éditeur de texte :

$ nano .env

1	$ nano .env

Voici un exemple de code d'environnement :

APP_NAME=TravelList
APP_ENV=development
APP_KEY=<unique_app_key>
APP_DEBUG=true
APP_URL=http://<domain_or_ip>
LOG_CHANNEL=stack
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=travellist
DB_USERNAME=travellist_user
DB_PASSWORD=password123

APP_NAME=TravelList

APP_ENV=development

APP_KEY=<unique_app_key>

APP_DEBUG=true

APP_URL=http://<domain_or_ip>

LOG_CHANNEL=stack

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=travellist

DB_USERNAME=travellist_user

DB_PASSWORD=password123

Analysons les valeurs :

APP_NAME : Ce champ décrit le nom de l'application. Ce nom sera utilisé pour les notifications et les messages.
APP_ENV : L'environnement actuel de l'application.
APP_KEY : Cette clé est générée automatiquement lors de l'installation de Laravel via Composer. Elle est utilisée pour générer des sels et des hachages. Pas besoin de la modifier.
APP_DEBUG : Activation du mode de débogage. Lorsqu'il est activé, il affiche des informations de débogage côté client.
APP_URL : URL de base de l'application. Elle est également utilisée pour générer des liens d'application.
DB_DATABASE : Le nom de la base de données. Dans ce cas, il s'agira de la base de données dédiée que nous avons créée.
DB_USERNAME : Le nom d'utilisateur pour se connecter à la base de données.
DB_PASSWORD : Le mot de passe pour se connecter à la base de données.

Une fois les modifications effectuées, enregistrez le fichier et fermez l'éditeur.

Étape 5 – Configuration de Nginx

Nous avons installé Laravel avec succès dans un dossier local du répertoire personnel de l'utilisateur. Cette configuration fonctionne bien pour l'environnement de développement local. Cependant, il n'est pas recommandé de l'implémenter pour des serveurs web ouverts sur l'internet public.

Notre prochaine étape consiste à déplacer l'application vers /var/www car c'est l'emplacement habituel des applications web fonctionnant sous Nginx. Utilisez la commande mv pour déplacer travellist vers /var/www/travellist:

$ sudo mv ~/travellist /var/www/travellist

1	$ sudo mv ~/travellist /var/www/travellist

Ensuite, attribuez à l'utilisateur l'accès en écriture aux dossiers storage et cache. Ce sont les emplacements des fichiers générés par l'application Laravel :

$ sudo chown -R www-data.www-data /var/www/travellist/storage
$ sudo chown -R www-data.www-data /var/www/travellist/bootstrap/cache

1 2	$ sudo chown -R www-data.www-data /var/www/travellist/storage $ sudo chown -R www-data.www-data /var/www/travellist/bootstrap/cache

Les fichiers de l'application sont maintenant en place. Cependant, nous devons indiquer à Nginx de servir le contenu. Créez un nouveau fichier de configuration d'hôte virtuel :

$ sudo nano /etc/nginx/sites-available/travellist

1	$ sudo nano /etc/nginx/sites-available/travellist

Voici un exemple de paramètres recommandés pour une application Laravel fonctionnant sous Nginx :

server {
listen 80;
server_name <domain_or_ip>;
root /var/www/travellist/public;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-XSS-Protection "1; mode=block";
add_header X-Content-Type-Options "nosniff";
index index.html index.htm index.php;
charset utf-8;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }
error_page 404 /index.php;
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}
}

server {

listen 80;

server_name <domain_or_ip>;

root /var/www/travellist/public;

add_header X-Frame-Options "SAMEORIGIN";

add_header X-XSS-Protection "1; mode=block";

add_header X-Content-Type-Options "nosniff";

index index.html index.htm index.php;

charset utf-8;

location / {

try_files $uri $uri/ /index.php?$query_string;

}

location = /favicon.ico { access_log off; log_not_found off; }

location = /robots.txt { access_log off; log_not_found off; }

error_page 404 /index.php;

location ~ \.php$ {

fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;

fastcgi_index index.php;

fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;

include fastcgi_params;

}

location ~ /\.(?!well-known).* {

deny all;

}

Il est temps d'activer le nouveau fichier de configuration de l'hôte virtuel. Créez un lien symbolique vers le répertoire sites-enabled :

$ sudo ln -s /etc/nginx/sites-available/travellist /etc/nginx/sites-enabled/

1	$ sudo ln -s /etc/nginx/sites-available/travellist /etc/nginx/sites-enabled/

La commande Nginx suivante testera les fichiers de configuration pour détecter d'éventuelles erreurs de syntaxe :

$ sudo nginx -t

1	$ sudo nginx -t

Ensuite, rechargez Nginx :

$ sudo systemctl reload nginx

1	$ sudo systemctl reload nginx

L'application devrait maintenant être disponible en utilisant le nom de domaine ou l'adresse IP (comme défini par la directive server_name) :

Étape 6 – Personnalisation de la page principale

Une fois l'application Laravel configurée, nous pouvons commencer à travailler dessus. À des fins de démonstration, il est temps de créer une page d'exemple présentant les données d'exemple de la table de base de données places. Tout d'abord, ouvrez le fichier de route principal dans un éditeur de texte :

$ nano routes/web.php

1	$ nano routes/web.php

Le fichier contiendra du contenu par défaut. Ici, les routes sont définies à l'aide de la méthode statique (Route::get). Elle reçoit un path et une callback fonction en tant qu'arguments.

Remplacez le code par le suivant :

<?php
use Illuminate\Support\Facades\DB;
Route::get('/', function () {
$visited = DB::select('select * from places where visited = ?', [1]);
$togo = DB::select('select * from places where visited = ?', [0]);
return view('travellist', ['visited' => $visited, 'togo' => $togo ] );
});

<?php

use Illuminate\Support\Facades\DB;

Route::get('/', function () {

$visited = DB::select('select * from places where visited = ?', [1]);

$togo = DB::select('select * from places where visited = ?', [0]);

return view('travellist', ['visited' => $visited, 'togo' => $togo ] );

});

Enregistrez le fichier et fermez l'éditeur. Ensuite, nous allons créer la mise en page pour présenter les résultats de la requête de base de données à l'utilisateur. Créez un nouveau fichier dans resource/views:

$ nano resources/views/travellist.blade.php

1	$ nano resources/views/travellist.blade.php

Dans le code suivant, nous avons créé deux listes de lieux en fonction de la valeur de visited et togo:

<html>
<head>
    <title>Liste de voyage</title>
</head>

<body>
    <h1>Ma liste de voyages à faire</h1>
    <h2>Lieux à visiter</h2>
    <ul>
        @foreach ($togo as $newplace)
        <li>{{ $newplace->name }}</li>
        @endforeach
    </ul>
    <h2>Déjà visités</h2>
    <ul>
        @foreach ($visited as $place)
        <li>{{ $place->name }}</li>
        @endforeach
    </ul>
</body>
</html>

<html>

<head>

<title>Liste de voyage</title>

</head>

<body>

<h1>Ma liste de voyages à faire</h1>

<h2>Lieux à visiter</h2>

<ul>

@foreach ($togo as $newplace)

<li>{{ $newplace->name }}</li>

@endforeach

</ul>

<h2>Déjà visités</h2>

<ul>

@foreach ($visited as $place)

<li>{{ $place->name }}</li>

@endforeach

</ul>

</body>

</html>

Enregistrez le fichier et fermez l'éditeur. Maintenant, accédez à nouveau à la page de l'application web :

Voilà ! Nous avons maintenant une application Laravel fonctionnelle utilisant une base de données MySQL pour le contenu.

Conclusion

Dans ce tutoriel, nous avons montré comment configurer une application Laravel sur une pile LEMP s'exécutant sur un serveur Ubuntu 20.04. Nous avons également montré comment personnaliser la route par défaut pour interroger le contenu de la base de données et afficher les résultats dans une vue personnalisée. Pour plus d'informations sur Laravel, consultez la documentation officielle sur les vues, routes, et la prise en charge des bases de données.

L'installation de ce tutoriel est effectuée sur une machine virtuelle autonome. Cependant, vous pouvez également déployer Laravel sur des piles LEMP sur Docker.

Bon développement !

Hark Labs

Auteur · CloudSigma

Preslav Dobrev est un designer créatif chez CloudSigma, axé sur une identité commerciale cohérente à travers des canaux marketing traditionnels et innovants. Il excelle à fusionner la vision artistique avec le marketing stratégique pour créer des récits de marque percutants.