Installation du framework PHP Laravel sur Ubuntu 18.04 LTS pour Apache

Laravel est un framework PHP open-source très populaire visant à faciliter le développement d’applications. Si vous recherchez un nouveau framework PHP à essayer, vous devriez tester Laravel.

Le guide suivant vous montrera comment installer et exécuter Laravel sur un serveur Apache basé sur Ubuntu 18.04 LTS. Ce tutoriel fonctionne également pour Ubuntu 17.x. Mais pour les serveurs, vous devriez préférer utiliser une version LTS d’Ubuntu comme l’actuelle Ubuntu 18.04 LTS.

Prérequis

Avant de procéder à l’installation, il est toujours bon de s’assurer que vos sources et logiciels existants sont à jour.

sudo apt-get update   
sudo apt-get upgrade

Pour ce guide, nous supposerons que vous avez un serveur de base basé sur Ubuntu en cours d’exécution. Avant Laravel, nous devons installer d’autres composants essentiels.

Installation d’Apache et de PHP 7.2

La prochaine étape consiste à installer PHP ainsi que plusieurs paquets supplémentaires qui s’avéreront utiles si vous allez travailler avec Laravel.

sudo add-apt-repository ppa:ondrej/php  
sudo apt-get update  
sudo apt-get install apache2 libapache2-mod-php7.2 php7.2 php7.2-xml php7.2-gd php7.2-opcache php7.2-mbstring

Bien que le dépôt d’Ubuntu contienne PHP, il est préférable d’ajouter un dépôt tiers ici car il est mis à jour plus fréquemment. Vous pouvez sauter cette étape et vous en tenir à la version d’Ubuntu si c’est ce que vous préférez.

Installation de Laravel

Avant de plonger enfin dans le sujet, nous devons également installer le contrôle de version Git. Si vous l’avez déjà installé, vous pouvez sauter l’étape suivante. Si vous ne l’avez pas, vous pouvez suivre notre guide pour le configurer d’abord.

Pour installer Laravel, nous devons d’abord installer Composer. C’est un outil de gestion des dépendances en PHP qui vous permet de regrouper toutes les bibliothèques requises associées à un paquet en un seul. Pour installer Laravel et toutes ses dépendances, Composer est requis. Il téléchargera et installera tout ce qui est nécessaire pour exécuter le framework Laravel. Pour installer Composer, exécutez les commandes suivantes.

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

La commande curl télécharge le paquet composer.phar dans votre répertoire /tmp. Mais nous voulons que Composer fonctionne globalement, donc nous devons le déplacer dans le répertoire /usr/local/bin/ sous le nom ‘composer‘. Maintenant, nous pouvons exécuter Composer de n’importe où.

Pour installer Laravel, déplacez-vous dans le répertoire html public de votre système. Puisque nous sommes sur Ubuntu et utilisons Apache, nous l’installerons dans le répertoire /var/www/html.

cd /var/www/html  
sudo composer create-project laravel/laravel your-project --prefer-dist

La commande ci-dessus créera un répertoire “your-project“ avec l’installation de Laravel à l’intérieur. Composer utilise git pour télécharger et installer tous les paquets et modules dont Laravel a besoin pour fonctionner.

Configuration d’Apache

Maintenant que nous avons installé Laravel, nous passons à l’étape de configuration du serveur web Apache.

La prochaine étape consiste à donner les permissions appropriées au répertoire du projet. Pour cela, nous devons permettre l’accès à partir du groupe www-data et lui donner des permissions d’écriture pour le répertoire de stockage.

sudo chgrp -R www-data /var/www/html/your-project  
sudo chmod -R 775 /var/www/html/your-project/storage

Maintenant, allez dans le répertoire /etc/apache2/sites-available et utilisez la commande suivante pour créer un fichier de configuration pour notre installation de Laravel.

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

Ajoutez maintenant le contenu suivant au fichier et fermez-le après l’avoir enregistré. Remplacez yourdomain.tld par le nom de domaine de votre site web à l’intérieur du fichier.

  
    ServerName yourdomain.tld  
    ServerAdmin webmaster@localhost  
    DocumentRoot /var/www/html/your-project/public  
      
        AllowOverride All  
      
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  

Nous devons maintenant activer ce fichier .conf nouvellement créé et désactiver le fichier .conf par défaut qui est installé avec l’installation par défaut d’Apache. De plus, nous devons activer mod_rewrite afin que les permaliens fonctionnent correctement.

sudo a2dissite 000-default.conf  
sudo a2ensite laravel.conf  
sudo a2enmod rewrite  
sudo service apache2 restart

Votre installation de Laravel est maintenant terminée. Visitez l’adresse IP ou le nom de domaine de votre serveur avec un navigateur web (dans mon cas http://192.168.1.100). Vous verrez la page par défaut de Laravel.

Framework Laravel installé avec succès sur Ubuntu 18.04 LTS.

Téléchargement de la machine virtuelle de ce tutoriel

Ce tutoriel est disponible sous forme d’image de machine virtuelle prête à l’emploi au format ovf/ova compatible avec VMWare et Virtualbox. L’image de la machine virtuelle utilise les détails de connexion suivants :

Connexion SSH / Shell

Nom d’utilisateur : administrator
Mot de passe : howtoforge

Pour devenir utilisateur root, exécutez : sudo -s
Mot de passe : howtoforge

L’IP de la VM est 192.168.1.100, elle peut être changée dans le fichier /etc/netplan/01-netcfg.yaml. Veuillez changer tous les mots de passe ci-dessus pour sécuriser la machine virtuelle.