automattic/wordpress-xdebug

WordPress 与 XDebug Docker 镜像

概述

该镜像基于官方WordPress镜像构建，集成了XDebug PHP扩展，专为WordPress开发设计，方便开发者在开发过程中进行代码调试、错误定位和性能分析。

核心功能与特性

• 集成XDebug PHP扩展，支持代码断点调试
• 基于官方WordPress镜像，保持与标准WordPress环境的兼容性
• 通过环境变量XDEBUG_CONFIG灵活配置XDebug参数
• 支持与主流IDE（如VSCode）配合使用，实现高效调试工作流

使用场景

适用于WordPress主题开发、插件开发、自定义功能开发等场景，特别适合需要进行代码调试和问题排查的开发环境。

使用方法

环境变量配置

通过环境变量XDEBUG_CONFIG配置XDebug PHP扩展参数。

Docker Compose 配置

示例docker-compose.yml配置文件：

yml
version: '3.3'

services:
  db:
    image: docker.xuanyuan.run/bitnami/mariadb:10.3-debian-10
    restart: on-failure
    environment:
      MARIADB_USER: wordpress
      MARIADB_PASSWORD: wordpress
      MARIADB_ROOT_PASSWORD: wordpress
      MARIADB_DATABASE: wordpress

  wp:
    depends_on:
    - db
    image: docker.xuanyuan.run/automattic/wordpress-xdebug
    volumes:
    - ./wp:/var/www/html
    ports:
    - 8080:80
    restart: on-failure
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress

与VSCode配合使用

1. 安装https://marketplace.visualstudio.com/items?itemName=felixfbecker.php-debug
2. 配置路径映射，在.vscode/launch.json中设置pathMappings

示例.vscode/launch.json配置文件：

json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "监听XDebug",
      "type": "php",
      "request": "launch",
      "port": 9000,
      "pathMappings": {
        "/var/www/html": "${workspaceRoot}/wp"
      }
    }
  ]
}

Docker Hub

镜像发布于Docker Hub：https://hub.docker.com/r/automattic/wordpress-xdebug

如何在Docker Hub发布新构建

1. 在https://github.com/Automattic/wordpress-xdebug%E4%BB%93%E5%BA%93%E5%88%9B%E5%BB%BAPull Request，更新Dockerfile中wordpress镜像标签的版本，触发自动构建。查看https://hub.docker.com/r/automattic/wordpress-xdebug/builds%E3%80%82
2. 合并PR（仅限Automattic团队成员）
3. 通过GitHub界面创建指向master分支的发布，发布标签需与Dockerfile中更新的版本匹配（例如若Dockerfile中为FROM wordpress:5.6.1，则发布标签应为5.6.1）。 !image
4. 完成后，automattic/wordpress-xdebug:latest和automattic/wordpress-xdebug:5.6.1都将指向基于wordpress:5.6.1标签的新构建。

许可证

GPL v2

基于https://hub.docker.com/r/andreccosta/wordpress-xdebug%E7%9A%84%E5%85%88%E5%89%8D%E5%B7%A5%E4%BD%9C