最近在工作中遇到一个问题,不知道大家有没有遇到过,在 Laravel中(除 app/config 目录下的配置文件中)使用env函数读取环境变量,有时有用,有时返回 null,这究竟怎么回事?下面通过这篇文章让我们一探究竟。有需要的朋友们下面来一起看看吧。
发现问题
在 Laravel 项目中,如果执行了 php artisan config:cache
命令把配置文件缓存起来后,在 Tinker 中(Tinker 是 Laravel 自带的一个交互式命令行界面),使用 env
函数读取环境变量的值为 null
,只有执行 php artisan config:clear
清除配置缓存后就可以读取了,这是为什么呢?
一探究竟
打开 .env 文件看,这些都是有值的:
APP_ENV=local
APP_KEY=base64:JHE5bOkRg283uT0n1Zq/GgvGEer8ooYiB42/wIcCyvo=
APP_DEBUG=true
APP_LOG_LEVEL=debug
APP_URL=http://www.test.me
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=test_me
DB_USERNAME=homestead
DB_PASSWORD=secret
原因何在?
在 Laravel 中,如果执行 php aritisan config:cache
命令,Laravel 将会把 app/config 目录下的所有配置文件“编译”整合成一个缓存配置文件到 bootstrap/cache/config.php,每个配置文件都可以通过 env
函数读取环境变量,这里是可以读取的。但是一旦有了这个缓存配置文件,在其他地方使用 env
函数是读取不到环境变量的,所以返回 null
.
让我们看看这段代码,Illuminate/Foundation/Bootstrap/DetectEnvironment.php line 18
:
public function bootstrap(Application $app)
{
if (! $app->configurationIsCached()) {
$this->checkForSpecificEnvironmentFile($app);
try {
(new Dotenv($app->environmentPath(), $app->environmentFile()))->load();
} catch (InvalidPathException $e) {
//
}
}
}
这个方法在框架启动后就会运行,这段代码说明了如果存在缓存配置文件,就不会去设置环境变量了,配置都读缓存配置文件,而不会再读环境变量了。
因此,在配置文件即 app/config 目录下的其他地方,读取配置不要使用 env
函数去读环境变量,这样你一旦执行 php artisan config:cache
之后,env
函数就不起作用了。所有要用到的环境变量,在 app/config 目录的配置文件中通过 env 读取,其他地方要用到环境变量的都统一读配置文件而不是使用 env
函数读取。