可通过shell传递环境变量或在PHP脚本中读取实现Composer脚本的环境控制。1. 执行composer命令前设置环境变量,如APP_ENV=production composer run optimize;2. 编写PHP脚本使用getenv()判断环境并执行对应逻辑;3. 结合vlucas/phpdotenv加载.env文件变量,提升开发体验;4. 避免shell复杂判断确保跨平台兼容,敏感信息不硬编码,推荐PHP脚本方式处理复杂场景。

在 Composer 脚本中使用环境变量是项目自动化过程中常见的需求,比如根据环境决定执行不同的命令或加载不同的配置。虽然 Composer 本身不直接提供环境变量解析功能,但可以通过系统机制或 PHP 脚本间接实现。
1. 使用 shell 环境变量传递
Composer 的脚本命令运行在 shell 环境中,可以直接读取已设置的环境变量。你可以在执行 composer run 命令前导出变量,或在命令行中临时设置。
示例:假设你想根据不同环境执行优化命令:
"scripts": {
"optimize-dev": "php artisan optimize",
"optimize-prod": "php artisan optimize:clear"
}
你可以通过 shell 判断环境变量来动态执行:
ENV=prod composer run optimize-prod
或者在脚本中内联判断(Linux/macOS):
"scripts": {
"optimize": "if [ \"$APP_ENV\" = \"production\" ]; then composer run optimize-prod; else composer run optimize-dev; fi"
}
注意:
Windows CMD 和 PowerShell 语法不同,跨平台时建议使用 PHP 脚本替代复杂 shell 判断。
2. 在自定义 PHP 脚本中读取环境变量
更灵活的方式是编写一个 PHP 脚本,在其中使用 getenv() 或 $_ENV 读取变量,并根据值执行逻辑。
步骤:- 创建脚本文件,如 scripts/optimizer.php:
- 在 composer.json 中调用该脚本:
"scripts": {
"optimize": "php scripts/optimizer.php"
}
- 执行时设置环境变量:
APP_ENV=production composer run optimize
3. 使用 dotenv 加载 .env 文件(推荐开发环境)
如果你使用 Laravel 或其他支持 dotenv 的框架,可以在 PHP 脚本中引入 vlucas/phpdotenv 自动加载 .env 文件中的变量。
安装依赖:composer require vlucas/phpdotenv在脚本中加载:
safeLoad(); $env = $_ENV['APP_ENV'] ?? 'local'; // 后续逻辑...
这样即使未手动设置环境变量,也能从 .env 文件读取。
4. 注意事项与最佳实践
- 环境变量在 Windows 和 Unix 系统中的写法一致,但 shell 语法差异大,避免在 scripts 中写复杂条件。
- 敏感信息不要硬编码在 composer.json 或脚本中。
- PHP 脚本方式兼容性更好,适合复杂逻辑。
- 确保脚本文件路径正确,且有执行权限(必要时)。
基本上就这些。通过结合 shell 变量传递和 PHP 脚本处理,可以灵活实现在 Composer 中使用环境变量的需求。关键是选择合适的方式匹配你的部署环境和团队习惯。










