sykescottages/php

Sykes Cottages PHP Docker镜像

概述

Sykes Cottages在多数平台中使用多种PHP容器，因应用存在大量定制化需求，使用官方PHP镜像通常需要复杂的Dockerfile来支持应用。本系列PHP镜像均基于https://github.com/SykesCottages/docker-base%EF%BC%88%E5%9F%BA%E4%BA%8E%E5%AE%98%E6%96%B9Ubuntu Docker镜像）构建，通过aptitude包管理器简化包管理，并利用其提供的包完整性验证功能。

核心功能与特性

• 基于Ubuntu与aptitude：采用官方Ubuntu镜像作为基础，使用aptitude进行包管理，便于维护和验证包完整性
• 多PHP版本支持：提供从PHP 5.6到8.3的多个版本，包含CLI（命令行）和FPM（FastCGI进程管理器）两种变体
• 内置Composer：默认预装Composer 1，避免遗留Composer构建失败
• 预安装常用扩展：除基础镜像外，所有镜像预安装bcmath、curl、dev、intl、json、mbstring、mysql、soap、xml、zip等扩展
• 包可见性提升：每个标签包含aptitude itinerary，位于对应标签文件夹中，清晰展示包版本变化并反映在Git历史中
• 灵活的扩展管理：支持通过aptitude安装或移除PHP扩展

使用场景与适用范围

适用于Sykes Cottages内部平台及需要定制化PHP环境的应用，尤其适合存在遗留Composer构建需求、需管理特定PHP版本或扩展的场景。支持从5.6到8.3的PHP版本（部分已弃用或有明确生命周期结束时间），满足不同阶段项目需求。

使用方法

拉取镜像

bash
docker pull sykescottages/php:version

运行容器

bash
docker run -i -t sykescottages/php:version

构建镜像

在Dockerfile中引用本镜像进行构建：

dockerfile
FROM sykescottages/php:version

# ... 你的定制配置

Composer配置

所有镜像预装Composer，但默认使用版本1以兼容遗留构建。如需更换版本，需扩展镜像并创建多阶段构建Dockerfile，示例：

dockerfile
FROM sykescottages/php:7.4-cli
COPY --from=composer /usr/bin/composer /usr/bin/composer

支持的版本和标签

• 5.6.40 cli（已弃用） - sykescottages/php:5.6-cli
• 5.6.40 fpm（已弃用） - sykescottages/php:5.6-fpm
• 7.0.33 cli（已弃用） - sykescottages/php:7.0-cli
• 7.0.33 fpm（已弃用） - sykescottages/php:7.0-fpm
• 7.1.33 cli（已弃用） - sykescottages/php:7.1-cli
• 7.1.33 fpm（已弃用） - sykescottages/php:7.1-fpm
• 7.2.34 cli（已弃用） - sykescottages/php:7.2-cli
• 7.2.34 fpm（已弃用） - sykescottages/php:7.2-fpm
• 7.3.33 cli（已弃用） - sykescottages/php:7.3-cli
• 7.3.33 fpm（已弃用） - sykescottages/php:7.3-fpm
• 7.4.33 cli（已弃用） - sykescottages/php:7.4-cli
• 7.4.33 fpm（已弃用） - sykescottages/php:7.4-fpm
• 8.0.30 cli（已弃用） - sykescottages/php:8.0-cli
• 8.0.30 fpm（已弃用） - sykescottages/php:8.0-fpm
• 8.1.25 cli（生命周期结束时间：2024-11-25） - sykescottages/php:8.1-cli
• 8.1.25 fpm（生命周期结束时间：2024-11-25） - sykescottages/php:8.1-fpm
• 8.2.12（生命周期结束时间：2025-12-08） - sykescottages/php:8.2-cli
• 8.2.12（生命周期结束时间：2025-12-08） - sykescottages/php:8.2-fpm
• 8.3.0RC5（发布候选版） - sykescottages/php:8.3-cli
• 8.3.0RC5（发布候选版） - sykescottages/php:8.3-fpm

镜像包信息

每个标签包含aptitude itinerary，位于对应标签的文件夹中，用于清晰展示包版本变化并在Git历史中反映。

测试

所有测试通过SUT（系统测试）容器进行，由Docker Hub运行（详见自动化仓库测试），执行多种shell脚本验证功能。

安装扩展

由于镜像使用ondrej仓库，可通过aptitude安装扩展，示例：

bash
# 安装需要自动确认，-q参数可选
RUN apt-get update && \
    apt-get install -y -q \
        php8.0-memcache

# 减少镜像大小的最佳实践
RUN apt-get autoremove -y -q && \
    apt-get autoclean -y -q && \
    rm -rf /var/lib/apt/lists/*

移除扩展

如需移除预安装的扩展，可在Dockerfile中添加以下命令：

bash
# 移除需要自动确认，-q参数可选
RUN apt-get remove --purge -y php8.0-mysql \
  && apt-get autoremove -y -q && \
  apt-get autoclean -y -q

贡献

欢迎贡献，但请遵循https://github.com/SykesCottages/docker-php/blob/master/CONTRIBUTION.MD%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E8%AF%B7%E7%A1%AE%E4%BF%9D%E6%AF%8F%E6%AC%A1%E4%BF%AE%E6%94%B9Dockerfile%E6%97%B6%E9%83%BD%E6%B7%BB%E5%8A%A0%E6%B5%8B%E8%AF%95%EF%BC%8C%E4%BB%A5%E9%AA%8C%E8%AF%81%E6%9B%B4%E6%94%B9%E6%98%AF%E5%90%A6%E6%9C%89%E6%95%88%E3%80%82