.env变量仅在启动时由dotenv加载到$_env/$_server，config/文件中调用env()才真正读取；缓存配置后env()失效，须用config()或app::environment()。
为什么 .env 文件的变量在 config/ 里才能生效
Laravel 不是读完 .env 就直接注入全局变量，而是靠 Dotenv 在启动早期加载并写入 $_ENV 和 $_SERVER，但后续所有配置（比如数据库、缓存）都从 config/ 目录下的 PHP 文件取值——而这些文件里写的 env('DB_HOST') 才是真正触发读取的入口。
常见错误现象：echo $_ENV['APP_NAME'] 在控制器里报错或为空；或者改了 .env 但 php artisan config:clear 后还是旧值。
-
.env只在应用启动初期被读一次，之后全靠config/文件中调用env()函数按需取值 -
config/文件本身会被 Laravel 缓存（php artisan config:cache），缓存后env()不再读.env，而是用缓存里固化下来的值 - 开发时建议不运行
config:cache；上线必须跑，否则每次请求都重新解析.env，有性能损耗且不安全（可能暴露路径）
env() 函数不能直接用在模型或服务类里
因为 env() 是 Laravel 的辅助函数，依赖框架启动流程，而某些场景（比如队列任务、命令行提前加载、测试环境 mock）下它可能还没准备好，或被 config:cache 剥离掉。
使用场景：你想在 App\Models\User.php 里根据 APP_ENV 控制日志行为，结果本地正常、队列里报 Call to undefined function env()。
- 永远优先从
config()取值，比如config('app.env')，它不依赖.env实时读取，而是走已加载的配置数组 - 如果非要动态判断环境，用
App::environment('local')或app()->environment('production')，比env('APP_ENV') === 'local'更可靠 - 别在类属性定义里写
private $debug = env('DEBUG');—— 类加载时env()还没可用，会报错或为null
.env 里的布尔和数字值要加引号
不是 Laravel 的锅，是 vlucas/phpdotenv 解析规则：不加引号的 true、false、null、123 会被当成 PHP 字面量，导致类型丢失。比如你写 ENABLE_FEATURE=false，env('ENABLE_FEATURE') 返回的是字符串 "false"，不是布尔 false。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
错误现象：条件判断 if (env('ENABLE_FEATURE')) { ... } 永远为真（因为非空字符串转布尔是 true）。
- 布尔值统一加单引号：
ENABLE_FEATURE='false'，然后用filter_var(env('ENABLE_FEATURE'), FILTER_VALIDATE_BOOLEAN) - 数字也建议加引号：
API_TIMEOUT='30'，避免被误解析成浮点或科学计数法 - 空格敏感：
APP_NAME= My App会导致值变成"My"，必须写成APP_NAME="My App"或APP_NAME='My App'
部署时 .env 被 Git 忽略，但有些值必须动态传入
比如 Docker 环境、K8s ConfigMap、云平台环境变量注入，它们不走 .env 文件，而是直接设进容器的 ENV。这时候 Dotenv 默认不会去读系统级环境变量，除非你显式允许。
使用场景：你在 K8s 里用 envFrom: configMapRef 注入 DB_PASSWORD，但 Laravel 还是连不上库。
- 确保
bootstrap/app.php中Dotenv::create(...)->load();调用前，没有putenv()或$_SERVER覆盖干扰 - 更稳妥的做法是删掉
.env加载逻辑，直接让服务器环境变量生效——Laravel 5.9+ 默认支持从$_ENV/$_SERVER读env()，无需.env文件 - 验证方式：在路由里写
return $_ENV['DB_HOST'] ?? 'not set';，看是否能拿到值
最容易被忽略的一点：本地开发习惯性改 .env，上线却忘了在服务器上配等效的环境变量，或者配了但没重启 FPM/Worker 进程——变量只在进程启动时读取一次。
