如何在composer中使用环境变量？-composer-PHP中文网

如何在composer中使用环境变量？

尼克

发布： 2025-11-16 11:24:06

原创

488人浏览过

在Composer中使用环境变量可通过scripts字段调用系统变量，如设置APP_ENV；也可结合vlucas/phpdotenv加载.env文件；还可编写PHP脚本读取变量并由Composer调用，实现配置动态化。

如何在composer中使用环境变量？

在 Composer 中使用环境变量，主要是为了在执行脚本、配置包或自定义命令时动态传入不同的值，比如数据库连接、API 密钥等。Composer 本身不直接管理环境变量，但你可以通过几种方式在 composer.json 的脚本和命令中使用它们。

1. 在 scripts 中使用环境变量

你可以在 composer.json 的 scripts 字段中调用系统环境变量，例如：

{
    "scripts": {
        "post-install-cmd": "echo $APP_ENV",
        "start-dev": "APP_ENV=development php server.php",
        "start-prod": "APP_ENV=production php server.php"
    }
}

登录后复制

运行 composer start-dev 时，会设置 APP_ENV=development 并执行脚本。这种方式适用于 Linux/macOS，Windows 下可使用 PowerShell 或设置兼容的 shell 环境。

2. 使用 dotenv 加载 .env 文件

很多 PHP 项目使用 vlucas/phpdotenv 来加载 .env 文件中的变量。你可以在 Composer 脚本中先加载它：

{
    "require-dev": {
        "vlucas/phpdotenv": "^5.4"
    },
    "scripts": {
        "init": "php -r "require_once 'vendor/autoload.php'; (new\Dotenv\Dotenv(__DIR__))->load(); echo getenv('DB_HOST');""
    }
}

登录后复制

确保项目根目录有 .env 文件：

如知AI笔记

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

查看详情

DB_HOST=localhost
APP_ENV=local

登录后复制

3. 结合自定义命令脚本使用

你可以写一个 PHP 脚本读取环境变量并执行逻辑，然后在 Composer 中调用：

// scripts/start.php
<?php
$env = getenv('APP_ENV') ?: 'development';
echo "Running in $env mode
";

登录后复制

在 composer.json 中注册：

{
    "scripts": {
        "start": ["php scripts/start.php"]
    }
}

登录后复制

运行 composer start，也可以传入变量：

APP_ENV=staging composer start

登录后复制

4. 注意事项

环境变量在 Windows CMD 中语法不同，建议使用 PowerShell 或 Git Bash。
不要把敏感信息硬编码在 composer.json 中。
Composer 脚本默认在当前 shell 执行，变量作用域仅限该命令。
部署时确保服务器环境已正确设置所需变量。

基本上就这些。Composer 借助系统环境和 dotenv 可灵活支持多环境配置，关键是把变量注入到执行上下文中。

以上就是如何在composer中使用环境变量？的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

如何让composer在安装PHP包的同时执行npm或yarn命令？如何使用composer管理非PHP项目的依赖？ composer如何创建和发布自己的PHP包到Packagist_注册Packagist并通过composer发布包如何使用 composer 安装开发环境依赖 (require-dev)？如何在composer中处理包含二进制文件或非PHP代码的依赖包？