Php 使用Docker Compose和WordPress图像设置Xdebug

我正在尝试使用docker compose设置Xdebug。我正在使用PhpStorm IDE，我正在使用的Docker映像将安装PHP7.2。我试着在WordPress图片的背景下做这件事。这是我当前的docker-compose.yml文件：

    version: '3'

    services:
   db:
     image: mysql:5.7
     ports: 
       - "3306:3306"
     volumes:
       - db_data:/var/lib/mysql
     restart: always
     environment:
       MYSQL_ROOT_PASSWORD: somewordpress
       MYSQL_DATABASE: wordpress
       MYSQL_USER: wordpress
       MYSQL_PASSWORD: wordpress

   web-build-scripts:
     build: .
     depends_on:
       - db
     ports:
       - "8028:80"
       - "8029:8029"

     volumes:
       - ./themes/XXXXX:/var/www/html/wp-content/themes/XXXX
       - ./plugins/XXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX
       - ./plugins/XXXXX:/var/www/html/wp-content/plugins/XXXXX


     restart: always
     environment:
       WORDPRESS_DB_HOST: db:3306
       WORDPRESS_DB_USER: wordpress
       WORDPRESS_DB_PASSWORD: wordpress
       VIRTUAL_HOST: leasepilot.local

volumes:
    db_data:

然后，我标记为web构建脚本（当然是构建脚本）的Dockerfile如下所示：

FROM wordpress:latest

WORKDIR /var/www/html
RUN pecl install xdebug-2.6.0 \
    && docker-php-ext-enable xdebug \
    && apt-get update \
    && apt-get install nano \
    && export TERM=xterm

COPY Search-Replace-DB/ ./wp-content/Search-Replace-DB/
COPY uploads/ ./wp-content/uploads/
COPY ./docker-config/xdebug.ini ../../../usr/local/etc/php/conf.d/xdebug.ini

其中，本地docker config目录中的xdebug.ini文件如下所示：

zend_extension=xdebug.so
xdebug.default_enable=1
xdebug.remote_autostart=1
xdebug.remote_connect_back=0
xdebug.remote_port=9001
xdebug.remote_enable=1
xdebug.idekey=PHPSTR
xdebug.remote_host = docker.for.mac.internal

在PHPStorm中，我设置了如下调试设置： 我已经设置了服务器映射，如下所示：

我还将调试端口设置为9001，就像我在xdebug.ini文件中所做的那样：

当我运行php-ini | grepxdebug命令时，我的输出如下：

root@a96543427809:/var/www/html# php -ini | grep xdebug
Cannot load Xdebug - it was already loaded
/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini,
/usr/local/etc/php/conf.d/xdebug.ini
xdebug
xdebug support => enabled
xdebug.auto_trace => Off => Off
xdebug.cli_color => 0 => 0
xdebug.collect_assignments => Off => Off
xdebug.collect_includes => On => On
xdebug.collect_params => 0 => 0
xdebug.collect_return => Off => Off
xdebug.collect_vars => Off => Off
xdebug.coverage_enable => On => On
xdebug.default_enable => On => On
xdebug.dump.COOKIE => no value => no value
xdebug.dump.ENV => no value => no value
xdebug.dump.FILES => no value => no value
xdebug.dump.GET => no value => no value
xdebug.dump.POST => no value => no value
xdebug.dump.REQUEST => no value => no value
xdebug.dump.SERVER => no value => no value
xdebug.dump.SESSION => no value => no value
xdebug.dump_globals => On => On
xdebug.dump_once => On => On
xdebug.dump_undefined => Off => Off
xdebug.extended_info => On => On
xdebug.file_link_format => no value => no value
xdebug.filename_format => no value => no value
xdebug.force_display_errors => Off => Off
xdebug.force_error_reporting => 0 => 0
xdebug.gc_stats_enable => Off => Off
xdebug.gc_stats_output_dir => /tmp => /tmp
xdebug.gc_stats_output_name => gcstats.%p => gcstats.%p
xdebug.halt_level => 0 => 0
xdebug.idekey => PHPSTR => PHPSTR
xdebug.max_nesting_level => 256 => 256
xdebug.max_stack_frames => -1 => -1
xdebug.overload_var_dump => 2 => 2
xdebug.profiler_aggregate => Off => Off
xdebug.profiler_append => Off => Off
xdebug.profiler_enable => Off => Off
xdebug.profiler_enable_trigger => Off => Off
xdebug.profiler_enable_trigger_value => no value => no value
xdebug.profiler_output_dir => /tmp => /tmp
xdebug.profiler_output_name => cachegrind.out.%p => cachegrind.out.%p
xdebug.remote_addr_header => no value => no value
xdebug.remote_autostart => On => On
xdebug.remote_connect_back => Off => Off
xdebug.remote_cookie_expire_time => 3600 => 3600
xdebug.remote_enable => On => On
xdebug.remote_handler => dbgp => dbgp
xdebug.remote_host => docker.for.mac.internal => docker.for.mac.internal
xdebug.remote_log => no value => no value
xdebug.remote_mode => req => req
xdebug.remote_port => 9001 => 9001
xdebug.remote_timeout => 200 => 200
xdebug.scream => Off => Off
xdebug.show_error_trace => Off => Off
xdebug.show_exception_trace => Off => Off
xdebug.show_local_vars => Off => Off
xdebug.show_mem_delta => Off => Off
xdebug.trace_enable_trigger => Off => Off
xdebug.trace_enable_trigger_value => no value => no value
xdebug.trace_format => 0 => 0
xdebug.trace_options => 0 => 0
xdebug.trace_output_dir => /tmp => /tmp
xdebug.trace_output_name => trace.%c => trace.%c
xdebug.var_display_max_children => 128 => 128
xdebug.var_display_max_data => 512 => 512
xdebug.var_display_max_depth => 3 => 3

