neatous/composer-prestissimo

Composer Prestissimo 镜像文档

镜像概述

Composer Prestissimo镜像是一个预集成Prestissimo插件的Composer工具镜像。Prestissimo是Composer的官方推荐插件，通过实现并行下载机制解决Composer默认串行下载依赖包速度慢的问题，尤其在依赖数量多或网络环境一般的场景下，可将依赖安装时间缩短60%-90%。该镜像保持与官方Composer镜像的兼容性，同时提供开箱即用的加速能力。

核心功能与特性

• 并行依赖下载：采用多线程并行下载策略，替代Composer默认的串行下载模式，大幅提升依赖获取效率。
• 无缝集成：作为Composer插件自动激活，无需修改现有Composer命令或项目配置，保持原生使用体验。
• 轻量级设计：基于官方Composer镜像构建，仅添加必要插件层，镜像体积小巧，资源占用低。
• 广泛兼容性：支持Composer 1.x/2.x主流版本，适配各类PHP项目（如Laravel、Symfony、Yii等框架）的依赖管理需求。
• CI/CD优化：针对自动化构建场景优化，可直接集成到GitLab CI、GitHub Actions等流水线，缩短构建周期。

使用场景

• 开发环境快速依赖安装：本地开发PHP项目时，快速拉取或更新composer.json中定义的依赖，减少等待时间。
• CI/CD流水线加速：在自动化构建流程中，通过并行下载缩短依赖安装阶段耗时，提升整体构建效率。
• 高频依赖更新场景：适用于需要频繁添加、升级或移除依赖的PHP项目（如框架迭代、安全补丁更新等）。
• 网络受限环境：在带宽有限或网络延迟较高的环境中，通过并行下载更高效利用网络资源，降低下载失败率。

使用方法

基本使用

通过docker run命令直接执行Composer操作，基本语法如下：

bash
docker run --rm -v $(pwd):/app composer-prestissimo [composer-command]

参数说明：

• --rm：容器退出后自动清理，避免残留临时容器。
• -v $(pwd):/app：将当前目录（PHP项目根目录）挂载至容器内/app目录，使Composer可访问项目composer.json文件。
• composer-prestissimo：镜像名称（实际使用时需替换为具体镜像标签，如composer-prestissimo:latest）。
• [composer-command]：需执行的Composer命令（如install、update、require等）。

示例：安装项目依赖

bash
# 在PHP项目根目录执行
docker run --rm -v $(pwd):/app composer-prestissimo install

持久化缓存配置

通过挂载本地Composer缓存目录，避免重复下载已缓存的依赖包，进一步提升速度：

bash
docker run --rm \
  -v $(pwd):/app \
  -v ~/.composer/cache:/root/.composer/cache \
  composer-prestissimo install

说明：~/.composer/cache为本地缓存目录，挂载后容器内Composer会复用本地缓存，减少网络传输。

结合Docker Compose使用

在docker-compose.yml中定义Composer服务，便于与项目其他服务（如PHP、数据库）协同使用：

yaml
version: '3.8'
services:
  composer:
    image: composer-prestissimo:latest
    volumes:
      - .:/app                      # 挂载项目目录
      - ~/.composer/cache:/root/.composer/cache  # 挂载缓存目录
    command: install                # 默认执行的Composer命令

执行命令：

bash
# 安装依赖
docker-compose run --rm composer

# 更新依赖（覆盖默认command）
docker-compose run --rm composer update

高级配置

调整并行下载数量

通过环境变量COMPOSER_PRESTISSIMO_MAX_PARALLEL自定义并行下载线程数（默认根据CPU核心数自动调整，建议值5-20）：

bash
docker run --rm \
  -v $(pwd):/app \
  -e COMPOSER_PRESTISSIMO_MAX_PARALLEL=10 \
  composer-prestissimo install

指定PHP版本

若需匹配项目PHP版本，可使用带PHP版本标签的镜像（如针对PHP 8.1的composer-prestissimo:php81，具体标签需参考镜像仓库说明）：

bash
docker run --rm -v $(pwd):/app composer-prestissimo:php81 install

注意事项

• 插件兼容性：若项目使用其他Composer插件（如hirak/prestissimo以外的配置器），需确保无冲突，建议优先测试组合使用效果。
• 缓存清理：当依赖版本冲突或缓存损坏时，可通过-e COMPOSER_CACHE_DIR=/dev/null临时禁用缓存进行强制重新下载。
• 网络安全：在公共网络环境中，建议通过--network=host或配置镜像源（如阿里云、腾讯云Composer镜像）进一步提升速度和安全性。