1. 简介
Composer 是 PHP 的依赖管理工具，可以自动下载、安装和更新项目所需的第三方库。
在 Docker 容器中安装 Composer 通常有两种方式：
- 使用 Shell 命令在线下载安装
- 直接从已有镜像中拷贝可执行文件
本文将介绍这两种方法的具体实现，以及如何安装指定版本的 Composer。
2. 使用 Shell 命令安装 Composer
2.1 使用 wget 安装
Dockerfile 示例：
FROM php:8.1-apache-bullseye
RUN ["/bin/bash", "-c", "apt update && apt install wget -y \
&& wget -O- https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer"]
ENTRYPOINT composer --version
该 Dockerfile：
- 使用
wget下载 Composer 安装器 - 通过管道将内容传给
php执行 - 安装到
/usr/local/bin/composer
构建并运行：
$ docker build . -t test -q && docker run test
输出：
Composer version 2.7.9 2024-09-04 14:43:28
PHP version 8.1.29 (/usr/local/bin/php)
Run the "diagnose" command to get more detailed diagnostics output.
2.2 使用 curl 安装
Dockerfile 示例：
FROM php:8.1-apache-bullseye
RUN ["/bin/bash", "-c", "curl https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer"]
ENTRYPOINT composer --version
说明：
curl在基础镜像中已预装- 更适合需要执行多种网络操作的场景（比
wget支持更多协议）
同样构建运行后输出版本信息，效果一致。
2.3 安装指定版本的 Composer
使用 wget 安装特定版本（如 2.4.4）
Dockerfile 示例：
FROM php:8.1-apache-bullseye
ARG path=/usr/local/bin/composer
RUN ["/bin/bash", "-c", "apt update && apt install wget -y \
&& wget -O $path https://getcomposer.org/download/2.4.4/composer.phar && chmod +x $path"]
ENTRYPOINT composer --version
使用 curl 安装特定版本
Dockerfile 示例：
FROM php:8.1-apache-bullseye
ARG path=/usr/local/bin/composer
RUN ["/bin/bash", "-c", "curl -o $path https://getcomposer.org/download/2.4.4/composer.phar && chmod +x $path"]
ENTRYPOINT composer --version
✅ 优点：灵活控制版本
❌ 缺点：需要手动指定 URL，维护成本略高
3. 使用已有镜像安装 Composer
这是更推荐的做法：直接从官方 composer 镜像中拷贝可执行文件。
3.1 安装最新版本
Dockerfile 示例：
FROM php:8.1-apache-bullseye
COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
ENTRYPOINT composer --version
构建运行后输出：
Composer version 2.7.9 2024-09-04 14:43:28
3.2 安装指定版本（如 2.7.1）
Dockerfile 示例：
FROM php:8.1-apache-bullseye
COPY --from=composer:2.7.1 /usr/bin/composer /usr/local/bin/composer
ENTRYPOINT composer --version
构建运行后输出：
Composer version 2.7.1 2024-02-09 15:26:28
✅ 优点：
- 更简洁
- 更安全（官方镜像）
- 更易维护（无需手动下载和权限设置）
4. 小结与建议
| 方法 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| Shell 命令安装 | 灵活控制版本 | 步骤多、依赖网络 | 需要特定版本或无可用镜像时 |
| COPY from composer 镜像 | 简洁、安全 | 需有对应版本镜像 | 推荐常规使用方式 |
✅ 建议：
- 优先使用
COPY --from=composer:x.x.x方式安装 - 若需安装非主流版本，可手动下载
.phar文件 - 安装完成后建议执行
composer --version验证是否成功
⚠️ 踩坑提醒：
- 如果基础镜像中没有
wget或curl，记得先安装 - 拷贝路径要确认准确（如
/usr/bin/composer是否存在） - 不同版本的 Composer 镜像需确认 tag 是否存在，否则构建会失败