composer-runtime-api 是声明 Composer 运行时版本依赖的标识符，非可调用 API；用于确保包在特定 Composer 版本下行为可靠，仅插件或深度集成场景需声明，其版本与 Composer 主版本一致。
Composer 的 composer-runtime-api 并不是一个供开发者直接调用的“运行时 API”，而是一个特殊的 PHP 扩展依赖标识符，用于声明包对 Composer 自身运行时能力的最低版本要求。
它本质是版本约束标记，不是函数或类接口
这个字符串出现在 composer.json 的 require 或 require-dev 字段中（例如 "composer-runtime-api": "^2.0"），作用是告诉 Composer：“本包依赖于 Composer 2.0+ 的某些内部行为（如自动加载机制、插件钩子、脚本执行流程等）”。它不提供任何可调用的方法，也不暴露 PHP 类或函数。
- Composer 在安装/更新时会检查自身版本是否满足该约束，不满足则报错退出
- 它不参与自动加载，也不会被
vendor/autoload.php加载 - 它和
ext-xxx（如ext-json）类似，属于“环境能力声明”，而非代码接口
主要用途：保障包在特定 Composer 版本下行为可靠
某些包（尤其是插件、脚本工具、或深度集成 Composer 流程的库）需要依赖 Composer 某个版本引入的关键变更。比如：
- Composer 2.0 重构了自动加载器生成逻辑，旧版插件可能无法正确生成
autoload_files.php - Composer 2.2+ 增强了脚本事件参数传递方式，依赖新参数的自定义脚本需声明
^2.2 - 某些安全敏感操作（如
install --no-plugins的行为差异）在不同大版本间有语义变化
普通项目通常不需要手动添加
绝大多数应用或库无需声明 composer-runtime-api：
- 只使用
require引入依赖？完全不用管它 - 写了一个 Composer 插件（
composer-plugin-api）？应优先声明插件 API 版本，而非 runtime - 仅在
scripts中调用php或npm命令？也不需要 - 只有当你主动读取
Composer\Autoload\ClassLoader内部状态，或 hookEventDispatcher底层事件时，才可能需约束 runtime 版本
如何查看当前 Composer 的 runtime 版本号？
Composer 不单独发布 runtime 版本号，其版本与 Composer 主程序一致：
- 运行
composer --version，输出如Composer version 2.7.7，即表示 runtime API 兼容^2.0及其子版本 - 各主版本对应的最小 runtime 标识：
1.x→^1.0，2.x→^2.0，3.x（未来）→^3.0
