Блог хеллоуворлдщика

Настройка Xdebug на Vagrant


Работаю, никого не трогаю и тут меня спрашивают, "как настроить xdebug на vagrant?"... O_o Я такой про себя, "как... как и везде". И вспомнив, что я уже не раз, как на работе коллегам помогал настраивать Xdebug на Vagrant, понял, что это действительно полезная тема. И пусть все, кто ищет решение данного вопроса натыкаются на данную статью.

Для работы нам понадобится:

Сразу прошу прощения у всех тех, кого огорчил с NetBeans. К сожалению, с недавнего времени работаю на PhpStorm. Если отключить все ненужное, то получается очень удобная IDE с клевыми плюхами, которых нет в NetBeans.

Настройка подразумевает последующую работу через "веб-морду". По поводу CLI в статье ничего нет.

В первую очередь для нашей инструкции Vagrant должен быть настроен с использованием Private Networks, а именно Static IP. Если у вас не так - исправьте это, и запомните указанный IP адрес. Он нам еще понадобится.

Итак, заходим под ssh на нашу виртуальную машину:

$ vagrant ssh

Примеры настройки указаны для PHP 7.1 с php-fmp. Будте внимательны при копировании. У вас может быть другая версия PHP, другие пути и отсутствовать php-fpm вообще.

Установим php-xdebug:

$ sudo apt-get install php7.1-xdebug

Создадим новый текстовый файл в домашней директории с любым названием, например, xdebug.sh и поместим в него следующее содержимое:

#!/usr/bin/env bash

xdebug=$(cat <<EOF
zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_connect_back=1
xdebug.remote_log=/tmp/php-xdebug.log
xdebug.idekey=vagrant-xdebug # запомните этот idekey
xdebug.remote_host=192.168.20.20 # IP адрес вашей vagrant-машины, который мы указали при настройке Static IP
xdebug.max_nesting_level=1000
EOF
)
echo "${xdebug}" > /etc/php/7.1/fpm/conf.d/20-xdebug.ini # здесь стоит упомянуть, что вы должны указать свой путь до директории `conf.d` в php, где будет создан файл `20-xdebug.ini`

Сохраним и закроем файл. Теперь выполним его:

$ bash ./xdebug.sh

На этом этап настройки Xdebug на Vagrant закончен. Теперь мы должны настроить нашу IDE:

В PhpStorm перейдем в Preferences > Languages & Frameworks > PHP > Debug и убедимся, что у вас все тоже самое (кроме поля Automatically detect IDE IP! у вас там будут свои значения! должна совпадать только галочка):

PhpStorm Debug Settings


Перейдем в Preferences > Languages & Frameworks > PHP > Servers, где укажем наш vagrant-сервер:

PhpStorm Server Settings


Откроем Run/Debug Configurations:

PhpStorm Run/Debug Configurations


Добавим новый PHP Debug Remote Configuration:

PhpStorm PHP Debug Remote Configuration


Укажем нашу ранее созданную настройку сервера и ранее указанный idekey в настройках Vagrant'а:

PhpStorm change PHP Debug Remote Configuration

Посетим оф. странцу JetBrains с Browser Debugging Extensions и скачаем нужное расширение для своего браузера.

Откроем настройки ранее скаченного Debug Extension и укажем idekey, который мы уже указали в натсройках Вагранта и в настройках Run/Debug Configurations:

Debug Extension idekey


Теперь активируем Debug Extension и слушатель в нашей IDE:

Browser Debug Extension Listener
PhpStorm Debug Listener


И укажем точку остановки в каком-нибудь файле, который будет отработан во время запроса, нашего проекта:

PhpStorm Debug Stop Pointer


Выполним запрос к сайту через наш браузер:

Возможно, у вас может появится окно информирующее о входящем соединении для отладки:

PhpStorm Incoming Debug Connection


В этом окне нужно указать вашу точку входа в проект и подтвердить соединение. После этого настройка будет завершена и вы можете использовать Xdebug:

PhpStorm Complete Configuration


share via vkontakte share via facebook share via mailru share via odnoklassniki share via twitter

Комментарии [0]

Нет комментариев.