** 注意：这是 composer 镜像 的 arm32v7 架构构建的“每个架构”仓库——更多信息，请参见镜像文档中的“除 amd64 之外的架构？”和*镜像常见问题中的“镜像的源代码在 Git 中已更改，现在该怎么办？”。

快速参考

-** 维护者：**Rob Bast，以及社区的贡献者。

-** 获取帮助：**Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• 2.8.12, 2.8, 2, latest

• 2.2.25, 2.2

• 1.10.27, 1.10, 1

快速参考（续）

-** 问题提交地址：[*]

-** 支持的架构：**(更多信息)
amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

-** 已发布镜像 artifact 详情：**repo-info 仓库的 repos/composer/ 目录（历史记录）
（镜像元数据、传输大小等）

-** 镜像更新：**official-images 仓库的 library/composer 标签
official-images 仓库的 library/composer 文件（历史记录）

-** 本描述的来源：**docs 仓库的 composer/ 目录（历史记录）

什么是 Composer？

Composer 是一个用 PHP 编写的 PHP 依赖管理工具。它允许你声明项目所依赖的库，并为你管理（安装/更新）这些库。

你可以在我们的***文档中了解更多关于 Composer 的信息。

!logo

如何使用此镜像

基本用法

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  arm32v7/composer <命令>

持久化缓存 / 全局配置

你可以将主机的 Composer 主目录绑定挂载到容器中，以启用持久化缓存或共享全局配置：

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume ${COMPOSER_HOME:-$HOME/.composer}:/tmp \
  arm32v7/composer <命令>
```** 注意：**这依赖于镜像中默认将 `COMPOSER_HOME` 值设置为 `/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 \
  arm32v7/composer <命令>

文件系统权限

默认情况下，Composer 在容器内以 root 用户运行。这可能导致主机文件系统上的权限问题。你可以通过以其他用户身份运行容器来解决此问题：

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

详见：[***]

注意：Docker for Mac 的行为有所不同，此提示可能不适用于 Docker for Mac 用户。

私有仓库 / SSH 代理

当你需要访问私有仓库时，你需要共享已配置的凭据，或在运行的容器内挂载你的 ssh-agent 套接字：

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 \
  arm32v7/composer <命令>
```** 注意：**在 OSX 上，这需要 Docker For Mac v2.2.0.0 或更高版本，详见 docker/for-mac#410。

当结合使用私有仓库和以其他用户身份运行 Composer 时，可能会遇到不存在的用户错误（由 ssh 抛出）。要解决此问题，将主机的 passwd 和 group 文件（只读）绑定挂载到容器中：

```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) \
  arm32v7/composer <命令>

故障排除

PHP 版本 & 扩展

我们的镜像旨在快速运行 Composer，无需在主机上安装 PHP 运行时。你不应依赖容器中的 PHP 版本。我们不提供每个受支持 PHP 版本的 Composer 镜像，因为我们不鼓励将 Composer 用作基础镜像或生产镜像。

我们尝试提供尽可能精简的镜像，专为运行 Composer 而构建。有时依赖项或 Composer 脚本需要特定 PHP 扩展的支持。

建议：

-（最佳）创建你自己的构建镜像并安装 Composer。** 注意：**Docker 17.05 引入了多阶段构建，极大简化了此过程：

dockerfile
COPY --from=arm32v7/composer /usr/bin/composer /usr/bin/composer

-（替代方案）在你的 composer.json 中指定目标平台 / 扩展：

json
{
  "config": {
    "platform": {
      "php": "MAJOR.MINOR.PATCH",
      "ext-something": "MAJOR.MINOR.PATCH"
    }
  }
}

-（不推荐）向 install 或 update 传递 --ignore-platform-reqs 和/或 --no-scripts 标志：

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

许可

查看此镜像中包含的软件的许可信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可（例如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可信息可能位于 repo-info 仓库的 composer/ 目录中。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可。