通过 Composer 脚本实现环境切换,先在 envs 目录存放不同环境的 .env 文件,再于 composer.json 中配置对应脚本命令,执行如 composer env:local 即可复制指定配置到根目录 .env 并输出提示,切换后建议运行 php artisan config:clear 清除缓存,同时确保 .env 不被提交至版本控制,适用于中小型项目环境管理。

在 Laravel 或其他 PHP 项目中,经常需要根据运行环境(如本地、测试、生产)切换不同的 .env 文件。你可以通过 Composer 的 scripts 功能来简化这个过程,自动复制对应环境的配置文件到项目根目录。
1. 准备不同环境的配置文件
在项目根目录创建一个 envs 文件夹,存放各个环境的配置:
-
envs/.env.local– 本地开发环境 -
envs/.env.testing– 测试环境 -
envs/.env.production– 生产环境
这些文件内容与标准的 .env 相同,只是预设了对应环境的变量。
2. 配置 composer.json 的 scripts
修改 composer.json,添加自定义脚本命令:
"scripts": {
"env:local": "cp envs/.env.local .env && echo 'Switched to local environment.'",
"env:testing": "cp envs/.env.testing .env && echo 'Switched to testing environment.'",
"env:production": "cp envs/.env.production .env && echo 'Switched to production environment.'",
"env:clear": "rm -f .env && echo 'Environment file removed.'"
}
这些脚本会将指定的环境文件复制为当前使用的 .env,并输出提示信息。
3. 使用脚本切换环境
在终端中运行以下命令即可快速切换:
-
composer env:local– 切换到本地环境 -
composer env:testing– 切换到测试环境 -
composer env:production– 切换到生产环境 -
composer env:clear– 删除当前 .env 文件
每次执行后,Laravel 就会加载新的配置。建议在切换后运行 php artisan config:clear 清除配置缓存,确保新设置生效。
4. 注意事项
确保 .env 文件已被加入 .gitignore,避免误提交敏感信息。同时,envs/ 目录中的示例文件可以提交到版本控制(如命名为 .env.example),但具体环境的文件应谨慎管理。
基本上就这些,简单直接,适合中小型项目的环境管理。










