Composer Docker镜像（ppc64le架构）

镜像概述和主要用途

本镜像是Composer官方镜像的ppc64le架构专用版本。Composer是PHP的依赖管理工具，允许您声明项目所依赖的库，并自动管理（安装/更新）这些依赖项。使用Docker镜像可以快速运行Composer，无需在主机上安装PHP运行时环境。

核心功能和特性

• 提供Composer的最新稳定版本，支持多版本标签
• 无需在主机安装PHP环境即可运行Composer
• 支持持久化缓存和全局配置
• 可配置文件系统权限，避免权限问题
• 支持访问私有仓库和SSH代理集成
• 轻量级设计，专注于Composer功能

支持的标签和对应的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

使用场景和适用范围

• PHP项目的依赖管理
• CI/CD流程中集成Composer安装依赖步骤
• 多环境开发中的依赖版本一致性保障
• 需要快速部署Composer环境的场景
• 避免在主机系统安装PHP和Composer的场景

详细的使用方法和配置说明

基本用法

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

持久化缓存/全局配置

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

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

注意： 这依赖于镜像中默认将COMPOSER_HOME值设置为/tmp的事实。

如果您的环境遵循XDG规范：

$ 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 \
  ppc64le/composer <command>

文件系统权限

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

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

详情请参见：[***]

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

私有仓库/SSH代理

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

$ 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 \
  ppc64le/composer <command>

注意： 在OSX上，这需要Docker For Mac v2.2.0.0或更高版本，详见docker/for-mac#410。

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

$ 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) \
  ppc64le/composer <command>

docker-compose配置示例

创建docker-compose.yml文件：

version: '3'

services:
  composer:
    image: ppc64le/composer:latest
    volumes:
      - .:/app
      - ${COMPOSER_HOME:-$HOME/.composer}:/tmp
      - $SSH_AUTH_SOCK:/ssh-auth.sock
    environment:
      - SSH_AUTH_SOCK=/ssh-auth.sock
    user: ${UID:-1000}:${GID:-1000}

使用方法：

$ docker-compose run --rm composer install

故障排除

PHP版本和扩展

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

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

解决建议：

• （最佳方案）创建自己的构建镜像并安装Composer。

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

  COPY --from=ppc64le/composer /usr/bin/composer /usr/bin/composer
  

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

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

• （不推荐）在install或update命令中传递--ignore-platform-reqs和/或--no-scripts标志：

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

快速参考

• 维护者： Rob Bast，以及社区贡献者
• 获取帮助： Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow
• 提交问题： [***]
• 镜像更新： official-images repo的library/composer标签
• 镜像详情： repo-info仓库的repos/composer/目录（包含镜像元数据、传输大小等）

许可证

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

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

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

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