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）：

bash
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 等）：

bash
# 运行当前目录下的 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应用：

bash
# 映射当前目录到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 示例：

yaml
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服务：

nginx
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;
    }
}

启动服务：