Настройка Xdebug в PhpStorm на Windows 10 • 1 • Финты WordPress

Настройка Xdebug в PhpStorm на Windows 10

Наконец-то настроил Xdebug. Это такая крутая штука скажу я вам. Показывает всё: что пришло, что ушло, в каком виде и тд. Очень круто и удобно. Но Xdebug надо настроить чтобы все работало.

Так что, эта статейка будет справочником чтобы не забыть алгоритм настройки.

Исходные данные

Я работаю на Windows 10 c подсистемой Ubuntu 18, для локального cервера использую Laragon (на мой взгляд, лучшего ничего нет). В итоге исходные данные такие получаются:

  • ОП: Windows 10
  • IDE: PhpStorm 2022.1
  • Local server: Laragon 5.0.0
  • PHP: 7.4.33

Важный момент! Версия php должна быть не ниже 7.4.20, иначе xdebug не будет работать. Актуальная версия PHP на момент написания статьи: 7.4.33

к содержанию

Шаг первый. Обновление версии PHP для Laragon

1. Скачиваем нужную версию PHP c сайта

Настройка Xdebug в PhpStorm на Windows 10 • 2 • Финты WordPress

2. Полученный архив вида php-7.4.33-Win32-vc15-x64.zip копируем в папку \bin\php\ вашей установки Laragon. И там распаковываем в папку с тем же именем, например php-7.4.33-Win32-vc15-x64

3. Если Laragon запущен, то останавливаем его, и меняем версию на нужную. И снова запускаем.

Настройка Xdebug в PhpStorm на Windows 10 • 3 • Финты WordPress

Версия PHP обновлена до нужной. Теперь можно заняться xdebug

к содержанию

Шаг второй. Установка Xdebug

  1. Для Php 7.4.33 нужную версию xdebug просто так не найдешь. Ну почему, у них так на сайте сделано, что только под php 8.0 можно скачать сразу, все остальное только через танцы с бубнами.

2) После скачивания, получим файл вида php_xdebug-3.1.6-7.4-vc15-x86_64.dll. Копируем его в папку с нужной версией PHP по пути \laragon\bin\php\php-7.4.33-Win32-vc15-x64\ext

И переименовываем файл php_xdebug-3.1.6-7.4-vc15-x86_64.dll в php_xdebug.dll для краткости.

3) Запускаем xdebug в Laragon

Настройка Xdebug в PhpStorm на Windows 10 • 4 • Финты WordPress

Заодно можете включить opcache, для более быстрой работы админки на локалке.

4) Теперь надо немного настроить файл php.ini. По дефолту в нем нет настроек раздела xdebug, так что открываем его на редактирование

Настройка Xdebug в PhpStorm на Windows 10 • 5 • Финты WordPress

И в свободном месте добавляем настройки

[XDebug]
xdebug.mode=debug
xdebug.client_port = 9090

Обратите внимание! Использую не штатный порт 9003, а 9090. На штатному порту у меня не завелось, но вы можете и штатный попробовать.

Настройка Xdebug в PhpStorm на Windows 10 • 6 • Финты WordPress

Сохраняем изменения в php.ini и перезагружаем Laragon. На этом установка xbebug завершена.

к содержанию

Шаг третий. Настройка PhpStorm для работы с Xdebug

Осталось настроить PhpStorm.

Расширение Xdebug helper

Первое что нужно сделать — установить расширение для браузера Xdebug helper

Важно! После установки заходим в параметры и устанавливаем IDE key в позицию PhpStorm. Незабываем нажать кнопку Save, после изменения.

Настройка Xdebug в PhpStorm на Windows 10 • 7 • Финты WordPress

Можно и другие расширения использовать. Какие еще есть, смотрим тут.

к содержанию

Основные настройки

Теперь открываем нужный проект в PhpStorm и идем в основные настройки File → Settings → PHP

Ставим тот порт, который указали в настройках php.ini. В нашем случае — 9090. И снимаем галки с пунктов:

  • Force break at first line when no path mapping specified 
  • Force break at first line when a script is outside the project
Настройка Xdebug в PhpStorm на Windows 10 • 8 • Финты WordPress

В основном разделе PHP укажите вашу версию в CLI Interpreters

Настройка Xdebug в PhpStorm на Windows 10 • 9 • Финты WordPress
к содержанию

Настройка конфигурации дебага

Переходим Run → Edit Configurations

Настройка Xdebug в PhpStorm на Windows 10 • 10 • Финты WordPress

Создаем новую конфигурацию. Выбираем PHP Remote Debug

Настройка Xdebug в PhpStorm на Windows 10 • 11 • Финты WordPress

Теперь настоим ее.

  • Name может быть любым, но я предпочитаю по названию проекта называть.
  • Ставим чек Filter debug connection by IDE key
  • Server: указываем хост нашего проекта, в моем случае magazin-skulptur.loc, порт 8080 так по дефолту делает Laragon
  • IDE key: указываем PHPSTORM, то есть тот же, что указывали в Xdebug helper
Настройка Xdebug в PhpStorm на Windows 10 • 12 • Финты WordPress

Теперь надо проверить все настройки

Настройка Xdebug в PhpStorm на Windows 10 • 13 • Финты WordPress

Нажимаем Validate. Если все отчекалось, значит настройка прошла успешно

Настройка Xdebug в PhpStorm на Windows 10 • 14 • Финты WordPress
к содержанию

Использование Xdebug

Все настроили, осталось использовать

На нужной странице сайта, включаем Xdebug helper

Настройка Xdebug в PhpStorm на Windows 10 • 15 • Финты WordPress

Включаем прослушивание Run → Start Listening for PHP Debug Connection или если пользуетесь отдельной панелью, то справа сверху трубку нажимаем

Настройка Xdebug в PhpStorm на Windows 10 • 16 • Финты WordPress

Ставим брекпоинты на нужной строке (справа от номера строки) и запускаем дебаг нажатием на жучка. Откроется панель и появиться сообщение что ожидается коннект

Настройка Xdebug в PhpStorm на Windows 10 • 17 • Финты WordPress

После обновления страницы, данные придут в панель. Переходом по стрелке, можно смотреть какие данные приходят и что получается.

Настройка Xdebug в PhpStorm на Windows 10 • 18 • Финты WordPress

Внимание! Включенный Xdebug серьезно нагружает процессор, так что имейте ввиду, что если комп начал тормозить, то имеет смысл отключить Xdebug.

к содержанию

Заключение

Вот и все, обновили версию PHP, установили и настроили Xdebug, теперь ни одна трабла от нас не скроется!

Успехов и берегите себя!

5 2 голоса
Рейтинг статьи

    Об авторе
    Артем Абрамович

    Автор и ведущий проекта «Финты WordPress». WordPress & WooCommerce разработчик. Четыре года создаю плагины и темы. В свободное время пишу статьи, видеообзоры, гайды.

    Подписаться
    Уведомить о
    guest
    0 комментарев
    Новые
    Старые Популярные
    Межтекстовые Отзывы
    Посмотреть все комментарии
    0
    Оставьте комментарий! Напишите, что думаете по поводу статьи.x