如何在 composer.json 中引用环境变量？-composer-PHP中文网

如何在 composer.json 中引用环境变量？

下次还敢

发布： 2025-11-08 20:40:02

原创

689人浏览过

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

如何在 composer.json 中引用环境变量？

在 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" }

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

然后在脚本中使用：

<?php
require_once 'vendor/autoload.php';
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

$envValue = $_ENV['SOME_VAR'];
// 根据 $envValue 执行后续操作
?>

登录后复制