📏 Проблема
При работе с PhpStorm внутри WSL через JetBrains Gateway оказывается, что даже при наличии новой версии IDE на хостмашине (например, 2025.1.2), в WSL запускается устаревшая (2024.3.1 RC), загруженная Gateway автоматически. Это приводит к несовместимости с плагинами (Laravel Idea, AI Assistant), ограниченной функциональности и проблемам с отладкой.
Решение — установить актуальную GUI-версию PhpStorm напрямую в WSL через Toolbox App, без Gateway.
📀 Что потребуется
- WSL2 + WSLg (Windows 11);
- Ubuntu или другой Linux внутри WSL;
- Терминал и доступ в интернет.
🛠 Шаг 1. Получение ссылки на актуальную версию Toolbox
Скачивать Toolbox App лучше через официальный API JetBrains:
$ wget -O toolbox.json "https://data.services.jetbrains.com/products/releases?code=TBA&latest=true&type=release"
Затем извлекается поле linux.link:
$ cat toolbox.json | grep -oP '"linux":\s*"\K[^"]+'
Если установлен jq, стандартный вариант:
$ jq -r '.TBA[0].downloads.linux.link' toolbox.json
Пример ссылки:
https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.6.3.43718.tar.gz
Скачиваем и распаковываем:
$ wget https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.6.3.43718.tar.gz
$ tar -xzf jetbrains-toolbox-2.6.3.43718.tar.gz
$ cd jetbrains-toolbox-2.6.3.43718
🧰 Шаг 2. Установка зависимостей
$ sudo apt update
$ sudo apt install -y libfuse2 libxi6 libxrender1 libxtst6 libfontconfig libgtk-3-bin
🚀 Шаг 3. Установка PhpStorm через Toolbox
$ ./jetbrains-toolbox &
После запуска Toolbox открывается графическое окно. Из списка IDE выбирается PhpStorm и устанавливается актуальная версия в WSL.
🔗 Шаг 4. Alias для запуска
Сначала нужно найти phpstorm.sh:
$ find ~ -type f -name phpstorm.sh 2>/dev/null
Пример пути:
~/.local/share/JetBrains/Toolbox/apps/phpstorm/bin/phpstorm.sh
Добавление alias:
$ echo 'alias phpstorm="$HOME/.local/share/JetBrains/Toolbox/apps/phpstorm/bin/phpstorm.sh"' >> ~/.bashrc
$ source ~/.bashrc
Теперь PhpStorm запускается командой:
$ phpstorm &
📎 Шаг 5. Ярлык для Windows
В ярлыке на рабочем столе Windows достаточно указать:
wsl.exe -d Ubuntu -- bash -ic "phpstorm"
Ключ -ic обеспечивает загрузку .bashrc, без него alias не будет работать.
✅ Результат
- Установлена PhpStorm 2025.1.2 напрямую внутри WSL;
- Совместимость с плагинами и современным стеком;
- Запуск IDE как из Linux-терминала, так и из ярлыка Windows;
- Нет зависимости от Gateway.
📌 Вывод
Стандартный JetBrains Gateway удобен, но не даёт контроля над версией IDE. Установка Toolbox и последней PhpStorm внутри WSL устраняет это ограничение, позволяет использовать актуальные плагины, улучшает стабильность и избавляет от проблем совместимости. Решение хорошо подходит для ежедневной разработки и легко масштабируется на другие продукты JetBrains.