Laravel中env()不能在生产环境config文件中直接读取.env值，因config:cache会冻结env()调用结果；正确做法是配置文件中使用env('KEY', 'default')并确保部署前正确设置.env。
env() 函数不能在 config 文件里直接读取 .env 值
很多人在 config/app.php 或自定义配置文件里写 env('APP_NAME')，发现部署到生产环境后值为空或没生效——这不是 bug，是 Laravel 的设计机制：Laravel 在生产环境会缓存配置（php artisan config:cache），而缓存过程会把所有 env() 调用“冻结”为执行时的值；但缓存生成时，.env 文件通常已被忽略（出于安全考虑），导致读不到。
正确做法是：只在配置文件里用 env()，且必须配合默认值，并确保开发/测试阶段不跳过 .env 加载：
-
env('DB_PORT', 3306)✅ 允许，有兜底 -
env('API_KEY')❌ 危险，无默认值时生产缓存中为null - 不要在配置文件外（如控制器）频繁调用
env()，它不是运行时 API，仅用于启动期初始化
config() 函数读取的是已加载的配置数组，不是 .env 文件
config('app.name') 读的是 config/app.php 里返回的数组中 'name' => env('APP_NAME', 'Laravel') 这一项的最终计算结果，不是实时查 .env。也就是说：config() 是读缓存后的配置快照，和 .env 已无直接关系。
常见误用场景：
- 修改了
.env但没运行php artisan config:clear→ 旧缓存还在，config()不更新 - 在命令行（Artisan）中改了
.env，但当前进程已加载配置 → 必须重启队列 worker 或重跑命令 - 想用
config(['app.debug' => true])动态改配置？可以，但仅限当前请求生命周期，不影响其他请求，也不写回文件
如何安全地封装带环境判断的参数
比如数据库连接需要根据 APP_ENV 切换 host，又不想在每个 config/database.php 里写三元表达式。推荐方式是：在配置文件内用 env() + 条件组合，而不是靠 config() 去“动态推导”：
'mysql' => [
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', 3306),
'database' => env('DB_DATABASE', 'forge'),
// ✅ 安全封装：用 env() 直接控制，不依赖 config() 反查
'prefix' => env('DB_PREFIX', ''),
],
如果逻辑更复杂（例如不同环境用不同 Redis 配置），可单独建 config/cache.php，并在其中用 env('APP_ENV') === 'production' 分支，但注意：这些判断只在配置加载时执行一次。
config:cache 和 env 的关系最容易被忽略
运行 php artisan config:cache 后，Laravel 会把所有 config/*.php 执行一遍，把 env() 替换成当时取到的值，然后写入 bootstrap/cache/config.php。此后 config() 完全从这个缓存数组读，不再碰 .env 或 env() 函数。
所以：
- CI/CD 部署时，务必先设好
.env，再跑config:cache - 本地开发建议不用
config:cache，避免反复清缓存 - 容器化部署（Docker）中，别把
.envCOPY 进镜像，应通过环境变量注入，Laravel 会自动识别（只要没被config:cache固化）
真正麻烦的不是语法，而是配置生命周期和缓存时机——多数问题出在“以为改了 .env 就立刻生效”，其实中间隔着一层静态快照。
