PHP Dotenv 加载 .env 文件时类型错误，如何轻松修复？

PHP Dotenv：修复类型错误，轻松加载 .env 文件

简介

在使用 PHP Dotenv 库加载 .env 文件时，你可能会遇到一个恼人的类型错误：

Fatal error: Uncaught TypeError: Dotenv\Dotenv::__construct(): Argument #1 ($store) must be of type Dotenv\Store\StoreInterface, string given

本文将深入探讨此错误及其解决方法，确保你能够无缝地加载 .env 文件。

问题诊断

此错误表明你在使用 Dotenv 库时，将一个字符串而不是实现 Dotenv\Store\StoreInterface 接口的对象传递给了构造函数。这是由于 PHP 8.1 中引入的严格类型提示。

解决方案

为了解决此问题，我们需要使用 Dotenv\Dotenv::createImmutable() 方法，而不是 new Dotenv\Dotenv() 构造函数。

$dotEnv = Dotenv\Dotenv::createImmutable(BASE_PATH);

Dotenv\Dotenv::createImmutable() 方法会自动实例化一个 Dotenv\Store\FileStore 对象，该对象实现了 Dotenv\Store\StoreInterface 接口。

替代方法

如果你使用的是 Dotenv 库的旧版本，你可以将 $store 参数显式地强制转换为 StoreInterface 对象。例如：

$store = new Dotenv\Store\FileStore(BASE_PATH);
$dotEnv = new Dotenv\Dotenv($store);

注意事项

• 确保你使用的是 Dotenv 库的最新版本。
• 如果更新 Dotenv 库后问题仍然存在，请清除应用程序缓存。
• 有关更多信息，请参阅 Dotenv 库的官方文档：https://github.com/vlucas/phpdotenv

结论

通过遵循本文中的步骤，你可以轻松修复 PHP Dotenv 类型错误，并开始加载 .env 文件。记住，使用 Dotenv\Dotenv::createImmutable() 方法是推荐的方法。

常见问题解答

1. 为什么会出现这个类型错误？
   答：由于 PHP 8.1 中引入了严格类型提示，你需要将一个实现 Dotenv\Store\StoreInterface 接口的对象传递给 Dotenv 构造函数。

2. 如何使用 Dotenv\Dotenv::createImmutable() 方法？
   答：只需使用 Dotenv\Dotenv::createImmutable(BASE_PATH) 即可实例化 Dotenv 对象。

3. 可以显式地强制转换 $store 参数吗？
   答：可以，但仅适用于旧版本的 Dotenv 库。

4. 为什么清除应用程序缓存很重要？
   答：清除缓存可确保加载最新的 Dotenv 配置。

5. 我在哪里可以找到更多信息？
   答：请参阅 Dotenv 库的官方文档：https://github.com/vlucas/phpdotenv