Fichier hosts pour Laravel et WordPress

Développer des applications Laravel ou WordPress en local nécessite souvent de configurer des domaines personnalisés plutôt que d'utiliser simplement localhost. Le fichier hosts est l'outil parfait pour cela. Ce guide vous montre comment configurer efficacement votre fichier hosts pour le développement local avec Laravel et WordPress sur Mac.

Comment configurer le fichier hosts pour Laravel et WordPress en local

Pour le développement local Laravel ou WordPress, associez votre domaine personnalisé à `127.0.0.1` dans le fichier hosts (ex. `127.0.0.1 monapp.test`), puis pointez votre serveur web — Valet, Herd, MAMP, ou un vhost Nginx/Apache — vers le dossier du projet. Videz le cache DNS et ouvrez le domaine. Valet et Herd gèrent automatiquement la résolution `.test`, donc les entrées manuelles servent surtout aux setups MAMP/personnalisés.

Pourquoi utiliser des domaines locaux personnalisés ?

Avantages des domaines locaux

Au lieu d'utiliser localhost:8000 ou 127.0.0.1:8080, vous pouvez créer des domaines comme app.local, api.local, ou mon-site.local. Voici pourquoi c'est mieux :

Plus professionnel Les domaines personnalisés simulent mieux un environnement de production réel.

Facilite le test de sous-domaines Vous pouvez tester api.app.local, admin.app.local, etc., comme en production.

Évite les conflits de ports Pas besoin de se rappeler quel projet utilise quel port.

Meilleure organisation Chaque projet a son propre domaine facilement identifiable.

Compatible avec les cookies et sessions Les cookies fonctionnent mieux avec des domaines nommés qu'avec localhost.

Configuration de base du fichier hosts

Structure du fichier hosts

Le fichier hosts sur Mac se trouve à /etc/hosts et a cette structure :

127.0.0.1	localhost
255.255.255.255	broadcasthost
::1             localhost

# Vos configurations personnalisées
127.0.0.1	app.local
127.0.0.1	api.local

Format : IP domaine

Important : Utilisez une tabulation (Tab) entre l'IP et le domaine, pas des espaces.

Ajouter une entrée avec Locahl

Avec Locahl, c'est beaucoup plus simple :

1. Ouvrez Locahl 2. Cliquez sur "Ajouter une entrée" 3. Entrez l'IP (généralement 127.0.0.1) 4. Entrez le domaine (ex: app.local) 5. Sauvegardez

Locahl flush automatiquement le DNS, donc vos changements prennent effet immédiatement.

Ajouter une entrée avec le terminal

Si vous préférez le terminal :

# Éditer le fichier hosts
sudo nano /etc/hosts

# Ajouter votre entrée
127.0.0.1	app.local

# Sauvegarder et quitter (Ctrl+X, puis Y, puis Entrée)

# Flush le DNS
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

Configuration pour Laravel

Configuration de base

Pour un projet Laravel standard, ajoutez cette entrée dans votre fichier hosts :

127.0.0.1	laravel-app.local

Configuration avec plusieurs domaines

Si votre application Laravel utilise plusieurs domaines (API, admin, frontend) :

127.0.0.1	laravel-app.local
127.0.0.1	api.laravel-app.local
127.0.0.1	admin.laravel-app.local

Configuration du serveur Laravel

Après avoir configuré le fichier hosts, vous devez aussi configurer Laravel pour servir sur ce domaine.

Avec `php artisan serve` :

php artisan serve --host=laravel-app.local --port=8000

Avec Valet :

Valet configure automatiquement les domaines .test :

valet link laravel-app
# Accès via laravel-app.test

Avec Laragon/MAMP/XAMPP :

Configurez votre serveur web (Apache/Nginx) pour servir sur laravel-app.local.

Exemple complet Laravel

Fichier hosts :

127.0.0.1	laravel-app.local
127.0.0.1	api.laravel-app.local

Démarrer Laravel :

cd /path/to/laravel-app
php artisan serve --host=laravel-app.local --port=8000

Accès : http://laravel-app.local:8000

Configuration pour WordPress

Configuration de base

Pour un site WordPress local, ajoutez cette entrée :

127.0.0.1	wordpress-site.local

Configuration multi-sites

Si vous utilisez WordPress en mode multi-sites :

127.0.0.1	wordpress-site.local
127.0.0.1	site1.wordpress-site.local
127.0.0.1	site2.wordpress-site.local

Configuration de wp-config.php

Dans votre wp-config.php, définissez les URLs :

define('WP_HOME', 'http://wordpress-site.local');
define('WP_SITEURL', 'http://wordpress-site.local');

Configuration du serveur web

Avec MAMP : 1. Ouvrez MAMP 2. Allez dans Préférences > Web Server 3. Configurez le Virtual Host pour wordpress-site.local 4. Pointez vers le répertoire de votre installation WordPress

Avec Local by Flywheel : Local configure automatiquement les domaines .local.

Avec Docker : Configurez votre conteneur pour écouter sur le port 80 et utilisez wordpress-site.local dans le fichier hosts.

Exemple complet WordPress

Fichier hosts :

127.0.0.1	wordpress-site.local
127.0.0.1	admin.wordpress-site.local

Configuration MAMP :

• Créez un Virtual Host pour wordpress-site.local
• Pointez vers /Applications/MAMP/htdocs/wordpress-site

Accès : http://wordpress-site.local

Gestion de plusieurs projets

Avec Locahl : Environnements séparés

La meilleure méthode est d'utiliser Locahl pour créer des environnements séparés :

