因为Dotenv类不自动加载环境变量，必须显式调用load()或safeLoad()；若仅require autoload.php而未调用load()，getenv()将返回false或空字符串，且需确保variables_order包含E、路径正确、.env文件存在。
为什么 vlucas/phpdotenv 不能直接 require 就生效？
因为 Dotenv 类本身不自动加载环境变量到 $_ENV 或 getenv()，必须显式调用 load() 或 safeLoad()。很多新手写完 require 'vendor/autoload.php'; 就以为完事了，结果 getenv('DB_HOST') 返回 false 或空字符串。
典型错误场景：Laravel 之外的手动项目、微服务脚本、CLI 命令行工具——这些地方没有框架封装，容易漏掉加载步骤。
-
Dotenv::createImmutable()（推荐）会拒绝写入$_ENV，只读取并返回值，更安全 -
Dotenv::createUnsafeMutable()才会把变量注入$_ENV和getenv()，但可能被后续代码污染 - 路径默认是当前目录（
getcwd()），如果 CLI 运行位置不在项目根目录，.env就找不到
如何正确初始化 Dotenv 并处理常见路径问题？
最稳妥的方式是显式指定 .env 文件所在目录，而不是依赖运行时工作目录。尤其在 CLI 脚本或 Web 入口（如 public/index.php）中，getcwd() 往往不是你期望的位置。
<?php require __DIR__ . '/../vendor/autoload.php'; use Dotenv\Dotenv; // 显式指向项目根目录下的 .env，避免 cwd 影响 $dotenv = Dotenv::createImmutable(__DIR__ . '/..'); $dotenv->load(); // 必须调用！否则变量不生效
-
__DIR__ . '/..'是相对路径保险做法，比dirname(__DIR__)更直白且兼容 PHP 7.2+ - 若
.env在子目录（如config/.env），传入__DIR__ . '/../config'即可 - 如果文件不存在，
load()会抛出Dotenv\Exception\InvalidPathException，生产环境建议用safeLoad()静默失败
getenv() 返回空？检查这三件事
即使 load() 成功执行，getenv('APP_ENV') 仍可能为空——这不是库的问题，而是 PHP 自身配置和作用域限制。
立即学习“PHP免费学习笔记（深入）”；
- 确认
php.ini中variables_order包含E（即variables_order = "GPCSE"），否则getenv()不读$_ENV -
getenv()在 Apache 的mod_php下有时失效，改用$_ENV['APP_ENV']或$_SERVER['APP_ENV']更可靠 - 如果用了
Dotenv::createImmutable()，它默认不写入$_ENV，此时必须用$dotenv->resolve()['APP_ENV']或直接读返回的数组
多个环境文件（.env.local、.env.test）怎么叠加？
vlucas/phpdotenv 本身不支持自动合并多文件，但可通过多次 load() 实现覆盖逻辑：后加载的键会覆盖先加载的同名键。
$dotenv = Dotenv::createImmutable(__DIR__ . '/..');
$dotenv->load(); // .env
// 叠加本地覆盖文件（如果存在）
if (file_exists(__DIR__ . '/../.env.local')) {
$dotenv->load(__DIR__ . '/../.env.local');
}
- 不要用
load(['.env', '.env.local'])—— 这是旧版 API，新版已移除 -
.env.local应该放在.gitignore中，用于开发机专属配置（如本地 Redis 密码） - 测试环境建议用
Dotenv::createImmutable(__DIR__.'/..', ['.env', '.env.test'])构造时传数组（仅 v5.6+ 支持）
真正麻烦的是变量类型解析——vlucas/phpdotenv 默认全当字符串，true、null、数字都不会自动转换，需要自己用 filter_var() 或第三方扩展补足。
