Как мне заставить xdebug / step-debugging работать с ddev?

Отладка xdebug в любой настройке может быть небольшой проблемой, но вот шаги, которые необходимо предпринять:

• Сначала перечитайте документы.
• Убедитесь, что у вас установлена ​​версия PHPStorm 2019+. Многие версии PHPStorm до 2018.3 и (включая?) Были несовместимы с более новыми версиями XDebug.
• Убедитесь, что xdebug включен; по умолчанию он отключен из соображений производительности. Большинство людей используют ddev exec enable_xdebug, чтобы включить его, когда они этого хотят, и ddev exec disable_xdebug, когда они с ним закончили, но его также можно включить в .ddev/config.yaml.
• Не думайте, что выполняется какой-то непонятный фрагмент кода, и не ставьте там точку останова. Начните с установки точки останова в первой исполняемой строке в вашем index.php. О, как часто люди думают, что это должно быть остановлено, но их код не выполняется.
• ddev ssh в веб-контейнер. Сможете ли вы ping host.docker.internal (и получить ответы)? Если вы не можете этого сделать, возможно, у вас слишком агрессивный брандмауэр.
• В PHPStorm отключите кнопку «прослушивать соединения», чтобы она не слушала. Или просто выйдите из PHPStorm.
• ddev ssh: Может ли telnet host.docker.internal 9000 подключиться? Если это так, у вас есть что-то еще, работающее на порту 9000, возможно, php-fpm. Используйте lsof -i :9000 -sTCP:LISTEN, чтобы узнать, что там, и остановить это, или измените порт xdebug и настройте PHPStorm для использования нового. Не продолжайте, пока ваша команда telnet не подключится.
• Теперь нажмите кнопку прослушивания на PHPStorm, чтобы запустить прослушивание соединений.
• ddev ssh и попробуйте снова telnet host.docker.internal 9000. Он должен подключиться. Если нет, возможно, PHPStorm не прослушивает или не настроен для прослушивания порта 9000?
• Убедитесь, что Xdebug включен. Вы можете использовать php -i | grep grep Xdebug внутри контейнера или использовать любой другой метод, который вы хотите, который дает вывод phpinfo(), включая Drupal admin / reports / status / php. Вы должны увидеть with Xdebug v2.9.6, Copyright (c) 2002-2020, а php -i | grep "xdebug.remote_enable" должен дать вам xdebug.remote_enable: On.
• Установите точку останова в первой соответствующей строке index.php вашего проекта, а затем посетите сайт в браузере. На этом следует остановиться.

Примечание от @heddn: если вы хотите, чтобы xdebug работал только для fpm, например, phpenmod -s fpm xdebug, вместо запуска enable_xdebug.

Примечание от @mfrieling: если вы используете расширение браузера, такое как XDebug Helper, которое устанавливает ключ IDE, он должен быть таким же, как на сервере. Начиная с DDEV 1.10.0, "внутри контейнеров web и db создан реальный пользователь с вашим именем пользователя и идентификатором пользователя", который также используется как ключ IDE по умолчанию. Используемый ключ IDE должен совпадать с сервером, расширением браузера / отправленным файлом cookie и PHPStorm. Вы можете изменить ключ IDE в DDEV, создав файл .ddev/php/xdebug.ini со следующими двумя строками (замените PHPSTORM на значение, которое вы хотите использовать:

[XDebug]
xdebug.idekey = PHPSTORM

Мы будем рады видеть вас здесь!

Спасибо, возникла та же проблема, и добавление файла .ddev/docker-compose.xdebug.yaml устранило проблему.

Однако я работаю на Mac / OSX и обнаружил, что эти дополнительные шаги сработали для обнаружения IP-адреса внутреннего хоста изнутри контейнера:

1.) Войдите в веб-континент ddev ssh

2.) Запускаем ping docker.for.mac.localhost

3.) Установите возвращаемый IP-адрес для host.docker.internal в приведенном выше файле yaml.

4.) Снимаем и запускаем DDEV.

Также стоит упомянуть, что проверка xdebug в PHPStorm полезен для проверки конфигурации.