1. Créer un environnement "Laravel Projects" - Ajoutez toutes vos entrées Laravel - Ex: laravel-app1.local, laravel-app2.local

2. Créer un environnement "WordPress Projects" - Ajoutez toutes vos entrées WordPress - Ex: wp-site1.local, wp-site2.local

3. Basculez entre environnements - Activez l'environnement du projet sur lequel vous travaillez - Désactivez les autres pour éviter les conflits

Convention de nommage

Utilisez une convention de nommage cohérente :

Par projet :

• projet-laravel.local
• projet-wordpress.local

Par client :

• client1-app.local
• client2-site.local

Par environnement :

• app-dev.local
• app-staging.local

Configuration avancée

Sous-domaines multiples

Pour tester des sous-domaines complexes :

127.0.0.1	app.local
127.0.0.1	api.app.local
127.0.0.1	admin.app.local
127.0.0.1	cdn.app.local

Domaines avec ports personnalisés

Si vous devez utiliser des ports spécifiques, le fichier hosts ne gère pas les ports, mais vous pouvez toujours utiliser :

127.0.0.1	app.local

Puis accéder via http://app.local:8080 dans votre navigateur.

Domaines pointant vers différentes IPs

Si vous utilisez Docker ou des VMs avec des IPs différentes :

127.0.0.1		app.local
192.168.1.100	api.local
10.0.0.5		db.local

Bonnes pratiques

Organisation

Utilisez des noms descriptifs

• laravel-blog.local
• test.local

Groupez par projet Créez des environnements séparés dans Locahl pour chaque projet.

Documentez vos configurations Ajoutez des commentaires dans Locahl pour expliquer chaque entrée.

Sécurité

Ne partagez jamais votre fichier hosts complet Il peut contenir des informations sensibles sur vos projets locaux.

Utilisez des extensions .local L'extension .local est réservée pour les réseaux locaux et ne sera jamais résolue par les DNS publics.

Maintenance

Nettoyez régulièrement Supprimez les entrées pour les projets que vous n'utilisez plus.

Faites des sauvegardes Avec Locahl, c'est automatique, mais si vous utilisez le terminal, faites des sauvegardes régulières.

Résolution de problèmes

Le domaine ne fonctionne pas

Vérifiez le fichier hosts :

cat /etc/hosts | grep votre-domaine

Flush le DNS :

sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

Avec Locahl, c'est fait automatiquement.

Vérifiez votre serveur web Assurez-vous que votre serveur (Apache/Nginx/Laravel/WordPress) écoute bien sur le domaine configuré.

Conflits entre projets

Si deux projets utilisent le même domaine :

Solution 1 : Utilisez des noms différents

• projet1-app.local
• projet2-app.local

Solution 2 : Utilisez des environnements séparés dans Locahl

• Activez seulement l'environnement du projet sur lequel vous travaillez

Le navigateur met en cache

Si votre navigateur met en cache l'ancienne résolution :

1. Videz le cache DNS du navigateur 2. Utilisez la navigation privée pour tester 3. Redémarrez le navigateur

Intégration avec d'autres outils

Docker

Avec Docker, vous pouvez pointer vos domaines vers les conteneurs :

127.0.0.1	app.local
127.0.0.1	db.local

Puis configurez Docker pour exposer les ports appropriés.

Valet

Valet utilise automatiquement l'extension .test :

valet link mon-projet
# Accès via mon-projet.test

Vous pouvez toujours utiliser le fichier hosts pour des domaines personnalisés avec Valet.

MAMP/XAMPP

Ces outils nécessitent la configuration de Virtual Hosts en plus du fichier hosts. Le fichier hosts redirige le domaine vers localhost, et le Virtual Host sert le bon répertoire.

Du local à la mise en ligne

Une fois le site prêt en local, le passage en préproduction (staging) puis en production consiste à exporter la base de données et les fichiers. Si le domaine change (de .local vers le domaine réel), lancez un rechercher-remplacer sur les URLs stockées, puis basculez le DNS et laissez la propagation se faire. Tant que vous restez en local, le fichier hosts isole vos domaines de test du site en ligne.

Guides complémentaires

Pour poser l'ensemble du stack local, lisez le guide environnement de développement Mac. Si vous utilisez Docker autour de Laravel ou WordPress, consultez le guide fichier hosts et Docker. Pour sécuriser vos domaines locaux, suivez le guide HTTPS local avec mkcert.

Conclusion

Configurer le fichier hosts pour le développement local avec Laravel et WordPress est essentiel pour un workflow professionnel. Les domaines personnalisés facilitent le développement et simulent mieux les environnements de production.

Pour Laravel :

• Configurez app.local dans le fichier hosts
• Utilisez php artisan serve --host=app.local
• Ou configurez votre serveur web

Pour WordPress :

• Configurez site.local dans le fichier hosts
• Configurez votre serveur web (MAMP/XAMPP) pour servir sur ce domaine
• Mettez à jour wp-config.php

Pour gérer plusieurs projets :

• Utilisez Locahl pour créer des environnements séparés
• Organisez vos entrées par projet
• Basculez facilement entre environnements

Locahl à 4,99 € simplifie énormément la gestion de vos configurations hosts pour Laravel et WordPress. Essayez-le dès aujourd'hui et découvrez comment le développement local peut être plus professionnel et organisé.

Sources et ressources externes

• Documentation officielle de WordPress
• Guide d’utilisation du Terminal (Assistance Apple)
• Le fichier hosts expliqué (Wikipédia)