最可靠的方式是通过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 数组里——中间任何一层漏掉，整个动态逻辑就断了。