PHP 开发镜像文档

!Webdevops Dockerfile

1. 镜像概述与主要用途

1.1 概述

本镜像为 WebDevOps 提供的 PHP 开发专用镜像，专注于为 PHP 应用开发提供便捷的调试环境。镜像由 WebDevOps Build Server 构建并持续测试，确保稳定性与兼容性。

1.2 主要用途

• 支持 PHP 应用的本地开发与调试
• 提供集成化的开发工具链，简化开发环境配置
• 作为 PHP 项目开发阶段的基础运行环境

2. 核心功能与特性

• 调试工具集成：内置调试工具（如 Xdebug），支持 PHP 代码断点调试、性能分析等开发场景。
• 开发优化：针对开发流程优化，包含常用开发依赖与工具，减少环境配置成本。
• 可靠构建：由 WebDevOps 自动化构建系统持续构建与测试，确保镜像版本一致性与可用性。

3. 使用场景与适用范围

3.1 适用场景

• PHP 应用的本地开发与调试会话
• 开发团队统一开发环境搭建
• PHP 代码调试、断点测试及性能分析

3.2 适用范围

• PHP 开发人员及开发团队
• 需要快速搭建 PHP 调试环境的场景
• 依赖 Xdebug 等工具的 PHP 开发流程

4. 使用方法与配置说明

4.1 镜像获取

通过 Docker Hub 拉取镜像（具体标签参考 ***文档）：

bash
docker pull webdevops/php-dev:<tag>  # 替换 <tag> 为具体版本标签（如 latest、8.2、7.4 等）

4.2 基础使用流程

1. 拉取目标版本镜像
2. 运行容器并挂载本地代码目录
3. 配置调试工具（如 Xdebug）
4. 启动开发服务进行调试

5. Docker 部署方案示例

5.1 单容器运行（docker run）

bash
docker run -it --rm \
  --name php-dev-env \
  -v $(pwd):/app  # 挂载本地代码目录至容器内 /app
  -p 8080:80  # 暴露容器 80 端口至本地 8080
  -e XDEBUG_MODE=debug  # 启用 Xdebug 调试模式
  -e XDEBUG_CLIENT_HOST=host.docker.internal  # 调试客户端主机（本地开发环境通常为宿主机 IP 或 host.docker.internal）
  -e XDEBUG_CLIENT_PORT=9003  # Xdebug 客户端端口（默认 9003）
  webdevops/php-dev:latest

5.2 Docker Compose 配置

创建 docker-compose.yml：

yaml
version: '3.8'
services:
  php-dev:
    image: webdevops/php-dev:latest
    volumes:
      - ./:/app  # 挂载本地代码目录
    ports:
      - "8080:80"  # 端口映射
    environment:
      - XDEBUG_MODE=debug,develop  # 启用调试与开发模式
      - XDEBUG_CLIENT_HOST=host.docker.internal  # 调试客户端主机
      - XDEBUG_CLIENT_PORT=9003  # 调试端口
      - PHP_INI_SCAN_DIR=/etc/php/conf.d  # PHP 配置文件扫描目录（可选）
    working_dir: /app  # 容器工作目录

启动服务：

bash
docker-compose up -d

6. 配置参数与环境变量

镜像支持通过环境变量配置核心功能（详细列表见 ***文档），常用配置如下：

7. 参考与支持

• ***文档：标签、环境变量及完整配置说明
• 问题反馈：通过 Slack 渠道 联系开发团队
• 构建状态：WebDevOps Build Server