使用Docker Compose和WordPress镜像配置Xdebug

Question

使用Docker Compose和WordPress镜像配置Xdebug

5

我正在尝试使用docker-compose设置Xdebug。我正在使用PhpStorm IDE，而我使用的Docker镜像安装了PHP 7.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:

然后我的Dockerfile，我将其标记为web-build-scripts（当然已经构建），看起来像这样：

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

我的xdebug.ini文件位于本地docker-config目录中，内容如下:

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 | grep xdebug时，输出如下：

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

我已经看了几个教程，但仍然无法理解。有没有人能给我一些帮助？

- David Jarrin

2个回答

3

@david-jarrin，

看了你的php -ini输出，似乎你的XDebug已经在运行。是不是安装（并激活）了一个版本为3.x而不是你指定的2.x？这就是我的问题所在。

请注意，XDebug的第三个版本引入了相当数量的配置名称更改，这些更改不向后兼容。有升级指南可用。你会发现各种配置键已经改变，包括在从Docker容器中运行XDebug时至关重要的键。

我像你一样使用官方的WordPress Docker镜像，花了一段时间才找到原因，为什么xdebug.remote_host突然不起作用了，以及为什么我的日志没有显示出来。这都在升级指南中。

这是一个基本的配置，适用于我使用VS Code和{{link2：felixbecker的XDebug扩展程序}}。

你可以在Dockerfile中包含xdebug安装。这实际上是在php容器中运行一个自定义函数，Wordpress容器正在使用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

愉快的旅程！

- lauri108

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Ntwobike · Accepted Answer

我的建议

首先，您正在使用 wordpress:latest，因此您需要找到您的 wordpress 镜像运行的 php 版本。
然后检查容器中是否安装了 xdebug。很可能没有！
为开发创建一个包含 xdebug 安装的 Dockerfile，不要将其用于生产环境，否则会降低性能。
从该 Dockerfile 构建 your-wordpress 镜像。
您可能需要创建 xdebug.ini 文件，并填写您的远程主机详细信息。我正在使用 phpstrom，这是我的 xdebug.ini 文件内容。我将此文件保存在我的主机上并使用 volumes 进行复制。

zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_handler=dbgp
xdebug.remote_port=10000 # dont use 9000 its usually used by the php-fpm
xdebug.remote_autostart=1
xdebug.remote_connect_back=0
xdebug.idekey=PHPSTRM
xdebug.remote_host=host-ip-here

这是我的docker-compose文件的样子。

version: '2'
services:
    my-service:
        build:
          context: ./dev
          dockerfile: Dockerfile
        ports:
            - "8080:80"
        restart: always
        environment:
            - RUNTIME_ENVIRONMENT=local
        working_dir: /src
        volumes:
            - ./src:/src
            - ./php-ini-overrides-dev.ini/xdebug.ini:/etc/php/7.1/mods-available/xdebug.ini

然后使用xdebug.ini详细配置phpstorm远程调试。
为确保xdebug配置已经加载，登录容器并运行php -ini | grep xdebug。
这是让xdebug工作的一种方式。
如果它没有工作，请启用xdebug日志，在xdebug.ini中添加xdebug.remote_log=/log_path/xdebug.log将有助于诊断问题。
如果您还需要帮助设置phpstorm远程调试，请告诉我。实际上，这里有很多资源可供参考。