vlucas/phpdotenv安装报错主因是版本、php版本、扩展、加载方式四点未对齐：php 7.4需用^4.3版，≥8.0才可用^5.0；必须启用mbstring和fileinfo扩展；应调用dotenv::createimmutable(__dir__)且确保.env在正确路径并早于业务代码加载。
直接装 vlucas/phpdotenv 就行，但版本、PHP 版本、扩展、加载方式这四点没对齐，90% 的报错都出在这儿。
PHP 版本和 Dotenv 版本必须匹配
新版 vlucas/phpdotenv:^5.0 要求 PHP ≥ 8.0；如果你用的是 PHP 7.4（比如 CentOS 7 默认源或某些 Docker 镜像），composer require vlucas/phpdotenv 会直接失败，报 Your requirements could not be resolved 或提示不兼容。
- 先确认 PHP 版本：
php -v - PHP 7.4 只能装
vlucas/phpdotenv:^4.3（不是^4.0，4.0 不支持 PHP 7.4 的某些 mbstring 行为） - 显式指定旧版命令：
composer require vlucas/phpdotenv:^4.3 - 别指望 Composer 自动降级——它不会替你做兼容性判断
mbstring 和 fileinfo 扩展缺一不可
vlucas/phpdotenv 在 v4+ 中强制依赖 mbstring，v5+ 还额外需要 fileinfo。缺任何一个，load() 时会静默失败或抛出 Dotenv\Exception\InvalidPathException，而不是明确说“扩展没开”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查是否启用：
php -m | grep -E '^(mbstring|fileinfo)$' - 没看到就去
php.ini解开对应行：extension=mbstring、extension=fileinfo - 改完记得重启 PHP-FPM 或 Apache，CLI 和 Web 环境的
php.ini可能不同
加载代码写错，类就找不到
很多人在入口文件里手动 require_once 'vendor/autoload.php'，再调 Dotenv::createImmutable()，结果报 Class 'Dotenv\Dotenv' not found。
- 根本原因：Composer 自动加载机制没被触发，或者命名空间写错（比如写成
Dotenv\dotenv） - 正确做法是直接 new 实例：
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__); - v5+ 推荐用
createImmutable()，v4 也支持；别用已废弃的new Dotenv()构造函数 - 别在子目录下执行
composer require，否则 autoload 生成路径错位，类加载器找不到文件
.env 文件读不到？三处最容易漏
没报错，但 $_SERVER['DB_HOST'] 是空的——这种“静默失效”最让人抓狂。
-
createImmutable(__DIR__)只查当前目录下的.env，不会往上找。入口在public/index.php？那.env得放在public/目录里，或把路径改成dirname(__DIR__) - Linux/macOS 下检查权限：
ls -l .env，Web 用户（如www-data）必须有读权限；建议chmod 600 .env - 加载时机必须早于任何使用环境变量的代码。比如 Laravel 在
bootstrap/app.php开头就做了，你自己搭框架时容易把它塞到中间甚至结尾
最常被忽略的是：.env 文件不能提交进 Git，哪怕写了 .gitignore，也得用 git rm --cached .env 清掉历史记录——密钥一旦进过仓库，就得当已泄露处理。
