Laravel Valet Installation : la Méthode pour Mac et Windows

Vous en avez assez des environnements de développement locaux lourds et compliqués ? Docker vous semble trop complexe pour un petit projet ? Vous cherchez une solution rapide, légère et qui ne consomme pas toutes les ressources de votre machine ?

Ce guide vous montre comment mettre en place un environnement de développement PHP ultra-performant. Vous allez découvrir pas à pas la méthode complète pour installer et configurer Laravel Valet sur macOS et Windows, même si vous partez de zéro.

Qu’est-ce que Laravel Valet et pourquoi l’utiliser ?

Laravel Valet est un environnement de développement PHP minimaliste pour macOS. Il existe aussi une méthode officielle pour le faire fonctionner sur Windows et Linux via WSL2. Contrairement à Homestead ou Docker, Valet ne virtualise pas un système d’exploitation complet. Il configure directement votre machine pour servir des sites PHP en utilisant Nginx en arrière-plan.

Le principal avantage de Valet, c’est sa légèreté. Une fois lancé, il ne consomme qu’environ 7 Mo de RAM. C’est parfait si votre ordinateur n’est pas une machine de guerre. Il s’intègre directement à votre système sans créer de machine virtuelle lourde.

Voici les raisons principales pour lesquelles les développeurs l’adoptent :

• Vitesse et performance : Vos sites se chargent presque instantanément. Il n’y a pas de couche de virtualisation pour ralentir les choses.
• Configuration simple : Valet gère Nginx et DnsMasq pour vous. Vous n’avez plus besoin de modifier manuellement votre fichier /etc/hosts.
• URL locales propres : Tous vos projets sont accessibles via une URL simple comme mon-projet.test. C’est plus propre que localhost:8000.
• Partage facile : Avec la commande valet share, vous pouvez partager votre site local avec n’importe qui sur internet en quelques secondes. C’est idéal pour montrer l’avancement d’un projet à un client.

Si vous cherchez une alternative simple à des outils comme Laravel Sail ou Homestead, et que la performance native est votre priorité, Valet est une très bonne option. Il est pensé pour la simplicité et l’efficacité.

Prérequis : Ce qu’il vous faut avant d’installer Valet

Avant de lancer l’installation de Valet, vous devez vous assurer que quelques outils sont déjà présents sur votre machine. La procédure change un peu si vous êtes sur macOS ou Windows.

Pour les utilisateurs de macOS

Sur Mac, le principal prérequis est Homebrew. C’est un gestionnaire de paquets qui simplifie l’installation de logiciels en ligne de commande. Si vous ne l’avez pas, ouvrez votre terminal et collez cette commande :

Une fois Homebrew installé, vous l’utiliserez pour installer le reste. C’est l’outil de base pour tout développeur sur macOS.

• PHP : Valet a besoin de PHP pour fonctionner. Installez la dernière version avec Homebrew.
  brew install php
• Composer : C’est le gestionnaire de dépendances pour PHP. C’est lui qui va réellement installer Valet.
  brew install composer

Pour les utilisateurs de Windows

Sur Windows, la méthode officielle pour utiliser Valet est de passer par WSL2 (Windows Subsystem for Linux). WSL2 vous permet de faire tourner un vrai environnement Linux à l’intérieur de Windows 10 ou 11. C’est très performant et bien intégré.

Pour activer WSL2, ouvrez PowerShell en tant qu’administrateur et tapez :

Cette commande va installer tout le nécessaire, y compris la distribution Ubuntu par défaut. Une fois que c’est fait, vous lancerez le terminal Ubuntu et toutes les commandes suivantes se feront à l’intérieur de cet environnement Linux.

Vérifier votre PATH

C’est une étape cruciale. Valet et ses dépendances s’installent via Composer dans un dossier spécifique. Vous devez vous assurer que votre système sait où trouver ces exécutables. Le dossier à vérifier est ~/.composer/vendor/bin.

Vous devez vous assurer que ce chemin est bien présent dans vos variables d’environnement (le PATH). Sans cela, quand vous taperez `valet` dans le terminal, il vous répondra « command not found ». C’est l’erreur la plus courante.

Installation de Laravel Valet sur macOS : Le Guide Étape par Étape

