forumone/composer

Composer 镜像（预安装 Prestissimo）

镜像概述和主要用途

本镜像为 Docker Hub 官方 https://hub.docker.com/_/composer 镜像的并行实现，基于 PHP 7.4 构建，旨在解决官方镜像因基于 PHP 8 导致的依赖解析问题。主要用途是为需要 PHP 7.4 环境的项目提供稳定的 Composer 运行环境，支持依赖管理、包安装等标准 Composer 功能。

核心功能和特性

• PHP 7.4 基础环境：基于 PHP 7.4 构建，避免官方 PHP 8 镜像与部分项目的依赖兼容性问题。
• Prestissimo 预安装：Composer 1.10 版本镜像内置 hirak/prestissimo（Composer 并行下载插件），可显著提升依赖包下载速度。
• 多版本支持：提供多个 Composer 版本标签，满足不同项目的版本需求。

支持的标签和版本

当前构建并提供以下 Composer 版本标签：

使用场景和适用范围

• PHP 7.4 依赖项目：需在 PHP 7.4 环境中运行 Composer 的 legacy 项目（如无法升级至 PHP 8 的应用）。
• 依赖配置：使用 Composer 1.10 版本时，通过内置 Prestissimo 加速依赖包并行下载，提升构建效率。
• 稳定环境需求：CI/CD 流程、本地开发环境等需固定 Composer 版本和 PHP 版本的场景。

使用方法和配置说明

基础使用（docker run）

通过 docker run 命令直接运行 Composer 命令，需挂载项目目录至容器内工作目录（推荐 /app）。

示例 1：安装项目依赖（使用最新版 Composer 2.x）

bash
docker run --rm \
  -v $(pwd):/app \  # 挂载当前目录至容器内 /app
  -w /app \          # 设置工作目录为 /app
  forumone/composer:latest \
  install            # Composer 命令（如 install/update/require 等）

示例 2：使用 Composer 1.10 并访问（含 Prestissimo）

bash
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  forumone/composer:1.10 \
  install  # 自动启用 Prestissimo 并行下载

Docker Compose 配置

在 docker-compose.yml 中集成此镜像，适用于项目级依赖管理。

示例 docker-compose.yml：

yaml
version: '3.8'

services:
  composer:
    image: forumone/composer:latest
    volumes:
      - ./:/app  # 挂载项目目录至容器 /app
    working_dir: /app
    # 可通过 command 指定 Composer 命令，或在运行时覆盖
    command: install

运行命令：

bash
docker-compose run --rm composer  # 执行 command 中定义的命令（如 install）
# 或覆盖命令：
docker-compose run --rm composer update

配置说明

• 数据持久化：通过 -v $(pwd):/app 挂载本地项目目录，确保 Composer 操作（如 composer install）影响本地文件。
• 工作目录：建议通过 -w /app 或 working_dir: /app 指定工作目录，与挂载目录保持一致。
• 环境变量：支持 Composer 标准环境变量（如 COMPOSER_HOME、COMPOSER_CACHE_DIR 等），可通过 -e 参数或 environment 配置传递，例如：

  bash
  docker run --rm -v $(pwd):/app -w /app -e COMPOSER_CACHE_DIR=/app/.composer-cache forumone/composer:latest install
  

许可证

本项目采用 MIT 许可证，与 https://github.com/composer/docker 一致。详见 https://github.com/forumone/docker-composer/blob/main/LICENSE%E3%80%82

源代码

镜像构建代码托管于 GitHub：https://github.com/forumone/docker-composer%E3%80%82