manchenkoff/php-xdebug

Docker - Apache / PHP7 / XDebug

本镜像基于Alpine Linux构建，包含以下开发组件，适用于PHP应用的本地开发与调试：

• Apache 2（支持SSL）
• PHP 7（附带pdo、intl、apc等多种扩展）
• Composer

卷挂载说明

• 应用代码目录：/var/www/app
• Apache虚拟主机配置：/etc/apache2/conf.d/hosts.conf

环境变量配置

所有参数可通过.env文件设置：

• HOST_NAME：应用访问URL（默认值：localhost）
• XDEBUG_ENABLED：是否启用XDebug扩展（默认值：false）
• XDEBUG_REMOTE_HOST：调试连接的远程地址（默认值：host.docker.internal）
• PHP_IDE_CONFIG：IDE服务器配置（示例：serverName=localhost）

XDebug调试配置

• 服务器名称：参考PHP_IDE_CONFIG中的serverName值
• 主机地址：${HOST_NAME}
• IDE密钥：PHPStorm
• 端口：9000
• 需配置路径映射

Docker Compose示例

version: 3.7
services:
  php:
    image: docker.xuanyuan.run/manchenkoff/php-xdebug
    container_name: app
    ports:
      - 80:80
      - 443:443
    volumes:
      - ./src/app:/var/www/app:cached
    env_file:
      - .env

默认Apache虚拟主机配置

文件路径：/etc/apache2/conf.d/hosts.conf，可根据项目需求修改：

# HTTP配置段
<VirtualHost *:80>
    DocumentRoot "/var/www/app"
    ServerName {HOST_NAME}
    ServerAdmin admin@{HOST_NAME}

    <Directory "/var/www/app">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

# HTTPS配置段
<VirtualHost *:443>
    DocumentRoot "/var/www/app"
    ServerName {HOST_NAME}
    ServerAdmin admin@{HOST_NAME}

    SSLEngine on
    SSLCertificateFile /etc/ssl/apache2/server.pem
    SSLCertificateKeyFile /etc/ssl/apache2/server.key

    <Directory "/var/www/app">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>