Composer 2.0 升级指南：从1.x迁移到2.0的全面解析

Composer 2.0 升级指南：从1.x迁移到2.0的全面解析

composer Dependency Manager for PHP 项目地址: https://gitcode.com/gh_mirrors/co/composer

前言

Composer 2.0 是一次重大版本更新，带来了许多架构改进和新特性。本文将从技术角度深入分析升级到 Composer 2.0 需要注意的关键变化，帮助开发者顺利完成迁移。

面向普通用户的升级要点

1. 平台检查机制

Composer 2.0 引入了全新的平台检查功能，会在运行时验证：

• PHP 版本是否满足项目依赖要求
• 必需的 PHP 扩展是否已安装

如果检查失败，Composer 会直接报错退出。建议在生产环境部署流程中加入：

composer check-platform-reqs

使用生产环境的 PHP 进程执行此命令，确保环境一致性。

2. 仓库优先级处理优化

当同一个包存在于多个仓库时，Composer 2.0 会完全忽略低优先级仓库中的包，而不再像1.x版本那样可能混合使用。

3. 自动加载优化

在优化自动加载模式下(optimized-autoloader)，无效的PSR-0/PSR-4配置将不再生成自动加载代码，这与1.10版本引入的警告一致。

4. 配置目录变更

在支持XDG标准的Linux系统上，Composer 2.0会优先使用XDG_CONFIG_DIR/composer目录，而不是~/.composer。

5. 包命名规范强化

包名称必须严格遵循命名规范，否则Composer会直接中止操作，这与1.8.1版本引入的警告一致。

6. 其他重要变更

• 移除了--no-suggest选项（已不再需要）
• 完全移除了对PEAR的支持（仓库、下载器等）
• update命令现在会先显示锁文件变更（更新阶段），再显示vendor目录变更（安装阶段）
• HTTPS_PROXY_REQUEST_FULLURI默认值改为false（兼容性更好）
• dev-trunk、dev-master和dev-default不再互为别名，保留精确分支名

面向插件开发者和集成者的升级要点

1. 插件API重大变更

• 插件API版本升级到2.0.0
• 新增deactivate和uninstall方法，用于停止插件运行和清理资源
• 实现了EventSubscriberInterface的插件在被停用时会自动从事件调度器中注销

2. 依赖解析流程重构

Composer 2.0将更新和安装过程分离：

更新流程：

1. 解析依赖（触发PRE_POOL_CREATE事件）
2. 写入锁文件

安装流程：

1. 触发PRE_OPERATIONS_EXEC事件（包含所有待执行操作）
2. 并行下载所有不在缓存中的包
3. 并行执行包安装/更新/卸载操作

3. 下载器接口重构

DownloaderInterface进行了重大调整：

• download方法现在只负责网络操作
• 新增prepare、install和cleanup方法
• 执行流程变为：下载 → 准备 → 安装 → 清理

4. 其他重要API变更

• vendor/composer/installed.json格式变更
• 移除了OperationInterface::getReason
• PreFileDownloadEvent现在接收HttpDownloader实例
• IOInterface现在扩展了PSR-3的LoggerInterface
• RepositoryInterface新增多个方法
• 推荐使用HttpDownloader替代RemoteFilesystem

面向仓库实现者的升级要点

Composer 2.0引入了新的仓库格式，可以同时兼容v1和v2。

1. 元数据URL

新增metadata-url字段，格式示例：

"metadata-url": "/p2/%package%.json"

关键要求：

• 必须为每个包返回准确的版本数据
• 不存在的包必须返回404状态码
• 支持If-Modified-Since缓存机制
• 可选使用MetadataMinifier::minify()压缩数据

2. 可选功能

• providers-api：返回提供某个包名的包列表
• list：支持过滤查询的包名列表接口

升级建议

1. 测试环境先行：先在开发环境测试升级
2. 检查插件兼容性：确保所有插件支持2.0版本
3. 更新部署流程：根据平台检查机制调整CI/CD流程
4. 监控性能：2.0的并行处理可能影响资源使用

Composer 2.0通过架构重构显著提升了性能和可靠性，理解这些变更将帮助您更好地利用新版本的优势。

composer Dependency Manager for PHP 项目地址: https://gitcode.com/gh_mirrors/co/composer