📏 Проблема

При работе с 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.

Уже установленный PhpStorm и Gateway (не обязательно)
Уже установленный PhpStorm и Gateway (не обязательно)

🔗 Шаг 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.