我已经阅读了好几篇教程，还没有弄明白这一点。有人有什么见解可以帮助我吗？

我会怎么做

• 首先，您使用的是

  wordpress:latest

  ，因此您必须找到哪个php 版本：您的wordpress映像正在运行
• 然后检查容器中是否安装了xdebug。很可能不是
• 使用

  xdebug

  安装为开发创建

  Dockerfile

  ，不要将其用于生产，这会降低性能
• 从该

  Dockerfile

  构建wordpress图像
• 您可能需要创建带有远程主机详细信息的

  xdebug.ini

  文件，我使用的是phpstrom，这就是我的

  xdebug.ini

  的样子。我将此文件保存在主机中，并使用

  卷复制它

这就是我的docker compose文件的外观

• 然后使用

  xdebug.ini

  详细信息配置phpstorm远程调试
• 要确保xdebug配置已加载，请登录到容器并运行

  php-ini | grepXdebug

• 这是让

  xdebug

  工作的一种方法
• 如果不起作用，请启用xdebug日志，将

  xdebug.remote\u log=/log\u path/xdebug.log

  添加到xdebug.ini将有助于诊断问题
• 如果您还需要有关设置phpstorm远程调试的帮助，请与我联系。实际上有很多资源
@david jarrin
查看您的

php-ini

输出，您的XDebug似乎已经在运行了。它可能正在安装（并激活）一个从不使用的版本，即3.x版而不是您指定的2.x版吗？这就是我的悲哀
请注意，XDebug版本3引入了大量不向后兼容的配置名称更改。有一个空位。您会发现各种配置键都已更改，包括从Docker容器运行XDebug时至关重要的配置键
我和你一样使用Wordpress Docker的官方图片，花了一段时间才弄明白为什么xdebug.remote_主机突然不工作了，为什么我的日志没有显示出来。这些都在升级指南中
这是一个基本的配置，在使用VS代码时对我有效
您可以在Dockerfile中包含xdebug安装。这实际上是在Wordpress容器使用的php容器中运行一个自定义函数，

docker php ext enable

。使用Dockerfile构建支持XDebug的Wordpress容器版本：

FROM wordpress:latest

RUN pecl install "xdebug" \
    && docker-php-ext-enable xdebug

在与

docker compose.yml

文件相关的文件夹中创建一个xdebug.ini文件，如

/conf/xdebug.ini

，例如：

xdebug.client_host=host.docker.internal
xdebug.client_port=9000
xdebug.mode=debug
xdebug.log_level=7
xdebug.log="/tmp/xdebug.log"
xdebug.idekey=sts-debug
xdebug.max_nesting_level=1500
xdebug.connect_timeout_ms=60000

在

docker compose.yml

文件中像这样插入xdebug配置更为灵活，这样您就不必每次更改xdebug配置时都重新生成映像

wordpress:
    build: .
    depends_on:
      - db
    image: custom-wordpress:latest
    ports:
      - '8000:80'
    restart: unless-stopped
    volumes:
      - './:/var/www/html'
      - ./conf/xdebug.ini:/usr/local/etc/php/conf.d/xdebug.ini

---

快乐的小径
@Ntwobike我已经根据你的建议编辑了我的答案，但我仍然无法让代码在任何时候停止！您还有什么建议吗？请尝试在phpstorm中设置端口。Xdebug部分中的Language framework->PHP->Debug将调试端口设置为9001还有一个小提示：我只使用PHP远程调试，而不使用PHP网页@Ntwobike。我继续切换到PHP远程调试，使用和不使用过滤器调试连接（使用Xdebug.ini文件中的键PHPSTR）。我在想我把我的xdebug.ini文件放错位置了？是的，可能是这样，登录到容器并检查

php-ini | grep xdebug

如果你没有看到xdebug的详细信息，那么它就没有加载@Ntwobike，看起来我的配置正在加载中（参见我的编辑）。。。。我想下一步要看的是我如何设置我的路径。应该注意的是，我正在通过卷加载我的主题。。。我真的不知道这有什么关系。

xdebug.client_host=host.docker.internal
xdebug.client_port=9000
xdebug.mode=debug
xdebug.log_level=7
xdebug.log="/tmp/xdebug.log"
xdebug.idekey=sts-debug
xdebug.max_nesting_level=1500
xdebug.connect_timeout_ms=60000

wordpress:
    build: .
    depends_on:
      - db
    image: custom-wordpress:latest
    ports:
      - '8000:80'
    restart: unless-stopped
    volumes:
      - './:/var/www/html'
      - ./conf/xdebug.ini:/usr/local/etc/php/conf.d/xdebug.ini