最直接可靠的方式是使用 Composer\InstalledVersions::getRawData() 获取当前项目根包的 extra 数据，因其由 Composer 自动注入且保证 packages[0] 为根包。
在 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 install或composer 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 的行为保证，可安全依赖。
立即学习“PHP免费学习笔记（深入）”；
手动读取 vendor/composer/installed.json
如果环境受限（如低版本 Composer 或需兼容旧项目），可直接解析该文件：
- 路径固定为
vendor/composer/installed.json - 该文件由 Composer 维护，格式稳定，包含所有包的完整信息
- 需注意文件存在性与 JSON 解析错误处理
示例：
$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 运行时生成的权威数据，而不是源码文件。
