⚙️ Développement

Configurer PhpStorm en Remote Development sur WSL

📅 20 juin 2025⏱ 18 min de lecture

Série : Stack Docker WSL

#6 Configurer PhpStorm en Remote Development sur WSLvous êtes ici

#1 Installer Docker sur WSL Debian #2 Créer une CA locale et gérer ses certificats SSL #3 Configurer un accès SSH sécurisé sur WSL Debian #4 Installer et configurer Traefik v3 avec Docker Rootless #5 Stack Docker complète — Symfony + Next.js + Nginx + MariaDB + Redis

Remote Development vs SFTP classique

PhpStorm tourne sur Windows
Synchronise les fichiers vers WSL via SFTP
Indexation côté Windows — latence sur gros projets
Configuration Xdebug complexe avec port mapping

Backend JetBrains installé dans WSL
PhpStorm Windows = interface graphique uniquement
Indexation, Git, terminal, Xdebug tournent dans WSL
Performances identiques à un développement local

Prérequis

PhpStorm installé sur Windows, WSL2 Debian configuré, SSH fonctionnel (voir article SSH), clé ED25519 en place.

Remote Development via SSH

1. Ouvrir Remote Development

Dans PhpStorm, sur l'écran d'accueil :

Remote Development → SSH → New Project

2. Configurer la connexion SSH

Cliquez sur + pour ajouter une connexion :

Champ	Valeur
Host	`localhost`
Port	`22`
Username	votre utilisateur WSL
Authentication type	`Key pair`
Private key file	`C:\Users\<vous>\.ssh\id_ed25519`

Cliquez sur Test Connection pour valider.

3. Choisir le répertoire et installer le backend

Sélectionnez votre dossier de projet dans WSL. Au premier lancement, PhpStorm installe automatiquement un backend JetBrains dans ~/.cache/JetBrains/. Cette opération prend quelques minutes et ne se fait qu'une seule fois.

Le backend est réutilisé pour tous vos projets WSL. Les lancements suivants seront quasi instantanés.

Remote Development via WSL direct

1. Ouvrir Remote Development

Remote Development → WSL → New Project

2. Sélectionner la distribution

PhpStorm détecte automatiquement toutes vos distributions WSL. Sélectionnez Debian, choisissez votre dossier de projet. PhpStorm installe le backend et ouvre le projet — pas besoin de SSH.

Quelle méthode choisir ? WSL direct — plus simple, idéal si vous travaillez uniquement sur Windows + WSL. SSH — plus flexible, fonctionne aussi pour des serveurs distants, VPS ou autres machines.

Fonctionnalités disponibles

Une fois connecté, tout tourne dans WSL :

Terminal intégré — shell WSL directement dans l'IDE
Git — utilise le Git de WSL, pas celui de Windows
Indexation — depuis WSL, bien plus rapide sur les gros projets
Xdebug — se configure directement dans WSL sans port mapping complexe
Plugins — installés côté backend WSL

Commandes utiles

# Voir le backend JetBrains installé dans WSL
ls ~/.cache/JetBrains/
 
# Nettoyer le cache du backend si problème
rm -rf ~/.cache/JetBrains/RemoteDev/
 
# Vérifier que SSH tourne bien
sudo service ssh status

Erreurs fréquentes

Erreur	Cause	Solution
`Connection refused`	SSH non démarré dans WSL	`sudo service ssh start`
`Permission denied (publickey)`	Clé SSH non configurée	Voir article SSH — section 4
Backend bloqué à l'installation	Connexion réseau coupée	Relancer Remote Development, le téléchargement reprend
WSL non détecté	WSL2 non activé	`wsl -l -v` depuis PowerShell pour vérifier
Projet ne s'ouvre pas	Backend corrompu	Supprimer `~/.cache/JetBrains/RemoteDev/` et relancer