Installer WordPress en local permet de développer, tester et déboguer votre site sans toucher à la version en ligne. En 2026, quatre outils dominent : XAMPP (Windows, Linux, Mac), WampServer (Windows), MAMP (Mac) et Docker Compose (tous systèmes). La méthode la plus rapide pour un débutant reste Local WP : téléchargez le logiciel, cliquez sur « Create site » et votre WordPress local tourne en moins de deux minutes, sans configuration Apache ni MySQL.

Pour un environnement de développement professionnel, la question n’est pas de savoir si vous devez travailler en local, mais quel outil choisir selon votre système, vos habitudes et la complexité de vos projets. Ce guide couvre les cinq méthodes principales avec les étapes complètes pour chacune, les erreurs les plus fréquentes et les bonnes pratiques pour migrer ensuite vers votre serveur de production.

Pourquoi installer WordPress en local plutôt que sur un serveur de test

Un environnement local présente trois avantages concrets par rapport à un hébergement de développement distant.

Rapidité de chargement. Les requêtes restent sur votre machine : les pages s’affichent en quelques millisecondes au lieu de 500 ms à 2 secondes selon votre connexion internet. Le rechargement après une modification de code est quasi instantané, ce qui rend les itérations de développement nettement plus fluides.

Travail hors ligne. Vous pouvez développer dans le train, en avion ou dans une zone sans couverture. Aucune dépendance à la connexion internet pour les tâches courantes : édition de code, activation de plugins, débogage PHP.

Sécurité complète. Vous pouvez tester des plugins douteux, des thèmes non certifiés ou des configurations risquées sans le moindre impact sur votre site de production. Si quelque chose casse, vous réinstallez en deux clics.

Un environnement local inclut trois composants : un serveur web (Apache ou Nginx), PHP dans la version de votre choix et MySQL (ou MariaDB) pour la base de données. Les outils comme XAMPP ou Local WP installent ces trois composants en un seul package.

Méthode 1 : installer WordPress en local avec XAMPP (Windows et Linux)

XAMPP est la solution la plus répandue pour installer WordPress en local sur Windows. Il intègre Apache, MySQL (MariaDB), PHP et phpMyAdmin dans une interface de contrôle simple. La version actuelle supporte PHP 8.1 à 8.3.

Étape 1 : télécharger et installer XAMPP. Rendez-vous sur apachefriends.org, téléchargez le programme d’installation pour votre système et lancez-le. Gardez les composants par défaut (Apache, MySQL, PHP, phpMyAdmin). Sur Windows, évitez d’installer dans C:Program Files à cause des permissions : préférez C:xampp.

Étape 2 : démarrer Apache et MySQL. Ouvrez le panneau de contrôle XAMPP et cliquez sur « Start » pour Apache puis pour MySQL. Les deux lignes doivent passer au vert.

Étape 3 : créer la base de données. Ouvrez votre navigateur sur http://localhost/phpmyadmin, cliquez sur « Nouvelle base de données », donnez-lui un nom (par exemple wordpress_local) et cliquez sur « Créer ».

Étape 4 : placer les fichiers WordPress. Téléchargez WordPress depuis wordpress.org, décompressez l’archive et copiez le dossier dans C:xampphtdocs. Renommez ce dossier selon votre projet (par exemple mon-site).

Étape 5 : lancer l’installation. Ouvrez http://localhost/mon-site/ dans votre navigateur. L’assistant WordPress s’ouvre. Entrez le nom de la base de données, l’utilisateur root, le mot de passe vide (par défaut XAMPP) et le serveur localhost.

# Tester la connexion MySQL depuis le terminal XAMPP
mysql -u root -p
# Mot de passe vide par défaut - appuyez sur Entree
# Verifier que la base de donnees existe
SHOW DATABASES;
USE wordpress_local;
SHOW TABLES;

Sur Linux, XAMPP s’installe dans /opt/lampp/. Les fichiers WordPress vont dans /opt/lampp/htdocs/. Lancez le serveur avec sudo /opt/lampp/lampp start.

Méthode 2 : WampServer pour Windows

WampServer est une alternative à XAMPP spécialement conçue pour Windows. Il se distingue par son icône système qui permet de passer d’une version de PHP à une autre en deux clics, sans redémarrer : idéal pour tester la compatibilité de vos thèmes et plugins avec différentes versions de PHP avant une mise à jour PHP WordPress.

Téléchargez WampServer depuis wampserver.com. L’installation installe automatiquement les Visual C++ Redistributables nécessaires. Une fois installé, l’icône dans la barre des tâches passe au vert quand Apache et MySQL sont actifs.

