XDebug не работает с контейнером Podman и VSCode.

Вопрос или проблема

XDebug не работает с контейнером Podman и VSCode.

Ответ или решение

Чтобы наладить работу Xdebug с контейнером Podman и редактором VSCode, необходимо выполнить несколько шагов по настройке окружения. В данной статье я приведу полное руководство по решению этой проблемы.

Шаг 1: Установите необходимые компоненты

Убедитесь, что у вас установлены Podman, PHP и Xdebug внутри вашего контейнера. Для этого вы можете использовать Dockerfile или выполнить следующие команды:

podman pull php:7.4-cli  # замените на нужную вам версию PHP
podman run -it --name my-php-container php:7.4-cli bash

Внутри контейнера установите Xdebug:

pecl install xdebug

Не забудьте включить его в php.ini.

Шаг 2: Настройте Xdebug

Добавьте следующие строки в ваш файл php.ini внутри контейнера:

zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_host=host.docker.internal # Для Windows и Mac
xdebug.remote_host=<IP_ADDRESS> # Укажите IP вашего хоста для Linux
xdebug.remote_port=9000
xdebug.remote_autostart=1
xdebug.idekey=VSCODE

Теперь необходимо определить IP-адрес вашего хоста. Для этого можно использовать команду hostname -I в терминале.

Шаг 3: Настройка сети и портов

Убедитесь, что контейнер и VSCode могут обмениваться данными. При запуске контейнера выполните команды:

podman run -d -p 9000:9000 --name my-php-container my-php-image

Шаг 4: Настройка VSCode

Чтобы настроить отладку в VSCode, установите расширение "PHP Debug" от Felix Becker.

1. Создайте .vscode/launch.json в корне вашего проекта (если его у вас еще нет).
2. Скопируйте и вставьте следующий код в файл launch.json:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www/html": "${workspaceFolder}"  // Замените на путь к вашему проекту в контейнере
            }
        }
    ]
}

Шаг 5: Проверьте настройки

• Запустите контейнер командой podman start my-php-container.
• Убедитесь, что у вас открыт порт 9000 для Xdebug.
• В VSCode запустите конфигурацию "Listen for XDebug" из панели отладки.

Шаг 6: Отладка

Теперь вы можете ставить точки останова в вашем коде и выполнять отладку. Если все настроено правильно, VSCode должен начать получать сообщения от Xdebug.

Проблемы и их решения

1. Xdebug не подключается: Проверьте настройки IP-адреса и портов. Убедитесь, что ваш фаерволл не блокирует порт 9000.
2. Нет сообщений об ошибках: Убедитесь, что Xdebug загружен правильно. Проверьте вывод phpinfo().
3. Отладка не останавливается на точках останова: Проверьте настройки xdebug.idekey и имя конфигурации в VSCode.

Следуя этим шагам, вы сможете успешно настроить отладку PHP с помощью Xdebug в окружении Podman и VSCode. Если у вас возникнут дополнительные вопросы, пожалуйста, не стесняйтесь их задавать.