composer不支持直接读取环境变量,需通过配置替换、脚本注入、dotenv工具或CI/CD构建时替换等方式间接实现,核心是将变量处理移至脚本阶段。

在 composer.json 中不能直接使用环境变量,因为 Composer 本身不会解析 php 的 $_ENV 或 getenv()。但你可以通过一些方式间接实现引用环境变量的效果。
1. 使用 Composer 的配置替换功能(config.platform)
如果你需要模拟某些环境值(如 PHP 版本或扩展),可以在 composer.json 中使用 config.platform 来“固定”环境信息:
注意:这并非真正读取系统环境变量,而是用于构建可重现的依赖环境。
{ "config": { "platform": { "php": "8.1.0" } } }
2. 利用脚本在安装时注入变量
你可以在 scripts 阶段运行自定义 PHP 脚本,读取环境变量并动态生成配置文件,比如生成一个 config.php 或修改参数。
示例:
在 composer.json 中定义脚本:
{ "scripts": { "post-install-cmd": "php scripts/generate-config.php", "post-update-cmd": "php scripts/generate-config.php" } }
然后在 scripts/generate-config.php 中读取环境变量:
<?php $apiKey = getenv('API_KEY') ?: $_ENV['API_KEY'] ?? ''; file_put_contents('config.php', "<?php return ['api_key' => '$apiKey'];n"); ?>
3. 使用 dotenv 工具配合 Composer 脚本
结合 vlucas/phpdotenv 在 Composer 脚本中加载 .env 文件,再根据变量值做逻辑处理。
先安装 dotenv:
"require-dev": { "vlucas/phpdotenv": "^5.4" }
然后在脚本中使用:
<?php require_once 'vendor/autoload.php'; $dotenv = DotenvDotenv::createImmutable(__DIR__); $dotenv->load(); $envValue = $_ENV['SOME_VAR']; // 根据 $envValue 执行后续操作 ?>
4. 构建时替换(CI/CD 场景)
在部署流程中,可以用 shell 脚本先替换 composer.json 中的占位符,再运行 composer install。
例如,用 sed 替换:
sed -i "s/__VERSION__/$SEMVER/g" composer.json
这种方式适合 CI 环境,但要小心修改 JSON 结构导致语法错误。
基本上就这些方法。Composer 本身不支持环境变量插值,关键在于把“读取变量”移到脚本阶段处理,而不是期望它直接解析。合理使用 post-install-cmd 和 dotenv 就能解决大多数场景。