ctddockerhub/php

PHP基础镜像及开发版本

镜像概述和主要用途

本镜像提供基础PHP运行环境及对应的开发版本，旨在为PHP应用的开发、测试和部署提供便捷支持。基础版本适用于生产环境运行PHP应用，开发版本则集成Composer（依赖管理）、Xdebug（调试工具）和PHPUnit（测试框架），满足开发阶段的调试、测试需求。

核心功能和特性

• 双版本设计：提供基础PHP镜像（生产环境）和开发版本镜像（集成开发工具）
• 内置开发工具：开发版本包含Composer，支持PHP依赖安装与管理
• 调试支持：开发版本集成Xdebug扩展，支持PHP代码断点调试和性能分析
• 测试框架：开发版本预装PHPUnit，支持PHP单元测试的编写与执行

使用场景和适用范围

适用场景

• 生产环境：基础版本可作为PHP应用的运行容器，提供轻量级执行环境
• 开发环境：开发版本适用于PHP应用开发，支持代码调试、依赖管理和单元测试
• CI/CD流程：开发版本可用于自动化测试环节，通过PHPUnit执行单元测试

适用范围

• 中小型PHP项目的开发与部署
• 需要调试和单元测试的PHP开发流程
• 快速搭建标准化PHP开发环境

使用方法和配置说明

拉取镜像

基础版本（示例标签为PHP 8.2）

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/php-base:8.2

开发版本（示例标签为PHP 8.2-dev）

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/php-base:8.2-dev

运行容器示例

基础版本（生产环境）

挂载PHP应用代码并运行：

bash
docker run -d -p 80:80 -v $(pwd)/app:/var/www/html docker.xuanyuan.run/[镜像仓库地址]/php-base:8.2

开发版本（开发环境）

启动带调试功能的开发容器：

bash
docker run -it --rm -p 80:80 -v $(pwd)/app:/var/www/html -e XDEBUG_MODE=debug docker.xuanyuan.run/[镜像仓库地址]/php-base:8.2-dev

工具使用示例

Composer使用

在开发容器中执行依赖安装：

bash
docker exec -it [容器ID] composer install

PHPUnit测试

在开发容器中运行单元测试：

bash
docker exec -it [容器ID] phpunit /var/www/html/tests/

Xdebug配置

通过环境变量配置Xdebug（开发版本）：

• XDEBUG_MODE：设置调试模式（可选值：debug/develop/coverage，默认off）
• XDEBUG_CLIENT_HOST：调试客户端地址（默认host.docker.internal）
• XDEBUG_CLIENT_PORT：调试客户端端口（默认9003）

示例配置：

bash
docker run -d -p 80:80 -v $(pwd)/app:/var/www/html \
  -e XDEBUG_MODE=debug \
  -e XDEBUG_CLIENT_HOST=192.168.1.100 \
  -e XDEBUG_CLIENT_PORT=9003 \
  docker.xuanyuan.run/[镜像仓库地址]/php-base:8.2-dev

docker-compose配置示例

yaml
version: '3.8'
services:
  php-dev:
    image: docker.xuanyuan.run/[镜像仓库地址]/php-base:8.2-dev
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
    environment:
      - XDEBUG_MODE=debug
      - XDEBUG_CLIENT_HOST=host.docker.internal
      - XDEBUG_CLIENT_PORT=9003
    working_dir: /var/www/html

启动服务：

bash
docker-compose up -d

注意事项

• 基础版本不含开发工具，体积较小，建议生产环境使用；开发版本因包含额外工具体积较大，仅用于开发测试
• XDEBUG_MODE默认关闭，需通过环境变量显式启用所需模式
• 建议根据应用需求选择匹配的PHP版本标签（如8.1、8.2等）