library/composer

Composer是PHP的依赖管理器，用于管理PHP项目的依赖。

1121 收藏0 次下载activelibrary镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Composer Docker镜像文档

1. 镜像概述

1.1 简介

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

1.2 维护者

由Rob Bast维护，社区贡献者提供支持。

2. 支持的标签和架构

2.1 可用标签

2.8.12, 2.8, 2, latest
2.2.25, 2.2
1.10.27, 1.10, 1

2.2 支持的架构

amd64
arm32v6
arm32v7
arm64v8
i386
ppc64le
riscv64
s390x

3. 核心功能和特性

声明和管理PHP项目依赖
自动解决依赖冲突
支持私有和公共代码仓库
可扩展的插件系统
支持版本约束和分支选择

4. 使用场景和适用范围

PHP项目的依赖管理
CI/CD流程中的依赖安装步骤
开发环境的依赖一致性维护
多环境部署时的依赖版本控制

5. 使用方法和配置说明

5.1 基本使用

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

5.2 持久化缓存/全局配置

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

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

5.3 文件系统权限

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

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

详情请参见: [***]

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

5.4 私有仓库/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 \
  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) \
  composer <command>

6. 故障排除

6.1 PHP版本和扩展问题

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

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

解决建议：

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

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

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

7. 部署示例

7.1 基本安装依赖

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  composer install

7.2 创建新项目

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  composer create-project laravel/laravel my-project

7.3 更新依赖

console
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  composer update

7.4 Docker Compose集成

yaml
version: '3'

services:
  composer:
    image: composer:latest
    volumes:
      - .:/app
      - ${COMPOSER_HOME:-$HOME/.composer}:/tmp
    user: ${UID:-1000}:${GID:-1000}
    command: install