bearstech/php-composer

bearstech/php-composer 镜像文档

镜像概述

bearstech/php-composer是基于Debian维护的PHP版本及Sury滚动版本构建的Composer镜像，旨在为PHP项目提供便捷的依赖管理和构建环境。该镜像支持多种PHP版本，适用于项目构建阶段的依赖安装，可与运行时镜像配合实现多阶段构建，减小最终应用镜像体积。

核心功能与特性

• 多PHP版本支持：包含以下PHP版本：
  • 7.3（基于Debian buster）
  • 7.4（基于Debian bullseye）
  • 8.2（基于Debian bookworm）
  • 8.1-rr（基于Debian bullseye + Sury滚动更新源）
• 基于稳定基础：核心PHP版本基于Debian官方维护版本，确保稳定性和安全性
• 滚动更新支持：提供8.1-rr版本，基于Sury源获取滚动更新，适合需要最新特性的场景
• 轻量构建环境：专注于依赖管理，适合作为多阶段构建中的构建阶段使用

使用场景

• PHP项目的依赖安装与管理
• CI/CD流程中的构建阶段，用于安装Composer依赖
• 多阶段构建中分离构建环境与运行环境，优化最终镜像大小
• 需要特定PHP版本的项目构建需求

使用方法与配置说明

基本使用示例（多阶段构建）

以下示例展示如何使用该镜像作为构建阶段，安装PHP依赖后复制到运行时镜像：

dockerfile
# 构建阶段：使用bearstech/php-composer安装依赖
FROM bearstech/php-composer:8.2 as php-builder
COPY ./composer.json /opt/
RUN composer install -q -d /opt  # 静默安装依赖

# 运行阶段：使用基础PHP镜像
FROM bearstech/php:8.2
ARG uid=1001  # 可通过--build-arg指定用户ID，默认为1001
RUN useradd php-worker --uid ${uid}  # 创建非root用户
WORKDIR /var/www  # 设置工作目录
COPY --from=php-builder /opt /var/www  # 从构建阶段复制依赖
USER php-worker  # 切换到非root用户运行

参数说明

• 构建参数：
  • uid：指定运行时用户的UID，默认为1001，可通过--build-arg uid=自定义ID修改，用于解决文件权限问题

版本选择

根据项目需求选择对应的镜像标签：

• 7.3：PHP 7.3（Debian buster）
• 7.4：PHP 7.4（Debian bullseye）
• 8.2：PHP 8.2（Debian bookworm）
• 8.1-rr：PHP 8.1（Debian bullseye + Sury滚动更新）