![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 1 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/Frame-7.jpg)
Наконец-то настроил 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 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 2 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image.png)
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 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 3 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-1.png)
Версия PHP обновлена до нужной. Теперь можно заняться xdebug
к содержаниюШаг второй. Установка Xdebug
- Для 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 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 4 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-2.png)
Заодно можете включить opcache, для более быстрой работы админки на локалке.
4) Теперь надо немного настроить файл php.ini
. По дефолту в нем нет настроек раздела xdebug, так что открываем его на редактирование
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 5 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-3.png)
И в свободном месте добавляем настройки
[XDebug]
xdebug.mode=debug
xdebug.client_port = 9090
Обратите внимание! Использую не штатный порт 9003, а 9090. На штатному порту у меня не завелось, но вы можете и штатный попробовать.
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 6 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-4.png)
Сохраняем изменения в php.ini
и перезагружаем Laragon. На этом установка xbebug завершена.
Шаг третий. Настройка PhpStorm для работы с Xdebug
Осталось настроить PhpStorm.
Расширение Xdebug helper
Первое что нужно сделать — установить расширение для браузера Xdebug helper
Важно! После установки заходим в параметры и устанавливаем IDE key в позицию PhpStorm. Незабываем нажать кнопку Save, после изменения.
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 7 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-5.png)
Можно и другие расширения использовать. Какие еще есть, смотрим тут.
к содержаниюОсновные настройки
Теперь открываем нужный проект в 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
В основном разделе PHP укажите вашу версию в CLI Interpreters
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 9 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-8.png)
Настройка конфигурации дебага
Переходим Run → Edit Configurations
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 10 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-9.png)
Создаем новую конфигурацию. Выбираем PHP Remote Debug
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 11 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-10.png)
Теперь настоим ее.
- Name может быть любым, но я предпочитаю по названию проекта называть.
- Ставим чек Filter debug connection by IDE key
- Server: указываем хост нашего проекта, в моем случае
magazin-skulptur.loc
, порт 8080 так по дефолту делает Laragon - IDE key: указываем
PHPSTORM
, то есть тот же, что указывали в Xdebug helper
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 12 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-11.png)
Теперь надо проверить все настройки
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 13 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-12.png)
Нажимаем Validate. Если все отчекалось, значит настройка прошла успешно
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 14 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-13.png)
Использование Xdebug
Все настроили, осталось использовать
На нужной странице сайта, включаем Xdebug helper
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 15 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-14.png)
Включаем прослушивание Run → Start Listening for PHP Debug Connection
или если пользуетесь отдельной панелью, то справа сверху трубку нажимаем
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 16 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-15.png)
Ставим брекпоинты на нужной строке (справа от номера строки) и запускаем дебаг нажатием на жучка. Откроется панель и появиться сообщение что ожидается коннект
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 17 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-18.png)
После обновления страницы, данные придут в панель. Переходом по стрелке, можно смотреть какие данные приходят и что получается.
![Настройка Xdebug в PhpStorm на Windows 10 • Финты WordPress Настройка Xdebug в PhpStorm на Windows 10 • 18 • Финты WordPress](https://wpruse.ru/wp-content/uploads/2023/01/image-17.png)
Внимание! Включенный Xdebug серьезно нагружает процессор, так что имейте ввиду, что если комп начал тормозить, то имеет смысл отключить Xdebug.
к содержаниюЗаключение
Вот и все, обновили версию PHP, установили и настроили Xdebug, теперь ни одна трабла от нас не скроется!
Успехов и берегите себя!