Composer运行时API（Runtime API）获取当前包版本的方法（代码示例）-composer-PHP中文网

运行时读取当前 composer 包版本最可靠方式是解析 vendor/composer/installed.json（v2）或 installed.php（v1），通过匹配包名提取 version 字段，而非依赖 composer.json 的 version 或 package::getversion() 等不可靠方法。

composer运行时api（runtime api）获取当前包版本的方法（代码示例）

如何在运行时读取当前 Composer 包的版本号

Composer 本身不提供运行时 API 直接暴露当前包版本，composer.json 中的 version 字段在安装后不会自动注入到 PHP 运行环境中。你不能靠调用某个函数直接拿到“当前包版本”，必须依赖外部机制——最可靠的是读取 composer.lock 或利用 Composer 自动生成的 vendor/composer/installed.json（v2）或 vendor/composer/installed.php（v1）。

读取 `vendor/composer/installed.json` 获取本包版本（推荐）

Composer v2 默认生成 JSON 格式的安装元数据，路径为 vendor/composer/installed.json，其中包含所有已安装包的名称、版本、源类型等信息。你需要按 name 字段匹配当前包名（即 composer.json 中的 "name": "vendor/name"），再提取其 version。

实操建议：

先通过 __DIR__ . '/../../composer.json' 或 getcwd() . '/composer.json' 读取当前项目根目录的 composer.json，解析出 name 字段；但更稳妥的方式是硬编码包名（因为运行时可能被作为依赖引入，composer.json 不一定在上层）
检查 file_exists(__DIR__ . '/../../vendor/composer/installed.json')，避免在开发环境未装依赖时报错
installed.json 中的 version 是规范后的版本（如 dev-main、1.2.3+commitabc），不是 composer.json 原始字符串
注意：该文件内容由 Composer 维护，结构稳定，但字段层级较深——需遍历 packages 数组（v2）或 packages 对象（v2 的 JSON 是数组）

$installed = json_decode(file_get_contents(__DIR__ . '/../../vendor/composer/installed.json'), true);
$myPackageName = 'myvendor/mypackage';
$version = null;
foreach ($installed['packages'] as $pkg) {
    if ($pkg['name'] === $myPackageName) {
        $version = $pkg['version'];
        break;
    }
}
echo $version; // e.g. "dev-main" or "2.1.0"

兼容 Composer v1 的 fallback：读 `vendor/composer/installed.php`

v1 时代 Composer 生成的是 PHP 文件，返回一个大型数组，结构不同且无命名空间隔离。如果你的包需支持旧项目，得做兼容判断。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

常见错误现象：

直接 require installed.php 导致全局变量污染或重复定义警告（它用 return [...]，但某些 autoload 场景下可能被多次加载）
v1 的 installed.php 中包信息在 $installed['versions'] 下，键是带 vendor/name 的字符串，值数组里有 pretty_version 和 version 两个字段，语义略有差异
不要用 class_exists() 或 function_exists() 判断 Composer 版本——应优先检测文件存在性与内容格式