laravel 正确读取 .env 需确保：修改后运行 config:clear，避免缓存干扰；app_env 必须为 laravel 认可值（如 local）；config:cache 会固化 env() 值并禁用该函数；敏感变量应通过部署工具或服务器环境提前注入，而非依赖 .env 文件。
如何让 Laravel 正确读取 .env 文件
Laravel 默认只在启动时加载一次 .env，且仅在 APP_ENV 为 local、staging 或 production 时才启用 dotenv 加载。如果你改了 .env 但 config:cache 已存在，Laravel 根本不会重新读取它——缓存配置会直接跳过 .env 解析。
实操建议：
- 修改
.env后，必须运行php artisan config:clear（清除配置缓存），否则新变量不生效 - 开发中尽量避免长期保留
config:cache；上线前再生成，且确保部署脚本包含config:clear && config:cache顺序 -
APP_ENV值必须是 Laravel 认可的环境名（如local），否则Dotenv不加载，env()返回null - 不要在
config/*.php中直接写env('DB_HOST')并期望它“动态更新”——它只在配置加载时求值一次
为什么 config:cache 后 env() 不再起作用
执行 php artisan config:cache 会把所有 config/*.php 中的 env() 调用**立即求值并固化为字符串**，写入 bootstrap/cache/config.php。此后 env() 函数本身被禁用，任何后续对它的调用都返回 null（Laravel 9+ 默认行为）。
常见错误现象：
- 本地改了
.env，php artisan tinker里env('APP_DEBUG')返回null - 部署后数据库连不上，但
.env明明写了DB_PASSWORD—— 实际是缓存里还存着旧值或空字符串 - CI/CD 流程中先
config:cache再注入 secret，结果 secret 完全没进配置
解决办法：确保环境变量注入发生在 config:cache 之前；或改用 $_ENV/getenv() 手动读取（但需自行处理类型转换和默认值）。
多环境部署时怎么安全传入敏感变量
不能把 .env 提交到 Git，也不能靠人工上传——得靠部署工具或服务器环境直接注入。关键是让变量在 PHP 进程启动时就可用，早于 Laravel 配置加载。
使用场景与建议：
- Docker：用
environment:或--env-file挂载，确保容器内getenv('REDIS_HOST')可直接读取 - Forge / Envoyer：在「Environment Variables」面板填入，它们会写入
~/.profile或 Nginx/FPM 的fastcgi_param - Server（Nginx + PHP-FPM）：在
www.conf里加env[DB_NAME] = myapp_prod，PHP 会自动注册到$_ENV - 云平台（如 Laravel Vapor、Heroku）：通过控制台设置，它们会透传为系统级环境变量
注意：putenv() 在 runtime 设置的变量，对 config:cache 无效——它只影响当前请求生命周期。
APP_ENV 和 APP_DEBUG 切换不生效？检查这三点
这两个变量控制框架行为（如错误页、日志级别、配置加载逻辑），但极易因底层机制被绕过。
容易踩的坑：
-
APP_ENV=staging但未在config/app.php的'environments'数组里声明staging→ Laravel 当作production处理 - FPM 或 CLI 进程复用旧环境：改完
.env后没重启 PHP-FPM，php-fpm -t && systemctl reload php*-fpm必须做 - Web 服务器（如 Apache）用
SetEnv覆盖了APP_DEBUG，优先级高于.env，导致你改了文件也无效
验证方式：在路由里加 return response()->json(['env' => app()->environment(), 'debug' => config('app.debug')]);，别信 env() 返回值。
