riscv64/composer

注意：这是 https://hub.docker.com/_/composer 的 riscv64 架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F FAQ 中的“https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

• 维护者：
  https://github.com/alcohol%EF%BC%8C%E4%BB%A5%E5%8F%8A%E6%9D%A5%E8%87%AA%E7%A4%BE%E5%8C%BA%E7%9A%84 https://github.com/composer/docker/graphs/contributors%E3%80%82

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

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

• https://github.com/composer/docker/blob/c457fac36cd2031d5c1149bfc99ef3454471bb61/latest/Dockerfile

• https://github.com/composer/docker/blob/***ef602775671bbaa43b4ade138a7c853fe3d/2.2/Dockerfile

快速参考（续）

• 提交 issue 的位置：
  https://github.com/composer/docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/composer/%E3%80%81https://hub.docker.com/r/arm32v6/composer/%E3%80%81https://hub.docker.com/r/arm32v7/composer/%E3%80%81https://hub.docker.com/r/arm64v8/composer/%E3%80%81https://hub.docker.com/r/i386/composer/%E3%80%81https://hub.docker.com/r/ppc64le/composer/%E3%80%81https://hub.docker.com/r/riscv64/composer/%E3%80%81https://hub.docker.com/r/s390x/composer/

• 已发布镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/composer%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/composer%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fcomposer
  https://github.com/docker-library/official-images/blob/master/library/composer%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/composer%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/composer%EF%BC%88https://github.com/docker-library/docs/commits/master/composer%EF%BC%89

什么是 Composer？

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

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

!https://raw.githubusercontent.com/docker-library/docs/58f7363e6cfa78f8cd54af16eab51c63c***/composer/logo.png

如何使用此镜像

基本用法

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

持久化缓存 / 全局配置

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

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume ${COMPOSER_HOME:-$HOME/.composer}:/tmp \
  riscv64/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 \
  riscv64/composer <command>

文件系统权限

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

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --user $(id -u):$(id -g) \
  riscv64/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 \
  riscv64/composer <command>

注意：在 OSX 上，这需要 Docker For Mac v2.2.0.0 或更高版本，详见 https://github.com/docker/for-mac/issues/410%E3%80%82

当结合使用私有仓库和以其他用户身份运行 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) \
  riscv64/composer <command>

故障排除

PHP 版本和扩展

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

我们努力提供尽可能精简的镜像，仅用于运行 Composer。有时依赖项或 Composer 脚本 需要特定 PHP 扩展的支持。

建议：

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

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

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

许可

查看此镜像中包含的软件的https://github.com/composer/composer/blob/master/LICENSE%E3%80%82

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

一些能够自动检测到的其他许可信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/composer 中。

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