PHP Docker镜像文档

镜像概述

本Docker镜像提供多种PHP版本支持，旨在为PHP应用程序提供一致、可移植的运行环境。支持的PHP版本包括当前活跃维护的8.2、8.1、8.0，以及已终止***支持（EOL）的7.4和7.3版本，满足不同应用对PHP版本的兼容性需求。

支持的PHP版本

• 活跃支持版本：8.2、8.1、8.0（接收安全更新和错误修复）
• 已终止支持版本（EOL）：7.4、7.3（不再接收***更新，仅用于遗留系统兼容）

核心功能与特性

多版本支持

提供多种PHP主版本选择，适配不同年代的PHP应用程序，便于版本迁移测试和多版本应用并行部署。

标准化运行环境

基于***基础镜像构建，确保环境一致性，减少"在我机器上能运行"的问题，简化开发到生产的部署流程。

灵活部署选项

支持多种部署模式（如CLI、FPM、Apache模块等，具体取决于镜像标签），满足不同架构需求（如独立运行、配合Nginx反向代理等）。

使用场景

开发与测试环境

• 本地开发时快速切换PHP版本，验证应用在不同版本下的兼容性
• 在CI/CD流程中集成，自动化测试多PHP版本下的应用稳定性

生产环境部署

• 为生产环境应用提供指定版本的稳定运行环境
• 配合容器编排工具（如Docker Compose、Kubernetes）实现规模化部署

遗留系统维护

• 为使用7.3/7.4等EOL版本的遗留应用提供临时运行环境，便于系统迁移过渡

使用方法与配置说明

获取镜像

通过Docker Hub或私有仓库拉取指定版本的镜像，格式如下：

docker pull [镜像仓库地址]/php:[版本标签]

示例（假设使用***命名规范）：

# 拉取PHP 8.2版本
docker pull php:8.2

# 拉取PHP 7.4（EOL）版本
docker pull php:7.4

基本运行示例

1. 运行PHP CLI

# 执行PHP脚本
docker run --rm -v $(pwd):/app php:8.2-cli php /app/script.php

# 启动交互式PHP shell
docker run -it --rm php:8.0-cli php -a

2. 运行PHP-FPM（配合Nginx）

使用Docker Compose示例（docker-compose.yml）：

version: '3'
services:
  php-fpm:
    image: php:8.1-fpm
    volumes:
      - ./php-app:/var/www/html
    restart: always

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./php-app:/var/www/html
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php-fpm

3. 运行Apache模块版本

# 启动PHP Apache服务，映射80端口
docker run -d -p 8080:80 -v $(pwd)/php-app:/var/www/html --name php-apache php:8.2-apache

版本标签说明

镜像标签通常包含PHP版本和运行模式，常见格式：

• {version}: 基础版本（通常为CLI模式）
• {version}-cli: 仅包含PHP CLI
• {version}-fpm: 包含PHP-FPM
• {version}-apache: 包含Apache Web服务器和PHP模块
• {version}-alpine: 基于Alpine Linux的轻量级版本

自定义配置

1. 挂载自定义php.ini

docker run --rm -v $(pwd)/custom-php.ini:/usr/local/etc/php/php.ini php:8.2-cli php -i | grep "Loaded Configuration File"

2. 安装额外PHP扩展

通过docker-php-ext-install命令在构建时安装扩展：

FROM php:8.2-cli
RUN docker-php-ext-install pdo_mysql mysqli

构建并使用自定义镜像：

docker build -t my-php:8.2 .
docker run --rm my-php:8.2 php -m | grep pdo_mysql

版本生命周期说明

• 活跃支持版本（8.2/8.1/8.0）：建议用于新开发项目，将持续接收安全更新和错误修复
• EOL版本（7.4/7.3）：仅推荐用于必须依赖旧版本的遗留系统，建议尽快迁移至活跃支持版本

注意事项

• EOL版本不再接收***安全更新，生产环境使用时需自行承担安全风险
• 不同版本标签可能包含不同的基础系统和扩展集，使用前请查阅具体版本的文档
• 生产环境部署时建议使用固定版本标签（如8.2.10）而非浮动标签（如8.2），确保环境一致性