Une fois les prérequis en place, l’installation de Valet sur un Mac est très rapide. Tout se passe dans votre terminal. Suivez simplement ces trois étapes.

1. Installer Valet avec Composer
   La première étape consiste à utiliser Composer pour télécharger et installer Valet de manière globale sur votre machine. Le mot « global » signifie que la commande valet sera disponible partout, quel que soit le dossier dans lequel vous vous trouvez. C’est la commande composer global require laravel/valet qu’il faut utiliser.

   composer global require laravel/valet

2. Lancer l’installation de Valet
   Maintenant que les fichiers de Valet sont téléchargés, il faut lancer la configuration. Cette commande va installer et configurer Nginx et DnsMasq pour qu’ils fonctionnent avec Valet. C’est l’étape la plus importante. Pour ça, il faut run valet install.

   valet install

   Valet s’occupe de tout en arrière-plan. Il va enregistrer ses démons pour qu’ils se lancent automatiquement au démarrage de votre Mac.

3. Vérifier que tout fonctionne
   Pour être sûr que l’installation s’est bien passée, vous pouvez faire un test simple. Essayez de pinger n’importe quel domaine se terminant par .test. Si DnsMasq est bien configuré, il devrait répondre.

   ping foobar.test

   Si vous obtenez une réponse du type 64 bytes from 127.0.0.1, cela signifie que l’installation de Valet est réussie. Votre machine est prête à servir des sites locaux.

Installation de Laravel Valet sur Windows (avec WSL2)

Oui, Valet fonctionne parfaitement sur Windows grâce à WSL2. Le processus est très similaire à celui sur macOS, mais il se déroule entièrement à l’intérieur de votre terminal Linux (Ubuntu, le plus souvent).

Ouvrez votre terminal Ubuntu depuis le menu Démarrer de Windows. Toutes les commandes suivantes doivent être tapées ici. N’utilisez pas PowerShell ou CMD pour ces étapes.

D’abord, mettez à jour votre distribution et installez les dépendances nécessaires :

Ensuite, installez Composer. Les étapes sont un peu différentes de celles avec Homebrew :

Maintenant que les prérequis sont là, les commandes pour Valet sont exactement les mêmes que sur Mac. Vous utilisez composer global require laravel/valet pour l’installer :

Puis vous finalisez l’installation avec valet install :

Vos premiers pas : Servir votre premier site avec Valet

Maintenant que Valet est installé, il est temps de l’utiliser pour servir un projet. Il y a deux manières principales de dire à Valet où se trouvent vos sites : la commande park et la commande link.

La commande `park` : pour votre dossier de projets principal

La commande valet park est idéale si vous rangez tous vos projets dans un seul dossier, par exemple ~/Sites ou ~/Dev. Placez-vous dans ce dossier et tapez la commande :

À partir de maintenant, chaque nouveau dossier que vous créerez dans ~/Sites deviendra automatiquement un site web. Si vous créez un dossier mon-super-projet, il sera immédiatement accessible dans votre navigateur à l’adresse http://mon-super-projet.test. C’est aussi simple que ça.

La commande `link` : pour un projet n’importe où

Parfois, un projet n’est pas dans votre dossier principal. La commande valet link permet de servir un projet depuis n’importe quel emplacement sur votre disque dur. Placez-vous dans le dossier du projet et exécutez la commande :

Ce projet sera alors accessible à l’adresse http://mon-projet-custom.test. Vous pouvez choisir le nom de domaine que vous voulez. Si vous ne spécifiez pas de nom, Valet utilisera le nom du dossier.

Sécuriser un site avec HTTPS

Avoir le HTTPS sur ses projets locaux est une bonne pratique. Valet rend cela très facile. Pour ajouter un certificat TLS à un de vos sites, utilisez la commande valet secure. Par exemple, pour votre projet « mon-super-projet » :

Le site sera maintenant accessible sur https://mon-super-projet.test avec le petit cadenas vert dans votre navigateur. C’est très pratique pour tester des fonctionnalités qui nécessitent une connexion sécurisée.

Commandes Valet utiles au quotidien : Le mémo du développeur

