Yii2基础模板使用vlucas/phpdotenv加载环境变量报错解决

问题根源 #

你仅在web/index.php中添加了Dotenv加载逻辑，但php yii serve是通过根目录的Console入口脚本yii执行的，这个入口未加载Dotenv，导致CLI环境下无法读取.env中的变量，进而触发未定义警告。

具体修复步骤 #

• 给Console入口添加Dotenv加载
  打开根目录下的yii文件，在最开头添加Dotenv初始化代码，和web端逻辑保持一致：

  <?php
  // 加载composer自动加载器
  require __DIR__ . '/vendor/autoload.php';
  
  // 初始化Dotenv
  $dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
  $dotenv->load();
  
  // 原有Yii初始化代码
  defined('YII_DEBUG') or define('YII_DEBUG', $_ENV['YII_DEBUG'] === 'true');
  defined('YII_ENV') or define('YII_ENV', $_ENV['YII_ENV'] ?: 'prod');
  
  require __DIR__ . '/vendor/yiisoft/yii2/Yii.php';
  $config = require __DIR__ . '/config/console.php';
  
  $application = new yii\console\Application($config);
  $exitCode = $application->run();
  exit($exitCode);
  

• 检查.env文件格式
  确保.env变量定义无多余引号（值含空格除外），示例格式：

  YII_DEBUG=true
  YII_ENV=dev
  DB_HOST=localhost
  DB_NAME=yii2_dev
  DB_USER=root
  DB_PASSWORD=your_db_password
  

• 给配置添加兜底值
  在config/db.php中使用PHP空合并运算符，给每个环境变量设置默认值，避免未定义警告：

  return [
      'class' => 'yii\db\Connection',
      'dsn' => 'mysql:host=' . ($_ENV['DB_HOST'] ?? 'localhost') . ';dbname=' . ($_ENV['DB_NAME'] ?? 'yii2_app'),
      'username' => $_ENV['DB_USER'] ?? 'root',
      'password' => $_ENV['DB_PASSWORD'] ?? '',
      'charset' => 'utf8',
  ];
  

• 验证修复效果
  执行以下命令测试变量是否正常读取：

  php yii help
  

  或直接输出指定变量：

  php -r "require 'vendor/autoload.php'; \$dotenv = Dotenv\Dotenv::createImmutable(__DIR__); \$dotenv->load(); echo \$_ENV['DB_HOST'];"
  

内容的提问来源于stack exchange，提问作者mightycode Newton