vlucas/phpdotenv 仅将 .env 键值对注入 $_ENV/$_SERVER，需手动读取变量初始化数据库；.env 不支持嵌套或逻辑，DB 动态配置应在 PHP 层组装；加载须在入口顶部，按 APP_ENV 链式加载多环境文件，并验证变量存在性。
dotenv 在 PHP 中如何加载环境变量
dotenv 库（如 vizualb/vizualb-dotenv 或更常用的 vlucas/phpdotenv）本身不“自动”加载数据库配置，它只负责把 .env 文件里的键值对注入到 $_ENV 和/或 $_SERVER。你得自己读取这些变量来初始化数据库连接。
常见错误是以为 Dotenv::createImmutable(__DIR__)->load() 执行完，$db_host 这类变量就自动存在了——其实没有，必须显式用 $_ENV['DB_HOST'] 或 getenv('DB_HOST') 获取。
- 推荐用
vlucas/phpdotenvv5+，它默认不覆盖已存在的环境变量，更安全 - 加载位置必须在所有依赖配置的代码之前，通常放在
index.php或框架入口文件最顶部 - 别在 CLI 和 Web 环境混用同一份
.env—— 开发时 CLI 可能读不到 Web 服务器的$_ENV，建议统一用getenv()并确保Dotenv已加载
为什么 DB 配置不能直接写进 .env 文件
.env 是纯字符串键值对，不支持嵌套、数组或条件逻辑。像 MySQL 的 options 数组（如 PDO::ATTR_EMULATE_PREPARES）、是否启用 SSL、或根据环境切换 DSN 协议（mysql:// vs sqlite:///tmp/test.db），都得在 PHP 层组装。
典型陷阱：把 DB_URL=mysql://user:pass@localhost/dbname 直接当完整配置用，但不同框架解析方式不同（Laravel 自带解析器，Slim 或原生 PDO 就得自己 parse_url + 提取字段）。
立即学习“PHP免费学习笔记（深入）”；
- 安全起见，
.env只放敏感且静态的字段：DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASS - 动态部分（如 charset、persistent、timeout）写在 PHP 配置数组里，按
$_ENV['APP_ENV']切换 - 避免在
.env里写DB_DSN字符串——调试时无法快速定位哪段出错，也不利于单元测试 mock
PHP 原生 PDO 初始化时怎么安全读取 dotenv 变量
不要裸写 new PDO($_ENV['DB_DSN'])，因为 $_ENV 可能为空（未加载、被禁用、或 key 名拼错），PDO 构造失败会抛 PDOException，但错误信息里不包含缺失的环境变量名，排查困难。
// 推荐方式：显式检查 + 默认降级（开发环境可用 sqlite 内存库兜底）
$host = $_ENV['DB_HOST'] ?? '127.0.0.1';
$port = $_ENV['DB_PORT'] ?? '3306';
$dbname = $_ENV['DB_NAME'] ?? 'test';
$user = $_ENV['DB_USER'] ?? 'root';
$pass = $_ENV['DB_PASS'] ?? '';
if (empty($host) || empty($dbname)) {
throw new RuntimeException('Missing required DB environment variables');
}
$dsn = "mysql:host={$host};port={$port};dbname={$dbname};charset=utf8mb4";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
];
try {
$pdo = new PDO($dsn, $user, $pass, $options);
} catch (PDOException $e) {
// 记录完整 DSN（不含密码）便于排查
error_log("PDO connection failed: " . preg_replace('/;pwd=[^;]*/i', ';pwd=***', $dsn));
throw $e;
}
多环境切换时 APP_ENV 和配置加载顺序的关键点
APP_ENV 本身也是从 .env 读的，但它必须最先被读取，否则你没法决定该加载哪个环境专用的 .env.local 或跳过某些配置。所以标准流程是：先加载基础 .env，从中拿到 APP_ENV，再按需加载 .env.<code>APP_ENV（如 .env.production）。
-
vlucas/phpdotenv支持链式加载：Dotenv::createUnsafeImmutable(__DIR__)->load(); Dotenv::createUnsafeImmutable(__DIR__)->loadEnv($_ENV['APP_ENV'] ?? 'dev'); - 注意
createImmutable和createUnsafeImmutable的区别：后者允许覆盖已有变量，适合多文件叠加；前者一旦加载就不能改，适合严格隔离 - 本地开发常用
APP_ENV=local，线上用APP_ENV=production，但别在.env里写死——应由部署脚本注入，.env只保留APP_ENV=dev作为 fallback
真正容易被忽略的是：Web 服务器（如 Apache）可能禁用了 getenv()，或 CLI 的 php -S 不加载 .env，导致同一个代码在不同入口行为不一致。务必在入口处加一句 var_dump($_ENV['APP_ENV'] ?? 'not set'); 快速验证。
