Comment configurer des domaines locaux sur Windows avec WampServer

Qu’est-ce qu’un domaine local, et pourquoi en utiliser un ?

Un domaine local est un nom d’hôte qui ne se résout que sur votre propre machine, comme myapp.test. Rien n’en est publié sur internet ; votre ordinateur accepte simplement de traiter ce nom comme une adresse vers lui-même.

Les domaines locaux valent leur petite configuration, car ils vous permettent de :

• Exécuter chaque projet à sa propre racine (myapp.test) au lieu d’un sous-dossier de localhost, pour que les chemins et les cookies se comportent comme en production.
• Faire tourner plusieurs projets côte à côte sans conflits de chemins.
• Correspondre au domaine attendu par votre framework (Laravel, Symfony, le multisite WordPress et d’autres tiennent compte de l’hôte).
• Ajouter un HTTPS de confiance par domaine, ce qu’un simple localhost rend malaisé.

Le fichier hosts de Windows, expliqué

Avant que votre ordinateur ne demande à un serveur DNS où se trouve un domaine, il consulte d’abord un fichier texte local. Sous Windows, ce fichier est :

C:\Windows\System32\drivers\etc\hosts

Tout nom que vous y mappez l’emporte sur l’internet public. C’est exactement ce que nous voulons pour le développement local : nous pointons le domaine choisi vers 127.0.0.1, l’adresse qui signifie toujours « cette machine ».

Étape 1 — mapper le domaine dans le fichier hosts

Ouvrez le Bloc-notes en tant qu’administrateur (le fichier est protégé), ouvrez le fichier hosts ci-dessus, et ajoutez une ligne :

127.0.0.1 myapp.test

Enregistrez. Pour confirmer que le nom se résout désormais vers votre machine, ouvrez un terminal et exécutez :

ping myapp.test

Vous devriez voir des réponses de 127.0.0.1. À ce stade, le nom se résout, mais Apache ne sait pas encore quoi servir pour lui — c’est l’étape suivante.

Étape 2 — pointer Apache vers lui avec un hôte virtuel

Un hôte virtuel indique à Apache quel dossier servir pour un nom d’hôte donné. Ouvrez httpd-vhosts.conf dans votre installation WAMP et ajoutez :

<VirtualHost *:80>
  ServerName myapp.test
  DocumentRoot "C:/wamp64/www/myapp/public"
  <Directory "C:/wamp64/www/myapp/public">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require local
  </Directory>
</VirtualHost>

Redémarrez le service Apache (wampapache) depuis l’icône de la zone de notification WampServer, puis ouvrez http://myapp.test. Votre projet devrait se charger à sa propre adresse propre.

Conseil : conservez Require local pour que le vhost ne soit accessible que depuis votre propre machine.

Pourquoi utiliser .test, et non .dev ou .local ?

Choisissez votre suffixe avec soin :

• .test — réservé par l’IETF pour les tests. Il ne sera jamais un vrai domaine public ; c’est donc le choix le plus sûr.
• .dev — un véritable domaine de premier niveau public détenu par Google, préchargé en HTTPS uniquement (HSTS). L’utiliser en local provoque des redirections déroutantes. À éviter.
• .local — réservé au DNS multicast (mDNS/Bonjour) et peut entrer en conflit avec la découverte réseau. À éviter.

Tenez-vous-en à .test pour un développement local prévisible.

Étape 3 — ajouter un HTTPS de confiance

Une fois que votre domaine se résout et qu’Apache le sert, la dernière étape est un certificat de confiance pour que le navigateur affiche un cadenas vert au lieu d’un avertissement. Cela nécessite une autorité de certification locale et un certificat au bon profil — détaillé dans notre guide du HTTPS de confiance sur WampServer.

Vous pouvez le faire à la main avec OpenSSL, ou laisser WAMP SSL Automator créer l’AC, émettre le certificat, ajouter le vhost :443 et l’entrée hosts, redémarrer Apache et vérifier le résultat — pour chaque domaine de votre liste, en un clic.

Problèmes courants et solutions

• Le domaine ne se résout pas. Le fichier hosts n’a pas été enregistré en tant qu’administrateur, ou un antivirus l’a verrouillé. Rouvrez le Bloc-notes en mode élevé et réenregistrez ; videz le cache DNS avec ipconfig /flushdns.
• Vous voyez la page WAMP par défaut, pas votre projet. Le chemin DocumentRoot est incorrect, ou Apache n’a pas été redémarré après modification du vhost.
• Apache ne démarre pas après modification des vhosts. Une erreur de syntaxe dans httpd-vhosts.conf. Exécutez httpd -t pour voir la ligne fautive, corrigez-la, et redémarrez.
• 403 Forbidden. Le bloc <Directory> est manquant ou son chemin ne correspond pas au DocumentRoot.