Développement WordPress local avec un domaine .test (fichier hosts)

Pour faire tourner un WordPress local sur un domaine propre comme monsite.test, mappez-le vers 127.0.0.1 dans votre fichier hosts et pointez votre serveur local vers le dossier WordPress. Cela remplace les URLs moches comme localhost:8888 par un vrai domaine mémorisable, plus proche de la production, et c’est compatible LocalWP, MAMP, XAMPP et Docker.

Configurer un WordPress local avec un domaine .test

1. Ajoutez le domaine au fichier hosts :

127.0.0.1 monsite.test

2. Videz le DNS, sur Mac ou sur Windows.
3. Créez un virtual host dans votre stack pointant monsite.test vers le répertoire WordPress (vhost Apache MAMP/XAMPP, ou server block Docker/Nginx).
4. Indiquez son URL à WordPress dans wp-config.php :

define('WP_HOME', 'http://monsite.test');
define('WP_SITEURL', 'http://monsite.test');

5. Ouvrez http://monsite.test et terminez l’installation WordPress.

Pourquoi .test (et pas .dev ni localhost)

.test est réservé par l’IETF pour les tests : il n’entre jamais en conflit avec un vrai domaine et les navigateurs n’y forcent pas le HTTPS (contrairement à .dev). Choisissez le bon TLD avec quel TLD utiliser pour le développement local, et obtenez le bon format de ligne avec le guide de syntaxe du fichier hosts.

Notes par outil

• LocalWP : il gère ses propres domaines, mais une entrée hosts permet de s’aligner sur un nom .test personnalisé.
• MAMP / XAMPP : ajoutez un <VirtualHost> Apache avec ServerName monsite.test et le DocumentRoot WP.
• Docker : mappez le port et ajoutez l’entrée hosts ; pour de nombreux sous-domaines, utilisez les domaines locaux wildcard avec dnsmasq. Voir aussi gérer le fichier hosts avec Docker.

Du local à la préproduction

Quand vous pousserez ce build local vers un serveur de préproduction (staging) ou la production, exportez la base de données WordPress avec les fichiers. Un déplacement à domaine identique ne demande rien de plus ; ce n’est que si le domaine change que vous lancez un rechercher-remplacer sur les URLs stockées, avant de basculer le DNS et de suivre la propagation. Jusque-là, le fichier hosts garde votre domaine local .test totalement séparé du site en ligne.

HTTPS local (optionnel)

Si un plugin exige le HTTPS en local, générez un certificat de confiance avec mkcert, voir HTTPS local sur Mac avec mkcert, et passez les URLs en https://monsite.test.

Gérer plusieurs sites WordPress proprement

Plusieurs projets WordPress, ce sont plusieurs domaines .test, et le fichier hosts devient vite encombré. ToggleHosts garde le mapping de chaque projet avec une bascule en un clic et vide le DNS automatiquement : changer de site WordPress est instantané. Pour une vue stack plus large, voir le fichier hosts pour Laravel et WordPress en dev local.

_Dernier test : juin 2026 avec WordPress 6.x sous macOS, Windows et Linux._

Sources et ressources externes

• Documentation officielle de WordPress
• Le fichier hosts expliqué (Wikipédia)
• Page de manuel hosts(5) (man7.org)