Installer et héberger Laravel sur Ubuntu 18.04 Bionic Beaver Linux

Objectif

Installer Laravel avec Nginx et MariaDB sur Ubuntu 18.04

Distributions

Ubuntu 18.04 Castor bionique

Exigences

Une installation fonctionnelle d’Ubuntu 18.04 avec les privilèges root

Difficulté

Facile

Conventions

• # – nécessite que les commandes Linux données soient exécutées avec les privilèges root, soit directement en tant qu’utilisateur root, soit en utilisant la commande sudo
• $ – nécessite que des commandes Linux données soient exécutées en tant qu’utilisateur régulier non privilégié

Introduction

Laravel a rapidement gagné sa place de meilleur framework PHP. Il a apporté à l’écosystème PHP de nombreuses fonctionnalités conviviales pour les développeurs que l’on trouve dans d’autres frameworks comme Rails, et ce faisant, a modernisé le développement PHP.

Si vous cherchez à développer avec Laravel ou à l’héberger sur Ubuntu 18.04, le processus d’installation n’a jamais été aussi facile. Étant donné que Laravel est PHP, il existe plusieurs façons de gérer cela, mais Nginx et MariaDB offrent un moyen assez simple de faire fonctionner votre projet avec des outils modernes prêts pour la production.

Installer les packages

Avant de pouvoir commencer à tout configurer, vous aurez besoin de quelques packages. Ils sont tous disponibles dans les dépôts d’Ubuntu, et ils sont tous assez récents dans Bionic, il n’y a donc aucune raison de chercher ailleurs.

sudo apt install composer php-mysql php-fpm php-mbstring php-tokenizer php-xml php-json php-common nginx mariadb-server

Ils tireront plus, mais ce ne sera pas trop mal.

Créez votre projet Lavavel

La prochaine chose que vous devrez faire est de démarrer votre projet Laravel. Ce n’est pas non plus une tâche trop importante. Le paquet Composer que vous avez installé précédemment gère à peu près tout pour vous et vous donnera une installation fonctionnelle de Laravel prête à l’emploi.

Commencez par changer de répertoire dans votre répertoire /var/www/. Étant donné que cela va être servi avec Nginx, c’est le meilleur endroit pour organiser vos sites.

cd /var/www

Ensuite, utilisez Composer pour créer votre projet. Le nom à la fin est le nom de votre projet et du dossier qui le contient. Choisissez-le en conséquence.

sudo composer create-project --prefer-dist laravel/laravel yourProject

Installer Laravel avec Composer sur Ubuntu 18.04

Composer téléchargera et installera automatiquement toutes les dépendances PHP avec Laravel et les configurera. Avant de pouvoir commencer à travailler avec votre projet et à le servir, modifiez la propriété de Nginx.

sudo chown -R www-data:www-data yourProject

Configurer votre base de données

Ensuite, vous allez devoir configurer votre base de données. Avant de commencer à ajouter quoi que ce soit, sécurisez votre serveur.

sudo mysql-secure-install

Passez en revue, configurez votre mot de passe root et utilisez leurs valeurs par défaut sécurisées.

Maintenant, vous pouvez vous connecter à MariaDB et configurer votre base de données pour que Laravel puisse l’utiliser.

sudo mysql -u root -p

Une fois que vous y êtes, commencez par créer votre base de données.

> CREATE DATABASE laravel;

Ensuite, créez un utilisateur pour utiliser cette base de données.

> CREATE USER `user`@`localhost` IDENTIFIED BY 'yourpassword';

Donnez à cet utilisateur l’autorisation d’utiliser cette base de données.

> GRANT ALL ON laravel.* TO `user`@`localhost`;

Enfin, videz les privilèges et quittez.

> FLUSH PRIVILEGES;

Connecter Laravel

Par défaut, Laravel est configuré pour utiliser MySQL(MariaDB), mais vous devez lui donner les bonnes informations pour se connecter à la base de données que vous venez de configurer.

Configurer la base de données Laravel sur Ubuntu 18.04

Allez-y et allez dans le répertoire où vous avez installé Laravel. Vous y verrez un dossier config. À l’intérieur de ce dossier se trouve un fichier de configuration de base de données. Ouvrez config/database.php. Faites défiler vers le bas pour trouver le bloc MySQL comme celui illustré ci-dessus. Modifiez le nom de la base de données, le nom d’utilisateur et le mot de passe pour qu’ils correspondent à ceux que vous avez configurés. Ensuite, enregistrez et quittez.

Configurer Nginx

La dernière pièce du puzzle est Nginx. C’est la partie qui servira réellement votre site. Passez à /etc/nginx. Dans ce dossier, vous trouverez toute la configuration de Nginx. Vous n’avez pas besoin de vous mêler de tout cela. Vous pouvez modifier les options dans nginx.conf si vous le souhaitez, mais il n’est pas nécessaire de faire fonctionner Laravel.

Il y a deux dossiers auxquels vous devez faire attention. Ce sont des sites disponibles et des sites activés. sites-available contient toutes les configurations de votre site. Pour commencer à diffuser un site, créez un lien logiciel vers la configuration du site dans site-enabled. Actuellement, il n’y a qu’une seule entrée. Supprimez-le des deux dossiers. Ensuite, créez une nouvelle entrée dans sites-available pour votre projet.

Ouvrez la nouvelle configuration de votre site dans votre éditeur de texte et configurez-la pour qu’elle ressemble à ce qui suit.

server {
    listen 80;
    listen [::]:80;
	server_name your-site.com

    root /var/www/yourProject;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

}

Lorsque tout reflète votre serveur, enregistrez et quittez. Maintenant, vous pouvez redémarrer Nginx pour que les modifications prennent effet.

sudo systemctl restart nginx

Vous pouvez accéder au nom du serveur que vous avez spécifié à Nginx pour afficher votre site.

Réflexions finales

Laravel est extrêmement puissant, et cette configuration peut vous amener soit à une excellente configuration de développement, soit aux débuts d’un serveur de production. Il y a certainement plus que vous pouvez faire avec Laravel et Nginx, alors n’hésitez pas à explorer différentes options de configuration sur une machine de développement.