Les fichiers de votre site WordPress vont dans C:wamp64wwwmon-site. L’interface phpMyAdmin est accessible sur http://localhost/phpmyadmin. La création de la base de données et l’installation de WordPress suivent le même processus que XAMPP.

REM Changer la version de PHP dans WampServer (Windows)
REM Clic gauche sur l'icone WampServer dans la barre des taches
REM PHP > Version > choisir 8.2.x ou 8.3.x
REM WampServer redémarre automatiquement Apache avec la nouvelle version

REM Verifier la version active depuis la barre d'adresse :
REM http://localhost/ > section "PHP Version"

Pour un projet WordPress standard, choisissez PHP 8.2 : c’est la version recommandée en 2026 (support jusqu’en décembre 2027, performances optimales). PHP 7.4 n’est plus maintenu depuis novembre 2022.

Méthode 3 : MAMP pour Mac (et Windows)

MAMP (Mac, Apache, MySQL, PHP) est la référence pour installer WordPress en local sur macOS. La version gratuite suffit pour la quasi-totalité des projets WordPress. MAMP PRO ajoute la gestion de plusieurs hôtes virtuels avec des noms de domaine personnalisés (par exemple monsite.local).

Téléchargez MAMP depuis le site officiel. Après l’installation, ouvrez MAMP, cliquez sur « Start Servers » et accédez à phpMyAdmin via le bouton « Open WebStart page ». Créez votre base de données, placez vos fichiers WordPress dans /Applications/MAMP/htdocs/mon-site/ et ouvrez http://localhost:8888/mon-site/.

MAMP utilise le port 8888 par défaut pour Apache (au lieu du port 80 standard). Vous pouvez le changer dans les préférences MAMP : onglet « Ports », cliquez sur « Set Web & MySQL ports to 80 & 3306 ».

# Localisation des fichiers de configuration MAMP (Mac)
# Apache : /Applications/MAMP/conf/apache/httpd.conf
# PHP.ini : /Applications/MAMP/bin/php/phpX.X.X/conf/php.ini
# Logs Apache : /Applications/MAMP/logs/apache_error.log
# Dossier racine web : /Applications/MAMP/htdocs/

# Activer WP_DEBUG dans wp-config.php (avant "That's all, stop editing")
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Méthode 4 : installer WordPress en local avec Docker Compose

Docker Compose est la méthode la plus flexible pour installer WordPress en local. Elle reproduit exactement l’environnement de production (même version PHP, même serveur web, même configuration MySQL) et s’active avec une seule commande. Elle requiert Docker Desktop installé sur votre machine.

Créez un dossier pour votre projet et placez-y ce fichier docker-compose.yml :

version: '3.8'

services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - db_data:/var/lib/mysql

  wordpress:
    depends_on:
      - db
    image: wordpress:php8.2-apache
    restart: always
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wordpress_data:/var/www/html
      - ./wp-content:/var/www/html/wp-content

volumes:
  db_data:
  wordpress_data:

Lancez l’environnement avec :

# Démarrer WordPress + MySQL en arrière-plan
docker compose up -d

# Vérifier que les conteneurs sont actifs
docker compose ps

# Voir les logs en temps réel
docker compose logs -f wordpress

# Arrêter l'environnement
docker compose down

# Arrêter ET supprimer les données (reset complet)
docker compose down -v

Votre WordPress local est accessible sur http://localhost:8080. Le dossier wp-content est monté comme volume : vos thèmes et plugins persistent même si vous recréez les conteneurs. Si vous rencontrez une erreur de connexion à la base de données avec Docker, vérifiez que DB_HOST correspond bien au nom du service (db dans cet exemple), pas à localhost.

Méthode 5 : Local WP, l’outil dédié WordPress

Local WP (anciennement Local by Flywheel) est le logiciel le plus simple pour installer WordPress en local. Il ne nécessite aucune configuration manuelle d’Apache ou de MySQL : tout est abstrait derrière une interface graphique intuitive. Il inclut en plus la fonctionnalité « Live Link » qui génère une URL publique temporaire pour montrer votre développement à un client sans déployer.

Téléchargez Local WP sur localwp.com (gratuit, versions Windows, Mac et Linux). Après l’installation :

  • Cliquez sur « + » pour créer un nouveau site.
  • Choisissez un nom de site (devient l’URL locale, par exemple monsite.local).
  • Sélectionnez l’environnement PHP (choisissez PHP 8.2 ou 8.3).
  • Entrez le nom d’utilisateur, le mot de passe et l’email administrateur WordPress.
  • Cliquez sur « Add Site » : Local WP configure tout et ouvre votre site en 60 secondes.