Une fois que vous utilisez Valet tous les jours, certaines commandes deviennent des réflexes. Voici un tableau récapitulatif des commandes les plus utiles à garder sous la main.

La commande valet use php version est particulièrement utile. Si vous travaillez sur plusieurs projets qui n’utilisent pas la même version de PHP, vous pouvez basculer de l’une à l’autre en une seule commande, sans avoir à reconfigurer tout votre environnement.

Valet vs Alternatives (Herd, Sail, Homestead) : Que choisir ?

Valet n’est pas le seul outil pour développer en PHP localement. Le choix dépend de vos besoins et de vos préférences.

• Laravel Valet : Choisissez-le pour la vitesse, la simplicité et une approche native. C’est l’outil le plus léger et le plus rapide si vous êtes sur macOS ou si vous êtes à l’aise avec WSL2 sur Windows.
• Laravel Herd : C’est la nouvelle coqueluche de l’écosystème Laravel pour macOS. En gros, c’est Valet avec une belle interface graphique par-dessus. Il inclut PHP, Nginx, DnsMasq et Node dans une seule application. Si vous aimez les outils visuels, c’est un excellent choix.
• Laravel Sail : Sail est basé sur Docker. Il crée un environnement de développement conteneurisé qui est identique à votre environnement de production. C’est plus lourd que Valet, mais ça garantit que votre code se comportera de la même manière en local et sur le serveur.
• Homestead : C’est la solution « historique » de Laravel, basée sur Vagrant. Elle provisionne une machine virtuelle complète (Ubuntu). C’est la plus lourde des solutions, mais aussi la plus complète et la plus isolée. Elle est de moins en moins utilisée au profit de Sail.

FAQ – Dépannage de l’installation de Laravel Valet

Même si l’installation est simple, on peut parfois rencontrer des petits soucis. Voici les problèmes les plus courants et comment les résoudre.

Que faire si la commande `valet` n’est pas reconnue ?

C’est l’erreur la plus fréquente. Elle signifie que le dossier ~/.composer/vendor/bin n’est pas dans votre PATH. C’est là que Composer installe les exécutables. Vous devez ajouter ce chemin à votre fichier de configuration de shell (.zshrc, .bash_profile, etc.).

Ouvrez ce fichier et ajoutez la ligne : export PATH="$PATH:$HOME/.composer/vendor/bin". Fermez et rouvrez votre terminal pour que le changement soit pris en compte.

Comment résoudre les conflits avec le port 80 ?

Valet utilise le port 80 pour servir les sites en HTTP. Si un autre service (comme le serveur Apache natif de macOS) utilise déjà ce port, Valet ne pourra pas démarrer. Vous devez arrêter le service qui occupe ce port. Sur Mac, la commande sudo apachectl stop suffit souvent.

Mon site `.test` affiche « It works! » (la page Nginx par défaut), que faire ?

Cela arrive quand Nginx fonctionne, mais qu’il n’a pas trouvé de fichier index.php ou index.html à la racine de votre projet. Vérifiez que votre projet Laravel (ou autre) est bien structuré et qu’il y a un point d’entrée valide dans son dossier public.

Comment désinstaller complètement Valet ?

Si vous voulez faire le ménage, la désinstallation est simple. D’abord, dans n’importe quel dossier, lancez la commande valet uninstall. Cela va arrêter les démons et retirer la configuration de Nginx et DnsMasq. Ensuite, retirez le paquet avec Composer : composer global remove laravel/valet.

Peut-on changer le TLD de `.test` à `.local` ?

Oui. Si vous préférez utiliser un autre TLD (Top-Level Domain) que .test, vous pouvez le changer avec la commande valet tld. Par exemple, pour passer à .local :

Vos sites seront alors accessibles via mon-projet.local. C’est une question de préférence personnelle.

Vous avez maintenant un environnement de développement PHP ultra-rapide et efficace sur votre machine. Fini les configurations complexes et les temps de chargement lents en local. Valet s’occupe de la partie technique pour que vous puissiez vous concentrer sur le code.

Que vous soyez sur macOS ou sur Windows avec WSL2, le processus est simple et le gain de productivité est immédiat. Votre workflow de développement vient de prendre un sérieux coup de boost.