如何在Yii 2中通过dotenv正确加载.env.dev环境配置文件？

• 先确保自动加载器路径正确
  web目录下的index.php要加载项目根目录的vendor/autoload.php，必须使用相对路径__DIR__ . '/../vendor/autoload.php'，绝对路径也可，但相对路径更适配不同部署环境。

• 严格遵循加载顺序
  必须先加载composer的自动加载器，再初始化phpdotenv——因为phpdotenv是通过composer安装的，依赖autoload.php来引入类文件，反过来加载会直接触发找不到文件的致命错误。

• 完整的web/index.php修改示例

  // 优先加载composer自动加载器
  require __DIR__ . '/../vendor/autoload.php';
  
  // 加载Yii框架核心引导文件
  require __DIR__ . '/../vendor/yiisoft/yii2/Yii.php';
  
  // 初始化phpdotenv并加载指定的.env.dev文件
  $dotenv = Dotenv\Dotenv::createImmutable(__DIR__ . '/../env/dev/', '.env.dev');
  $dotenv->load();
  
  // 可选：验证必要的环境变量是否存在且非空
  $dotenv->required(['DB_HOST', 'DB_NAME', 'DB_USER', 'DB_PASSWORD'])->notEmpty();
  
  // 加载应用配置
  $config = require __DIR__ . '/../config/web.php';
  
  // 启动应用
  (new yii\web\Application($config))->run();
  

• 额外排查项

  • 确认已执行composer install或composer update，vendor目录完整且autoload.php文件存在
  • 检查.env.dev文件的权限，确保运行web服务的系统用户（如www-data、apache）有读取该文件的权限
  • 如果是控制台应用，调整路径时要对应：console/index.php中加载autoload的路径是__DIR__ . '/../vendor/autoload.php'，env文件路径为__DIR__ . '/../env/dev/.env.dev'

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