Local WP gère aussi les imports de sites existants depuis un fichier zip (thème + plugins + base de données) et exporte vers des hébergeurs partenaires comme WP Engine. Pour les développeurs avancés, il expose un accès SSH direct à chaque site via le menu « Open Site Shell ».

# Accès WP-CLI depuis Local WP (via SSH intégré)
# Ouvrir le terminal Local WP : Site > Open Site Shell

# Créer un utilisateur admin supplémentaire
wp user create dev dev@example.com --role=administrator --user_pass=monmdp

# Vider le cache WordPress
wp cache flush

# Mettre à jour tous les plugins
wp plugin update --all

# Exporter la base de données
wp db export backup.sql

Configuration avancée : WP_DEBUG, emails locaux et HTTPS

Une installation locale par défaut ne capture pas les emails sortants (réinitialisation de mot de passe, notifications WooCommerce) : ils partent dans le vide. Installez le plugin MailHog ou WP Mail SMTP en mode test pour intercepter les emails localement.

# Configurer WP_DEBUG dans wp-config.php
# (à ajouter avant "That's all, stop editing")
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );         // log dans wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false );    // ne pas afficher les erreurs à l'écran
define( 'SCRIPT_DEBUG', true );         // JS/CSS non minifiés

// Augmenter la limite mémoire PHP en local
define( 'WP_MEMORY_LIMIT', '512M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

// Réduire les révisions automatiques (allège la base en local)
define( 'WP_POST_REVISIONS', 3 );

Pour activer HTTPS en local (nécessaire pour tester les fonctionnalités qui requièrent SSL), Local WP génère automatiquement un certificat auto-signé via son option « Trust ». Avec XAMPP, vous pouvez utiliser mkcert pour créer un certificat de confiance locale.

# Installer mkcert (macOS avec Homebrew)
brew install mkcert
mkcert -install

# Générer un certificat pour votre domaine local
mkcert monsite.local localhost 127.0.0.1

# Deux fichiers générés :
# monsite.local-cert.pem  (certificat)
# monsite.local-key.pem   (clé privée)
# Les référencer dans la configuration Apache de XAMPP

Migrer votre site local vers le serveur de production

La migration d’un site WordPress local vers la production est une étape délicate à cause des URLs absolues stockées en base de données. L’outil de référence est WP-CLI avec la commande search-replace.

# Export de la base de données locale
wp db export mon-site-local.sql

# Importer sur le serveur de production via SSH + WP-CLI
wp db import mon-site-local.sql

# Remplacer toutes les URLs locales par les URLs de production
wp search-replace 'http://localhost/mon-site' 'https://monsite.com' --all-tables

# Vérifier qu'aucune URL locale ne subsiste (simulation sans modification)
wp search-replace 'localhost' 'monsite.com' --all-tables --dry-run

# Vider les caches après la migration
wp cache flush
wp rewrite flush

Transférez ensuite vos fichiers via FTP ou rsync. Le dossier wp-content/uploads/ peut être volumineux : utilisez rsync -avz --progress pour une copie incrémentale qui reprend là où elle s’est arrêtée si la connexion est coupée.

Si vous rencontrez une erreur critique WordPress après la migration, vérifiez d’abord la compatibilité des plugins avec la version PHP du serveur de production, puis consultez wp-content/debug.log pour identifier l’origine exacte.

Erreurs courantes lors de l’installation locale de WordPress

Voici les problèmes les plus fréquents et leurs solutions directes.

« Error establishing a database connection ». Vérifiez que MySQL est bien démarré dans XAMPP ou WampServer. Ouvrez phpMyAdmin pour confirmer qu’il répond. Dans wp-config.php, confirmez que DB_NAME, DB_USER, DB_PASSWORD et DB_HOST sont corrects. Avec XAMPP, l’utilisateur par défaut est root et le mot de passe est vide.

Page blanche ou erreur 500 après l’installation. Activez WP_DEBUG (voir section précédente), lisez debug.log et identifiez le plugin ou la fonction qui provoque l’erreur 500. Souvent, un plugin incompatible avec la version PHP locale en est la cause.

Les images ne s’affichent pas ou les permaliens sont cassés. Allez dans Réglages > Permaliens et cliquez sur « Enregistrer les modifications » sans rien changer : WordPress régénère le .htaccess. Vérifiez aussi que le module Apache mod_rewrite est activé. Dans XAMPP sous Windows, ouvrez httpd.conf et cherchez la ligne #LoadModule rewrite_module puis retirez le dièse.

Lenteur excessive en local. Désactivez Xdebug si vous ne l’utilisez pas activement : il multiplie les temps d’exécution PHP par 3 à 10. Dans XAMPP, commentez la ligne zend_extension = xdebug dans php.ini.

# Activer mod_rewrite dans XAMPP (fichier httpd.conf)
# Sur Windows : C:xamppapacheconfhttpd.conf
# Sur Linux : /opt/lampp/etc/httpd.conf

# Décommenter cette ligne (retirer le # au debut) :
# LoadModule rewrite_module modules/mod_rewrite.so
# Devient :
LoadModule rewrite_module modules/mod_rewrite.so

# Chercher aussi AllowOverride None pour le dossier htdocs
# et remplacer par :
AllowOverride All

# Redémarrer Apache dans le panneau XAMPP après la modification

Port 80 déjà utilisé sur Windows. Skype, IIS ou un autre processus occupe le port 80. Soit fermez l’application conflictuelle, soit changez le port Apache dans XAMPP (ligne Listen 80 à remplacer par Listen 8080 dans httpd.conf). Votre site sera alors sur http://localhost:8080/mon-site/.

Quel outil choisir selon votre profil

Voici un récapitulatif pour choisir rapidement.

  • Débutant sur Windows : Local WP ou WampServer. Zéro configuration, interface intuitive.
  • Débutant sur Mac : Local WP ou MAMP. Préférez Local WP pour la fonctionnalité Live Link.
  • Développeur qui gère plusieurs projets : Local WP (sites isolés avec leur propre PHP et MySQL) ou Docker Compose (reproductibilité parfaite).
  • Équipe de développement : Docker Compose. Le fichier docker-compose.yml est versionné avec le projet, tous les développeurs ont le même environnement.
  • Correspondance exacte avec la production o2switch : Docker Compose avec l’image PHP correspondante à votre hébergement (PHP 8.2 Apache).
  • Projet complexe avec tests automatisés : Docker Compose avec WP-CLI et un pipeline CI/CD GitHub Actions.

Pour les petits projets ponctuels, Local WP est imbattable en simplicité. Pour les projets durables ou en équipe, Docker Compose est le meilleur investissement sur la durée.

FAQ : installer WordPress en local

Peut-on installer WordPress en local sans internet ?

Oui, complètement. Une fois WordPress téléchargé et l’outil (XAMPP, Local WP, Docker) installé, tout fonctionne hors ligne. Les fichiers WordPress sont sur votre machine, la base de données MySQL est locale et le serveur Apache tourne en local. Certains plugins qui chargent des ressources externes (Google Fonts, CDN) peuvent afficher des avertissements, mais le site reste fonctionnel.

Comment accéder à l’administration WordPress en local ?

L’URL d’administration dépend de votre configuration. Avec XAMPP et un site dans le dossier mon-site, l’admin est sur http://localhost/mon-site/wp-admin/. Avec Local WP, l’URL est générée automatiquement (par exemple http://monsite.local/wp-admin/). Avec Docker Compose sur le port 8080, c’est http://localhost:8080/wp-admin/. Le nom d’utilisateur et le mot de passe sont ceux que vous avez définis lors de l’installation.

WordPress en local et WordPress en production ont-ils les mêmes fonctionnalités ?

Oui, les fonctionnalités WordPress sont identiques. La différence principale est l’environnement serveur : version PHP, limites mémoire, configuration Apache/Nginx. Certaines fonctionnalités nécessitent une configuration supplémentaire en local : les emails (non envoyés par défaut), le HTTPS (certificat auto-signé) et les webhooks ou callbacks OAuth (ils nécessitent une URL publique, que Local WP fournit via Live Link).

Comment synchroniser mon site local avec la version en ligne ?

Plusieurs approches existent. La plus simple : exportez la base de données avec WP-CLI (wp db export), synchronisez les fichiers via FTP ou rsync, importez en production et lancez wp search-replace pour remplacer les URLs locales. Des plugins comme All-in-One WP Migration ou Duplicator automatisent ce processus. Local WP intègre aussi une fonctionnalité d’export direct vers certains hébergeurs (WP Engine, Kinsta, Flywheel).

Est-ce que Docker Compose est vraiment nécessaire pour WordPress en local ?

Docker Compose devient indispensable dans deux cas : quand vous travaillez en équipe (tout le monde a exactement le même environnement) et quand vous avez besoin de reproduire précisément la configuration du serveur de production. Pour un développeur solo sur un projet WordPress standard, Local WP ou XAMPP sont plus simples. Docker Compose a une courbe d’apprentissage plus élevée mais offre une reproductibilité et une isolation parfaites, ainsi que la possibilité de faire tourner plusieurs environnements PHP simultanément (PHP 8.1 pour l’ancien projet, PHP 8.3 pour le nouveau).

Sources

G
WP Admin Lab

Architecte web full-stack. WordPress, performance, data et sécurité. Notes de terrain, tests reproductibles et retours d'expérience.