shin1x1/php-dev：PHP开发环境Docker镜像

一、镜像概述和主要用途

概述

shin1x1/php-dev 是用于PHP应用开发环境的Docker镜像，旨在提供便捷、可定制的本地开发环境，支持多种PHP版本和服务器API（SAPI），内置常用扩展及调试工具，简化开发流程。

主要用途

• 快速搭建PHP开发环境，无需本地安装PHP及依赖
• 支持多版本PHP开发与兼容性测试
• 提供调试（Xdebug）和性能优化（Zend OPcache）工具，满足开发阶段需求

二、核心功能和特性

1. 支持的PHP SAPI

提供三种服务器API（SAPI），适配不同开发场景：

• cli：命令行接口，用于运行PHP脚本（如定时任务、脚本工具）
• apache：集成Apache Web服务器，直接提供HTTP服务
• fpm：FastCGI进程管理器，需配合Nginx等Web服务器使用

2. 支持的PHP版本

覆盖主流PHP版本，满足不同项目需求：

• 7系列：7、7.1、7.1.x、7.2、7.2.x、7.3、7.3.x、7.4、7.4.x
• 8系列：8.0、8.0.x、8.1、8.1.x、8.2、8.2.x、8.3、8.3.x、8.4、8.4.x

3. 内置扩展

预装开发常用扩展，无需手动配置，包括：

[PHP Modules]
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gd
hash
iconv
json
libxml
mbstring
mysqlnd
openssl
pcre
PDO
pdo_mysql
pdo_pgsql
pdo_sqlite
pgsql
Phar
posix
readline
redis
Reflection
session
SimpleXML
sodium
SPL
sqlite3
standard
tokenizer
xdebug
xml
xmlreader
xmlwriter
Zend OPcache
zip
zlib

[Zend Modules]
Xdebug
Zend OPcache

三、使用场景和适用范围

使用场景

• 本地PHP开发：替代本地PHP环境安装，通过容器隔离不同项目依赖
• 多版本兼容性测试：快速切换PHP版本，验证项目在不同版本下的运行情况
• 团队协作开发：统一开发环境配置，避免“本地能跑，线上报错”问题
• 调试与性能优化：内置Xdebug支持断点调试，Zend OPcache提升脚本执行效率

适用范围

• PHP脚本开发（CLI模式）
• Web应用开发（Apache或FPM模式）
• 需要Xdebug调试或Zend OPcache优化的开发场景
• 支持MySQL、PostgreSQL、SQLite等数据库的PHP应用

四、使用方法和配置说明

1. 获取镜像

从Docker Hub拉取镜像，标签格式为 <PHP版本>-<SAPI>（如 8.3-cli、7.4-apache）：

docker pull shin1x1/php-dev:8.3-cli  # CLI模式，PHP 8.3
docker pull shin1x1/php-dev:7.4-apache  # Apache模式，PHP 7.4
docker pull shin1x1/php-dev:8.2-fpm  # FPM模式，PHP 8.2

2. 运行容器示例

2.1 CLI模式（命令行脚本）

用于执行PHP命令行脚本（如 artisan、composer 等）：

# 运行当前目录下的 script.php
docker run --rm -v $(pwd):/app shin1x1/php-dev:8.3-cli php /app/script.php

# 安装Composer依赖（需映射composer缓存目录）
docker run --rm -v $(pwd):/app -v ~/.composer:/root/.composer shin1x1/php-dev:8.3-cli composer install

2.2 Apache模式（Web服务）

直接启动Apache服务器，映射端口访问Web应用：

# 映射当前目录到Apache默认站点目录/var/www/html，暴露8080端口
docker run -d -p 8080:80 -v $(pwd):/var/www/html --name php-apache shin1x1/php-dev:8.3-apache

访问 http://localhost:8080 即可查看应用。

2.3 FPM模式（配合Nginx）

FPM需与Nginx等Web服务器配合使用，以下为 docker-compose.yml 示例：

version: '3'
services:
  php-fpm:
    image: shin1x1/php-dev:8.3-fpm
    volumes:
      - ./src:/var/www/html  # 映射代码目录
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d  # 自定义PHP配置目录（可选）

  nginx:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./src:/var/www/html  # 共享代码目录
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  # Nginx配置
    depends_on:
      - php-fpm

Nginx配置文件 nginx.conf 需指向FPM服务：

server {
    listen 80;
    root /var/www/html;
    index index.php index.html;

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;  # 指向php-fpm服务
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

启动服务：

docker-compose up -d

3. 自定义配置（可选）

如需修改PHP配置（如 php.ini 参数），可通过以下方式：

• 挂载自定义配置文件到容器的 /usr/local/etc/php/conf.d/ 目录（FPM/Apache模式）
• 运行时通过环境变量注入（如 PHP_OPCACHE_ENABLE=1，具体变量需参考PHP***配置）

五、内置扩展说明

镜像默认启用以下关键扩展，满足开发需求：

• Xdebug：调试工具，支持断点调试、性能分析
• Zend OPcache：代码缓存，提升PHP执行性能
• PDO及数据库扩展：支持MySQL（pdo_mysql）、PostgreSQL（pdo_pgsql）、SQLite（pdo_sqlite）
• Redis：缓存/消息队列扩展
• GD：图像处理扩展
• Zip：压缩/解压文件支持
• cURL：HTTP请求支持

完整扩展列表见“核心功能和特性”章节。