s390x/composer Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Composer Docker镜像文档

镜像概述和主要用途

注意：本仓库是 composer 官方镜像 的 s390x 架构专属构建版本。更多信息请参见官方镜像文档中的 "除 amd64 外的架构？" 和官方镜像FAQ中的 "镜像源在Git中变更后如何处理？"。

Composer 是一款用 PHP 编写的 PHP 依赖管理工具。它允许用户声明项目依赖的库，并自动完成这些依赖的安装与更新。本 Docker 镜像提供了 Composer 的容器化运行环境，适用于 s390x 架构，旨在简化 PHP 项目的依赖管理流程。

核心功能和特性

• 依赖管理：声明项目所需的 PHP 库，并自动解析、安装和更新依赖
• 版本控制：支持指定依赖版本范围，确保项目依赖的版本一致性
• 自动加载：生成符合 PSR 标准的自动加载文件，简化项目开发
• 命令行接口：提供丰富的命令集（如 install、update、require 等），满足依赖管理需求
• 缓存机制：支持依赖缓存，加速重复安装过程
• 多架构支持：本镜像针对 s390x 架构优化，同时官方镜像支持多种架构（如 amd64、arm64v8 等）

使用场景和适用范围

• PHP 项目初始化：快速安装新项目的依赖库
• 开发环境依赖更新：在不污染本地 PHP 环境的情况下更新依赖
• CI/CD 流程集成：作为构建流程的一部分，自动安装项目依赖
• 多环境一致性保障：确保开发、测试、生产环境使用相同版本的依赖
• 临时依赖管理：无需在本地安装 Composer，直接通过容器执行单次依赖操作

支持的标签及对应Dockerfile链接

• 2.8.12, 2.8, 2, latest
• 2.2.25, 2.2
• 1.10.27, 1.10, 1

使用方法和配置说明

基本使用

通过以下命令在当前项目中运行 Composer 命令：

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  s390x/composer <command>

参数说明：

• --rm：命令执行后自动删除容器
• --interactive --tty：提供交互终端，支持命令行输入
• --volume $PWD:/app：将当前目录挂载到容器内的 /app 目录（Composer 工作目录）
• <command>：替换为实际的 Composer 命令（如 install、update、require）

持久化缓存与全局配置

绑定挂载 Composer 主目录可实现缓存持久化和全局配置共享：

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume ${COMPOSER_HOME:-$HOME/.composer}:/tmp \
  s390x/composer <command>

说明：容器内默认将 COMPOSER_HOME 设置为 /tmp，因此挂载主机的 Composer 目录（默认为 $HOME/.composer）到 /tmp 即可共享缓存和配置。

若环境遵循 XDG 规范，可使用以下命令：

console
$ docker run --rm --interactive --tty \
  --env COMPOSER_HOME \
  --env COMPOSER_CACHE_DIR \
  --volume ${COMPOSER_HOME:-$HOME/.config/composer}:$COMPOSER_HOME \
  --volume ${COMPOSER_CACHE_DIR:-$HOME/.cache/composer}:$COMPOSER_CACHE_DIR \
  --volume $PWD:/app \
  s390x/composer <command>

环境变量说明：

• COMPOSER_HOME：Composer 全局配置目录
• COMPOSER_CACHE_DIR：依赖缓存目录

文件系统权限

默认情况下，Composer 在容器内以 root 用户运行，可能导致主机文件系统权限问题。可通过 --user 参数指定运行用户：

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --user $(id -u):$(id -g) \
  s390x/composer <command>

说明：$(id -u):$(id -g) 会获取当前用户的 UID 和 GID，确保容器内操作使用与主机相同的权限。（注意：Docker for Mac 可能无需此配置）

私有仓库与SSH代理

访问私有仓库时，需挂载 SSH 代理套接字以共享主机的 SSH 凭据：

console
$ eval $(ssh-agent); \
  docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume $SSH_AUTH_SOCK:/ssh-auth.sock \
  --env SSH_AUTH_SOCK=/ssh-auth.sock \
  s390x/composer <command>

说明：

• eval $(ssh-agent)：启动 SSH 代理并设置环境变量
• --volume $SSH_AUTH_SOCK:/ssh-auth.sock：挂载 SSH 代理套接字
• --env SSH_AUTH_SOCK=/ssh-auth.sock：告知容器 SSH 代理路径

注意：macOS 用户需使用 Docker For Mac v2.2.0.0 或更高版本（参见 docker/for-mac#410）。

若同时指定非 root 用户运行，需挂载主机的 passwd 和 group 文件以避免 SSH 用户不存在错误：

console
$ eval $(ssh-agent); \
  docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume $SSH_AUTH_SOCK:/ssh-auth.sock \
  --volume /etc/passwd:/etc/passwd:ro \
  --volume /etc/group:/etc/group:ro \
  --env SSH_AUTH_SOCK=/ssh-auth.sock \
  --user $(id -u):$(id -g) \
  s390x/composer <command>

Docker Compose 配置示例

创建 docker-compose.yml 文件简化调用：

yaml
version: '3'
services:
  composer:
    image: s390x/composer:latest
    volumes:
      - ./:/app
      - ${COMPOSER_HOME:-$HOME/.composer}:/tmp
    environment:
      - SSH_AUTH_SOCK=/ssh-auth.sock
    volumes_from:
      - service:ssh-agent:ro

  ssh-agent:
    image: ssh-agent
    command: sh -c 'eval $$(ssh-agent) && touch /tmp/ssh-agent.pid && while [ -f /tmp/ssh-agent.pid ]; do sleep 1; done'
    volumes:
      - $SSH_AUTH_SOCK:/ssh-auth.sock

使用方法：运行 docker-compose run composer <command> 执行 Composer 命令。

故障排除

PHP 版本与扩展问题

本镜像旨在提供轻量级的 Composer 运行环境，不保证包含所有 PHP 扩展。若依赖或脚本需要特定 PHP 版本或扩展，建议：

1. 推荐：创建自定义构建镜像，通过多阶段构建集成 Composer：

   dockerfile
   FROM php:8.2-cli
   COPY --from=s390x/composer /usr/bin/composer /usr/bin/composer
   # 安装所需扩展
   

2. 在 composer.json 中声明目标平台或扩展：

   json
   {
     "config": {
       "platform": {
         "php": "7.4.33",
         "ext-json": "1.7.0"
       }
     }
   }
   

3. 不推荐：使用 --ignore-platform-reqs 或 --no-scripts 忽略平台检查（可能导致依赖不兼容）：

   console
   $ docker run --rm --interactive --tty \
     --volume $PWD:/app \
     s390x/composer install --ignore-platform-reqs --no-scripts
   

许可证信息

镜像中包含的 Composer 软件许可信息参见 Composer 许可证。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础系统的 Bash 等），其许可可能不同。更多自动检测的许可信息可参见 repo-info 仓库的 composer 目录。

使用本镜像时，用户需自行确保符合所有包含软件的许可要求。

参考信息

• 维护者：Rob Bast，社区贡献参见 贡献者列表
• 获取帮助：Docker 社区 Slack、Server Fault、Unix & Linux、Stack Overflow
• 提交 issue：[***]
• 支持的架构：amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x（本镜像为 s390x 架构版本）
• 镜像元数据：repo-info 仓库的 composer 目录（包含镜像元数据、传输大小等）
• 镜像更新：official-images 仓库的 library/composer 标签、更新历史
• 文档来源：docs 仓库的 composer 目录（历史记录）