s390x/composer

Composer是用PHP编写的PHP依赖管理器。

0 次下载actives390x镜像

🚀轩辕镜像专业版更稳定💎一键安装 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 版本或扩展，建议：

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

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

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

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

不推荐：使用 --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 目录（历史记录）