首页 关于我们 成功案例 网络营销 电商设计 新闻中心 联系方式
QQ联系
电话联系
手机联系

如何在 PHP 代码中获取 composer.json 中定义的 extra 数据?

发布时间:2025-12-14 13:30
发布者:网络
浏览次数:
最直接可靠的方式是使用 Composer\InstalledVersions::getRawData() 获取当前项目根包的 extra 数据,因其由 Composer 自动注入且保证 packages[0] 为根包。

如何在 php 代码中获取 composer.json 中定义的 extra 数据?

在 PHP 代码中获取 composer.json 中定义的 extra 数据,最直接可靠的方式是读取已生成的 vendor/composer/installed.json(Composer 2.x)或通过 Composer 的自动加载机制访问其内部数据结构。但更推荐、更稳定的做法是使用 Composer 提供的官方运行时 API —— 即通过 Composer\InstalledVersions 类(Composer 2.0+ 内置),或手动解析 composer.lock / installed.json

使用 InstalledVersions::getRawData()(推荐,Composer 2.2+)

Composer 2.2 起内置了 Composer\InstalledVersions,它在安装/更新后会生成静态元数据,其中包含当前包的 extra 字段(仅限当前项目根包,即你的主项目,不是依赖包)。

  • 确保你项目已执行过 composer installcomposer update
  • 该类无需额外 require,Composer 自动注入(只要用了 Composer 自动加载)
  • 调用 getRawData() 可拿到所有已安装包的原始 JSON 数据数组

示例代码:

// 获取当前项目(root package)的 extra 数据
$rawData = Composer\InstalledVersions::getRawData();
$rootPackage = $rawData['packages'][0] ?? null;
if ($rootPackage && isset($rootPackage['extra'])) {
    $extra = $rootPackage['extra'];
    print_r($extra); // 如 ['my-key' => 'my-value', 'env' => 'prod']
}

⚠️ 注意:packages[0] 是约定——Composer 总把当前项目放在 installed.json 的第一个位置。这是 Composer 的行为保证,可安全依赖。

手动读取 vendor/composer/installed.json

如果环境受限(如低版本 Composer 或需兼容旧项目),可直接解析该文件:

  • 路径固定为 vendor/composer/installed.json
  • 该文件由 Composer 维护,格式稳定,包含所有包的完整信息
  • 需注意文件存在性与 JSON 解析错误处理

示例:

盛世企业网站管理系统1.1.2 盛世企业网站管理系统1.1.2

免费 盛世企业网站管理系统(SnSee)系统完全免费使用,无任何功能模块使用限制,在使用过程中如遇到相关问题可以去官方论坛参与讨论。开源 系统Web代码完全开源,在您使用过程中可以根据自已实际情况加以调整或修改,完全可以满足您的需求。强大且灵活 独创的多语言功能,可以直接在后台自由设定语言版本,其语言版本不限数量,可根据自已需要进行任意设置;系统各模块可在后台自由设置及开启;强大且适用的后台管理支

盛世企业网站管理系统1.1.2 0 查看详情 盛世企业网站管理系统1.1.2
$installedPath = __DIR__ . '/vendor/composer/installed.json';
if (file_exists($installedPath)) {
    $data = json_decode(file_get_contents($installedPath), true);
    $root = $data['packages'][0] ?? [];
    $extra = $root['extra'] ?? [];
}

不推荐:直接解析 composer.json

虽然 composer.json 是源文件,但它不是运行时保证存在的(例如线上部署可能只含 vendor/composer.lock,不含 composer.json)。

  • 路径不确定(可能不在 __DIR__ 下)
  • 无法反映实际安装状态(比如 extra 在开发时改了但没重装)
  • 缺少环境适配(如不同分支、CI 环境可能用不同配置)

所以除非明确用于开发工具类脚本,否则避免直接读 composer.json

小技巧:给 extra 加类型提示或封装访问器

为提升可维护性,建议封装一个简单工具方法:

function getComposerExtra(string $key = null, $default = null) {
    $raw = Composer\InstalledVersions::getRawData();
    $extra = ($raw['packages'][0]['extra'] ?? []) + ['version' => Composer\InstalledVersions::getVersion('your-vendor/your-package')];
    return $key ? ($extra[$key] ?? $default) : $extra;
}
// 使用
$env = getComposerExtra('env', 'dev');
$apiUrl = getComposerExtra('api_url');

基本上就这些。核心原则是:依赖 Composer 运行时生成的权威数据,而不是源码文件。

以上就是如何在 PHP 代码中获取 composer.json 中定义的 extra 数据?的详细内容,更多请关注php中文网其它相关文章!


# php  # composer  # js  # json  # 工具  # 管理系统  # 如何在  # 企业网站  # 数据结构  # 并在  # 尼克  # 如何解决  # 该文件  # 回调  # 命令行  # 黄岩关键词排名如何拍  # 太康网站优化报价  # 平谷区常规网站建设推广  # 邓州seo  # 对seo有用的标签是  # 网络营销和网站建设  # 北京网站建设咨询薇  # 网站seo优化怎样  # 浦江网站建设流程图  # 线上优化推广网站