ngyuki/php-dev Docker镜像文档

镜像概述和主要用途

ngyuki/php-dev 是基于*** php:alpine 镜像构建的 PHP 应用开发专用 Docker 镜像。该镜像集成了 PHP 开发过程中常用的扩展、系统命令工具及 PHAR 工具，旨在简化 PHP 应用的本地开发、测试与调试流程。

核心功能和特性

基础镜像

• 基于*** php:alpine 镜像构建，保持轻量级特性。

内置 PHP 扩展

以下 PHP 扩展已预安装，除特别说明外均默认启用：

• apcu
• ast
• gd
• opcache
• pcntl
• pdo_mysql
• sockets
• zip
• xdebug（默认禁用，需手动启用）

内置系统命令工具

• bash
• git
• jq
• mysql（客户端工具）
• rsync
• ssh
• unzip

内置 PHAR 工具

• composer（PHP 依赖管理工具）
• phan（PHP 静态代码分析工具）
• php-cs-fixer（PHP 代码风格修复工具）
• phpunit（PHP 单元测试框架）

使用场景和适用范围

• PHP 应用本地开发环境搭建
• 单元测试执行（基于 phpunit）
• 代码静态分析（基于 phan）
• 代码风格检查与修复（基于 php-cs-fixer）
• PHP 依赖管理（基于 composer）
• PHP 代码调试（基于 xdebug）

使用方法和配置说明

基本使用示例

查看 PHP 版本

docker run --rm ngyuki/php-dev php -v

查看 PHPUnit 版本

docker run --rm ngyuki/php-dev phpunit --version

执行 PHP 脚本（启用 xdebug）

docker run --rm -i ngyuki/php-dev php -d zend_extension=xdebug.so < check.php

挂载项目目录开发

将本地项目目录挂载至容器内，可直接在容器中执行项目相关命令（如依赖安装、测试等）：

# 安装项目依赖
docker run --rm -v $(pwd):/app -w /app ngyuki/php-dev composer install

# 执行单元测试
docker run --rm -v $(pwd):/app -w /app ngyuki/php-dev phpunit tests/

启用 Xdebug 扩展

Xdebug 扩展默认禁用，可通过以下方式临时启用：

1. 通过 php 命令参数启用：

   docker run --rm ngyuki/php-dev php -d zend_extension=xdebug.so -m | grep xdebug
   

2. 通过容器内命令永久启用（需进入容器）：

   docker run -it --rm ngyuki/php-dev bash
   # 在容器内执行
   docker-php-ext-enable xdebug
   php -m | grep xdebug  # 验证是否启用
   

Docker Compose 配置示例

创建 docker-compose.yml 文件，快速集成到开发环境：

version: '3'
services:
  php-dev:
    image: ngyuki/php-dev
    volumes:
      - ./:/app  # 挂载本地项目目录至容器内 /app
    working_dir: /app  # 设置工作目录为 /app
    # 可根据需求添加其他配置（如环境变量、端口映射等）

启动并进入容器：

docker-compose run --rm php-dev bash

注意事项

• 除 xdebug 外，所有 PHP 扩展默认已启用，无需额外配置。
• 镜像基于 alpine 系统，体积轻量，适合本地开发场景，不建议用于生产环境。
• 如需持久化配置，可通过挂载自定义 php.ini 文件（如 -v $(pwd)/php.ini:/usr/local/etc/php/php.ini）覆盖默认配置。