最可靠的方式是通过Web服务器（Apache/Nginx）显式设置APP_ENV环境变量，而非依赖修改.env文件；Laravel仅依据APP_ENV值判断环境，且config:cache后.env失效，必须由服务器注入该变量才能确保各环境配置正确生效。
直接改 .env 文件是最简单的方式，但真正可靠的环境切换不靠手动改文件，而靠 Laravel 的环境加载机制和服务器配置配合。
为什么不能只靠修改 .env 文件
本地开发、测试、生产共用同一份代码时，.env 文件极易被误提交、覆盖或遗漏；Laravel 在启动时会缓存配置（php artisan config:cache），此时再改 .env 无效；多台生产服务器若依赖不同 .env，管理成本陡增。
-
.env只在未缓存配置时生效，上线必须运行config:cache - Apache/Nginx 不默认读取
.env，需通过SetEnv或fastcgi_param显式传入APP_ENV - Laravel 判断环境只看
APP_ENV值，不是看文件是否存在
APP_ENV 和 APP_DEBUG 必须由 Web 服务器设置
不能指望 PHP 自动识别“这是本地”，必须由 Apache/Nginx/PHP-FPM 明确注入环境变量。否则 App::environment('local') 永远返回 false。
- Apache：在虚拟主机配置中加
SetEnv APP_ENV production和SetEnv APP_DEBUG false - Nginx + PHP-FPM：在
server块里加fastcgi_param APP_ENV "production"; - CLI 场景（如队列、定时任务）：运行命令前显式指定，例如
APP_ENV=production php artisan queue:work
数据库配置应按环境分组写在 config/database.php 中
不要在 .env 里硬编码所有连接参数，而是利用 Laravel 的数组合并逻辑，在 config/database.php 中根据 env('APP_ENV') 动态返回不同子数组。
return [
'default' => env('DB_CONNECTION', 'mysql'),
'connections' => [
'mysql' => [
'driver' => 'mysql',
'url' => env('DATABASE_URL'),
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'forge'),
'username' => env('DB_USERNAME', 'forge'),
'password' => env('DB_PASSWORD', ''),
// 关键：根据环境覆盖部分字段
'charset' => env('APP_ENV') === 'local' ? 'utf8mb4' : 'utf8mb4',
'collation' => env('APP_ENV') === 'local' ? 'utf8mb4_unicode_ci' : 'utf8mb4_general_ci',
'options' => extension_loaded('pdo_mysql') ? array_filter([
PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_SSL_CA'),
PDO::MYSQL_ATTR_SSL_CERT => env('MYSQL_SSL_CERT'),
PDO::MYSQL_ATTR_SSL_KEY => env('MYSQL_SSL_KEY'),
]) : [],
],
],
];
- 敏感参数（如密码）仍走
.env，但结构化逻辑放在config/database.php - SSL 配置等仅生产环境需要的选项，用
array_filter()控制是否注入 - 避免在
.env中写死DB_DATABASE=homestead这类值，改用DB_DATABASE=app_${APP_ENV}并在配置中解析
部署时 config:cache 会忽略 .env，务必验证 APP_ENV 是否生效
运行 php artisan config:cache 后，所有 env() 调用会被替换为实际值——但前提是 APP_ENV 在 PHP 启动时已存在。如果 Web 服务器没传，缓存里就会塞入 env('APP_ENV', 'production') 的默认值，导致本地配置被当成生产用。
- 检查方法：在 Blade 模板中输出
{{ App::environment() }}，或执行php -r "echo $_SERVER['APP_ENV'] ?? 'not set';" - 常见错误：Nginx 配置写了
fastcgi_param APP_ENV production;，但漏了include fastcgi_params;，导致参数未传递 - 调试技巧：临时在
bootstrap/app.php开头加var_dump($_SERVER['APP_ENV'] ?? 'MISSING');确认变量是否就位
环境切换真正的难点不在写几行配置，而在于让 APP_ENV 这个字符串从 Web 服务器进程准确落到 PHP 的 $_SERVER 数组里——中间任何一层漏掉，整个动态逻辑就断了。
