Tutoriel : Laravel Valet - Tutoriel d'installation

Laravel Valet est un utilitaire très pratique qui permet de mettre en place un serveur de développement PHP/SQL en local sur votre machine. Il est très facile à utiliser et à prendre en main.

Attention ! Cet utilitaire n'est pas disponible sur Windows !

Alors… autant l'utilisation s'avère être facile, autant l'installation est un petit peu plus complexe. Je vais tout détailler rien que pour vous ?.

Suivez les étapes dans l'ordre et ne passez pas à la suivante tant que la précédente n'est pas terminée !

1. Homebrew

Avant de commencer quoi que ce soit, vous allez avoir besoin de Homebrew pour installer les différents modules qui suivront. Si vous l'avez déjà installé, passez directement à la suite.

Homebrew est un gestionnaire de paquets qui facilite l'installation de programme en ligne de commande, ce qui est très commode aussi !

Copiez/collez la ligne suivante dans votre terminal :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

La commande ci-dessus fonctionne aussi si vous êtes sous un Apple Silicon. La version 3 étant universelle. Le script d'installation choisira la bonne version pour votre système.

Mise à jour de Homebrew

Ensuite, lancez la commande suivante pour vérifier si d'éventuelles mises à jour sont nécessaires :

brew update

2. Composer

Composer est un gestionnaire de dépendance pour PHP, lui aussi très pratique lorsque l'on développe et il sera nécessaire dans l'installation de Laravel Valet. Pour cela, nous allons utiliser Homebrew :

brew install composer

3. PHP

N'oublions pas qu'il s'agit d'un serveur de développement PHP que nous installons. Nous allons installer la dernière version de PHP avec Homebrew.

brew install php
brew services start php

Si vous avez besoin d'une autre version, ajoutez une arobase suivie de la version voulue comme dans l'exemple ci-dessous :

brew install php@8.1

Vous pouvez aussi préciser la version de PHP que vous souhaitez utiliser avec Valet :

valet use php@8.1
# valet use php@7.4

4. MySQL

L'installation de MySQL est tout aussi facile que celle de PHP :

brew install mysql
brew services start mysql

Si vous avez besoin d'une autre version, choisissez les chiffres après l'arobase.

# Exemple
# brew install mysql@5.7
# brew services start mysql@5.7

5. Laravel Valet ?

Nous voilà maintenant au point le plus intéressant de cet article : Laravel Valet. Il était très important d'installer PHP et MySQL avant afin d'éviter d'éventuels conflits par la suite.

L'installation de Valet requiert Composer et non Homebrew cette fois-ci. Copiez/collez les lignes suivantes pour procéder à l'installation :

composer global require laravel/valet
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
valet install
valet use php
mkdir ~/Sites
cd ~/Sites
valet park
composer global update

Attention ! Si vous copier-coller l'ensemble des commandes ci-dessus, veillez à bien vérifier qu'elles soient toutes exécutées.

6. PHPMyAdmin

Désormais que votre serveur est installé et fonctionnel, installons PHPMyAdmin pour gérer les bases de données de vos projets ?

cd ~/Sites
brew install phpmyadmin
ln -s $(brew --prefix)/share/phpmyadmin ~/Sites/phpmyadmin

Il nous reste un peu de configuration à effectuer et le tour sera joué ! Rendez-vous dans le dossier "Sites" nouvellement créé dans votre dossier personnel. À l'intérieur se trouve un dossier nommé "phpmyadmin".

Dans ce dossier, un fichier "config.inc.php" doit être modifié pour terminer :

Ouvrez ce fichier et modifiez la ligne 18 puis rendez-vous sur le site suivant et reprenez la phrase secrète générée aléatoirement : https://phpsolved.com/phpmyadmin-blowfish-secret-generator/

$cfg['blowfish_secret'] = 'IJoKqozoQ:4F6{7nPz9Q;JE;cShUAgcP';

Vous trouverez un générateur à cette endroit

Modifiez la ligne 34, en changeant la valeur false à true :

$cfg['Servers'][$i]['AllowNoPassword'] = true;

Enfin, l'interface est en anglais, mais vous pouvez de modifier la langue par défaut par une autre. La modification s'opère en ligne 118 ; décommettez la ligne et modifiez la valeur par les deux lettres représentant votre langue :

$cfg['DefaultLang'] = 'fr';

Voilà ! Ouvrez votre navigateur et entrez l'URL suivante : http://phpmyadmin.test
Le nom d'utilisateur est "root" et le mot de passe est inutile.

7. Terminé !

Votre serveur de développement est prêt. Pas de besoin de penser à le démarrer ? Mettez tous vos projets dans le dossier "Sites" et pour y accéder, tapez dans votre navigateur le nom du dossier suivi du nom de domaine ".test" : http://mon_dossier.test

La documentation officielle se trouve ici : https://laravel.com/docs/10.x/valet

8. Ça ne fonctionne pas ?

Vous avez tout bien installé, mais quand tu veux accéder à ton projet via le navigateur, il ne se passe rien ?
Relancez la commande suivante :

valet install

Ceci corrigera les éventuelles erreurs, réinstallera si nécessaire "Dnsmasq" et tout rentrera dans l'ordre.