php - xdebug 3 无法在 ubuntu 20.04 中使用 docker

Question

我正在尝试在 ubuntu 20.04 上将 xdebug 3 与 docker 一起使用，但我没有成功，xdebug不进入中断点，我已经搜索了一切都没有答案解决我的问题，这将是关于docker主机的事情，因为相同的配置在windows中是正确的，我不知道我还能尝试什么解决问题，我想了解我做错了什么，下面是我的配置。

我的 docker-compose 文件

version: '3.7'

networks:
  supervisao:

services:
  nginx:
    image: nginx:stable-alpine
    container_name: supervisao-web
    ports:
      - "80:80"
    volumes:
      - .:/var/www/html/
      - ./.docker/web/default.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php
      - mysql
    networks:
      - supervisao
  mysql:
    image: mysql:latest
    container_name: supervisao-db
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    tty: true
    ports:
      - "3306:3306"
    volumes:
      - ./.docker/mysql/:/var/lib/mysql
    environment:
      MYSQL_DATABASE: supervisao
      MYSQL_USER: user
      MYSQL_PASSWORD: pass
      MYSQL_ROOT_PASSWORD: pass
      SERVICES_TAGS: dev
      SERVICES_NAME: mysql
    networks:
      - supervisao
  php:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: supervisao-php
    volumes:
      - .:/var/www/html/
      - ./.docker/php/docker-xdebug.ini:/usr/local/etc/php/conf.d/php-docker.ini
    ports:
      - "9000:9000"
    networks:
     - supervisao
  redis:
    image: redis:latest
    volumes:
      - ./.docker/redis:/data
    ports:
      - 6379:6379
    networks:
      - supervisao

我的 xdebug.ini

# File: docker-xdebug.ini
zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20190902/xdebug.so
xdebug.discover_client_host=1
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.client_host = host.docker.internal
xdebug.client_port = 9003
xdebug.log = /var/www/html/xdebug.log

如果有人可以合作，我很感激，谢谢

Answer 1

确保您在 PHP 中加载了 xdebug 3。创建 phpinfo.php 文件

<?php
    phpinfo();

浏览它以检查 xdebug 是否由 PHP 加载并且是版本 3。

如果 xdebug 是 2.x 版，那么您可以使用 pecl 安装 v3。如果您可以通过 shell 访问您的 docker box，您可以直接尝试 pecl 命令并在 phpinfo 中查看您是否安装了 xdebug v3。

在你的 DockerFile 中:

# PECL
RUN mkdir -p /tmp/pear/cache
RUN pecl channel-update pecl.php.net
RUN apt install -y php-pear

COPY xdebug.ini "/etc/php/${PHP_VERSION}/mods-available/xdebug.ini"
# The xdebug distributed with Ubuntu 20.04 LTS is v2.9.2, we want v3.0.x
RUN pecl install xdebug
# Enable xdebug by default
RUN phpenmod xdebug
 

在你的 xdebug.ini 中

zend_extension=xdebug.so
xdebug.default_enable = On
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.discover_client_host=yes
xdebug.max_nesting_level = -1
xdebug.log = "/var/www/log/xdebug.log"
xdebug.output_dir = "/var/www/log/profiler" 

现在你可以重建 docker boxes

docker stop  
docker build --no-cache
docker up

如果启用了设置，请检查 phpinfo。

如果您可以通过 shell 访问您的 docker box，您可以查看日志文件。

tail -n 100 /var/www/log/xdebug.log

如果您运行 PHP Storm，那么在 PHP Storm >> 文件 >> 设置 >> 语言和框架 >> PHP >> 调试中有一个优秀的验证器单击链接“验证”。将本地 Web 服务器路径设置为您的公用文件夹。验证脚本到您的网址。适用于共享文件夹，但不适用于同步文件夹。

如果您将 Ubuntu 作为主机运行，那么请查看防火墙设置。"9000/tcp ALLOW IN Anywhere"和端口 9003 相同。或者尝试暂时禁用防火墙。

我还将端口 9003:9003 添加到 DockerFile。但是还没有测试这是否有任何区别。

希望以上内容对您有所帮助。