mwalbeck/composer Docker镜像文档

1. 镜像概述和主要用途

mwalbeck/composer 是一个容器化的 Composer 运行环境，用于 PHP 项目的依赖管理。该镜像将 Composer 工具封装为 Docker 容器，无需在本地系统直接安装 Composer，即可通过容器化方式执行依赖安装、更新、版本控制等操作，确保开发环境与生产环境的一致性。

2. 核心功能和特性

2.1 功能概述

• 完整支持 Composer 官方功能，包括 install、update、require、dump-autoload 等核心命令。
• 容器化运行，避免本地环境依赖冲突，简化多项目 Composer 版本管理。

2.2 关键特性

• 轻量级设计：基于精简基础镜像构建，减少资源占用。
• 多平台支持：兼容常见架构（如 amd64、arm64，具体以 Docker Hub 镜像标签为准）。
• 灵活的数据持久化：支持通过卷挂载（Volume）保存 vendor 目录、composer.json/composer.lock 文件及缓存数据。
• 权限适配：可通过环境变量自定义运行用户 ID/组 ID，避免容器内文件权限与宿主机冲突。

3. 使用场景和适用范围

3.1 适用场景

• PHP 项目开发：本地开发时快速安装/更新依赖，无需手动配置 Composer 环境。
• CI/CD 流水线：在自动化构建流程中集成依赖安装步骤，确保构建环境一致性。
• 多版本管理：通过指定镜像标签（如 :2.5.5），为不同项目匹配特定 Composer 版本。
• 服务器环境部署：生产或测试环境中通过容器化方式安装项目依赖，避免系统级工具污染。

3.2 适用人群/团队

• PHP 开发工程师
• 自动化运维团队（CI/CD 流程设计）
• 需要跨环境统一依赖管理的团队

4. 使用方法和配置说明

4.1 基础使用（docker run 命令）

4.1.1 安装项目依赖

在 PHP 项目根目录（包含 composer.json）执行以下命令，安装依赖至 vendor 目录：

docker run --rm -v $(pwd):/app mwalbeck/composer install

• --rm：命令执行后自动删除容器，避免残留。
• -v $(pwd):/app：将当前目录（宿主机项目根目录）挂载至容器内 /app 工作目录。

4.1.2 更新依赖

更新项目依赖至最新版本（依据 composer.json 约束）：

docker run --rm -v $(pwd):/app mwalbeck/composer update

4.1.3 执行自定义命令

直接传递 Composer 命令参数，例如查看版本或添加依赖：

# 查看 Composer 版本
docker run --rm mwalbeck/composer --version

# 添加依赖包（如 monolog/monolog）
docker run --rm -v $(pwd):/app mwalbeck/composer require monolog/monolog

4.2 Docker Compose 配置示例

在 docker-compose.yml 中集成 Composer 服务，适用于多服务项目（如 PHP + Nginx + 数据库）：

version: '3.8'

services:
  composer:
    image: mwalbeck/composer
    volumes:
      # 挂载项目目录至容器工作目录
      - ./php-project:/app
      # 持久化 Composer 缓存（可选，加速重复依赖安装）
      - composer_cache:/root/.composer/cache
    environment:
      # 国内用户可配置镜像源加速下载（如阿里云 Composer 镜像）
      - COMPOSER_MIRROR_URL=[***]
      # 自定义用户 ID/组 ID（解决宿主机文件权限问题，需与宿主机用户一致）
      - USER_ID=1000
      - GROUP_ID=1000

volumes:
  # 定义缓存卷（自动创建，无需手动初始化）
  composer_cache:

使用方式：在 docker-compose.yml 所在目录执行：

# 安装依赖
docker-compose run --rm composer install

# 更新依赖
docker-compose run --rm composer update

4.3 配置参数与环境变量

4.3.1 核心环境变量

4.3.2 数据卷挂载说明

5. 问题反馈与支持

若使用中遇到问题，可通过以下渠道反馈：

• 项目代码仓库：GitLab 或 GitHub
• Docker Hub 镜像页面：mwalbeck/composer