注意： 这是composer镜像的arm32v6架构专用仓库——更多信息，请参见镜像文档中的"非amd64架构？"和***镜像FAQ中的"镜像源在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

• 已发布镜像工件详情：
  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 \
  arm32v6/composer <command>

持久化缓存/全局配置

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

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

注意： 这依赖于镜像中默认将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 \
  arm32v6/composer <command>

文件系统权限

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

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

详见：[***]

注意：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 \
  arm32v6/composer <command>

注意： 在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) \
  arm32v6/composer <command>

故障排除

PHP版本和扩展

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

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

建议：

• （最佳）创建你自己的构建镜像并在其中安装Composer。

  注意： Docker 17.05引入了多阶段构建，极大地简化了这一过程：

  dockerfile
  COPY --from=arm32v6/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 \
    arm32v6/composer install --ignore-platform-reqs --no-scripts
  

许可

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

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

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

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