По поводу сетевого диска

SPL
Также не забывайте настройку Apache, чтобы он ходил в нужные директории. Если что, конечно, можно сделать связку из php-fpm и nginx — тут уже на ваш вкус.
Настройка xdebug на сервере
Далее настраиваем xdebug стандартным путем по любому мануалу из интернета. Я опишу кратко порядок действий.

• Устанавливаем xdebug через sudo apt-get php-xdebug
  
• Открываем sudo nano /etc/php/7.2/mods-available/xdebug.ini и приводим к такому содержимому
  
  zend_extension=xdebug.so
  xdebug.remote_enable=true
  xdebug.remote_host=wsl.host
  xdebug.remote_port=9002
  xdebug.profiler_enable=1
  xdebug.profiler_output_dir=/tmp
  xdebug.remote_autostart=on
  xdebug.idekey=PHPSTORM
  xdebug.remote_log=/tmp/xdebug.log
  
  
• Перезапускаем apache sudo service apache2 restart
  

Костыль для обратной связи
На этом настройки конкретно xdebug на сервере заканчиваются. Но чтобы данный конфиг заработал нам необходимо в /etc/hosts указать что такое wsl.host. На самом деле мы ожидаем там увидеть IP адрес головной системы на нашем ПК, а именно windows.
Изначально во всех инструкциях, которые я нашел, указывается что нужно писать xdebug.remote_host=127.0.0.1, но сеть в WSL устроена таким образом, что 127.0.0.1 внутри linux будет указывать именно на linux, а не windows. То есть дебаггер, ожидающий подключения в PhpStorm не дождется этих подключений:)
В поисках решения этой проблемы я наткнулся на пост в интернете, откуда решил взять gif-ку что наглядности.

Небольшая гифка-пояснение
Автор поста предлагает свой github репозиторий с C# приложением, которое надо добавить в планировщик Windows чтобы команда выполнялась при каждом запуске ПК. У меня сходу этот скрипт не сработал, да и проводить какие-то кастомизации в Windows не хотелось.
Ценой нескольких часов я собрал "костыльный" bash скрипт, который прописывает автоматически IP адрес хостовой системы в /etc/hosts внутри linux при каждом входе в WSL — инструкцию и скрипт выложил на github.
Но этот скрипт нужно запускать при первом запуске системы. Руками такое делать "не красиво", а стандартный systemd и rc.local через wsl не работают. Поэтому пришлось использовать костыльное и небезопасное, но рабочее решение.

• Создаем файл в корне системы /startup.sh с таким содержимым, даем ему права на запуск chmod +x /startup.sh
  
• Даем права на запуск этого скрипта с sudo без пароля (иначе доступа на запись в /etc/hosts нет)
  
• Добавляем строчку sudo /startup.sh в /etc/profile

При каждом входе в wsl запускается скрипт, который прописывает все что нужно в /etc/hosts и по адресу wsl.host наш linux будет видеть windows. Если кто-то знает как это можно достичь более правильным путем, буду благодарен если отпишите способ в комментариях или можно лично.
После входа в wsl стоит проверить, что хост прописался — пишем команду cat /etc/hosts и на последнем месте должно быть что-то вроде этого:
172.26.64.1 wsl.host
Настройка xdebug в PhpStorm на Windows
После завершения всех работ внутри WSL можно перейти к настройке дебаггера в PhpStorm

• File->Settings->Languages & Framework->PHP
  Открываем выбор интерпретаторов
  
  Первый вариант "From Docker, Vagrant, VM, WSL, Remote"
  
  Выбираем установленный WSL
  
  Убеждаемся, что xdebug активирован
  
  
• File->Settings->Languages & Framework->PHP->Debug
  Активируем прослушивание дебаггера и указываем порт, который ранее указали в WSL (у меня это 9002, а изначально он 9000)
  
  В итоге должно выглядеть примерно так
  
  Убираем галочку в advanced напротив пункта "Pass required configuration options.."
  

Если ее не снять, то дебаггер будет передавать свои параметры по умолчанию и они будут перезатираться — в итоге наш wsl.host будет заменен на 127.0.0.1 и ничего работать не будет.
Причем эта проблема проявляется только при отладке через консоль, т.к. при отладке HTTP сервера никакие конфиги не пробрасываются и забираются из ini файлов.
На этом все — можно проверять работает ли дебаггер.
Проверка результата

• Ставим breakpoint в index.php на любой строчке в коде
  
• Переходим в браузере на этот файл и видимо, что дебаггер заработал
  
  
• Для отладки консольного скрипта необходимо добавить конфигурацию запуска скрипта
  
  Добавляем конфигурацию Php Script
  

Указываем путь до скрипта и нужные аргументы

Сохраняем, закрываем и запускаем дебаггер

Вместо заключения
Таким образом, перелопатив несколько разных источников, статей, гистов я пришел к "почти идеальному" рабочему окружению при работе с PHP. Если есть где чего можно улучшить/доработать пишите в комментарии или в любой другой способ связи со мной.
===========
Источник:
habr.com
===========
Похожие новости:

• [IT-инфраструктура, Браузеры, Высокая производительность, Разработка веб-сайтов, Сетевые технологии] Почему CDN не нужны: развенчиваем старый миф
  
• [PHP, Проектирование и рефакторинг, Серверная оптимизация, Параллельное программирование] Пишем простую ORM с возможностью смены БД на лету
  
• [Open source] RevolveR Contents Management Framework v.1.9.1
  
• [Веб-дизайн, Разработка веб-сайтов] 8 ошибок начинающего PSD дизайнера. Как упростить работу верстальщика
  
• [Управление e-commerce] Всё на продажу: как мы наладили бизнес-процессы для Lamoda и стали продавать их партнерам
  
• [Настройка Linux, Разработка под Windows] Подсистема Windows для Linux 2 (WSL2) стала доступна на ОС Windows 10 версии 1903 и версии 1909
  
• [Разработка веб-сайтов, IT-стандарты, IT-компании] 30 английских аббревиатур, которые должен знать каждый начинающий веб разработчик (перевод)
  
• Microsoft портировал подсистему WSL2 (Windows Subsystem for Linux) в Windows 10 1903 и 1909
  
• [CMS, Разработка веб-сайтов] Как я строил финскую доску объявлений на движке Tamaranga DO
  
• [Разработка веб-сайтов, Python, Управление разработкой] Исправь код, продай техническую фигню, покрути рулетку на Russian Python Week 2020

Теги для поиска: #_razrabotka_vebsajtov (Разработка веб-сайтов), #_php, #_php, #_xdebug, #_wsl, #_windows_subsystem_for_linux, #_phpstorm, #_razrabotka_vebsajtov (
Разработка веб-сайтов
), #_php