我又掉 Laravel env 函数坑里了

哈哈,最近踩坑比较多啊,不过这次真的怪自己不细心看文档了。
事情是这样的,今天发现项目在执行定时任务的时候报错了,faild_jobs 中塞了好多错误记录,一看内容全是 "JUHE_APPKEY_FOR_XXXX is null",这是我的物流查询 Job 里抛出的异常,当用 env('JUHE_APPKEY_FOR_XXXX') 读取 app_key 为空时就会抛出。但是 .env 里明明配置了就是没有。

其实之前出现过一回,但是由于没有固定重现也就没有重视这事儿,今天终于花时间去搞定了,花了半小时终于锁定了重现步骤:config:cache 后就肯定读不到了,config:clear 后就可以了,当然这里有一个前提,调用 env 函数的地方是在业务代码里,而非 config/* 文件中。

然后我去翻了一下文档,发现其实在 Laravel 的 5.2 升级日志中有这么一段:

If you are using the config:cache command during deployment, you must make sure that you are only calling the env function from within your configuration files, and not from anywhere else in your application.

If you are calling env from within your application, it is strongly recommended you add proper configuration values to your configuration files and call env from that location instead, allowing you to convert your env calls to config calls.

其实就是下面这段代码的意思,相信聪明的你一眼就看懂了:

file

这是框架核心启动文件类 Illuminate\Foundation\Bootstrap\LoadEnvironmentVariables::boot 方法,从 20 行我们可以发现,一旦缓存了配置以后,就不会再从 .env 文件加载内容了,所以你在业务代码中使用 env 函数时已经无法读取 .env 中设定的内容了,但是其它环境变量不影响哦。那为啥配置文件的可以呢?因为配置文件缓存的时候会加载 .env 然后读取值缓存配置内容。

那怎么办呢?上面的官方说明已经告诉我们了:在配置文件创建对应的配置项,比如我们第三方服务可以放到 config/services.php 中,在配置里使用 env 读取,然后把从 env 函数读取的地方改成 config('services.juhe.app_key') 这样来避免这个问题。

其实作者这样做是有道理的,毕竟 .env 文件是文本内容,解析它的成本还是挺高的。所以请小心不要入这个坑哦。

本作品采用《CC 协议》,转载必须注明作者和本文链接
本帖由 Summer 于 3年前 加精
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 14

已经在文档中 get 到此技能 ,文档中说,请不要在config 目录的其他地方使用env函数

3年前 评论

看来我平时的习惯还是挺好的,我从来都是config里用env,其他地方用config

3年前 评论

@klgd 哈哈,有时候就是偷懒进坑了

3年前 评论

记得又一次 .env里面写的小写 到config里面用的大写,死活拿不到值。。。。

3年前 评论

@纸牌屋弗兰克 哈哈,果然不少人都进了这个坑

3年前 评论

已经在文档中 get 到此技能 ,文档中说,请不要在config 目录的其他地方使用env函数

3年前 评论

我踩过一次 getenv()env() 返回值分别为 空字串 和 null 的坑

2年前 评论

学到了,不然真的要被坑死,两三个项目有这样的情况

1年前 评论

刚刚也碰到这个问题了 :joy:学习了

1年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!