laravel 基础教程 —— 配置

laravel基础教程 —— 配置

所有配置文件都被保存在config目录下,并且每个配置文件里的配置项都有文档标注。

访问配置值

config 全局帮助方法被提供在vendor/laravel/framework/src/Illuminate/Foundation/helpers.php 文件中,该函数允许使用 . 语法来获取文件内的配置项值。

$value = config('app.timezone');

你也可以在config函数传递第二个参数作为默认值,当找不到该配置项时返回默认值.

$value = config('app.timezone', 'Asia/Shanghai');

设置配置项的值:

config(['app.timezone' => 'Asia/Shanghai']);

环境配置

我们经常希望开发环境和生产环境具有不同的配置。比如说你在本地开发环境使用不同的缓存驱动,而laravel基于环境的配置使之非常容易。

laravel使用了DotEnv类库来构建基于环境的配置,默认的基于环境的配置信息在根目录下的.env文件中,如果你是通过composer的方式安装的laravel,那么它会自动的将.env.example文件复制并重命名为.env, 如果不是你则需要手动做了。如果你每增加一个基于环境的配置项,你最好在.env.example中增加相同的配置项,这样在多人协作中别人可以根据.env.example理解你的配置信息.

每当程序接收到request请求时,应用程序会自动装载.env文件,并将配置信息封装在全局变量$_ENV中,当然你也可以通过全局辅助函数env()来进行获取环境配置项信息并将其设置在你的其它配置文件中,事实上,laravel已经在部分配置文件中使用这种这种方式进行配置。

'debug' => env('APP_DEBUG', false),

env函数中的第二个参数为配置项的默认值,当环境配置文件.env中没有该配置项时会自动使用默认值。

另外你的.env配置环境不应该提交到版本控制器中,因为其它服务器环境或者开发者环境可能需要引入不同的环境配置。比如生产环境不应该开启debug, 不同的开发者的本地数据库配置信息可能不同。

如果你是在一个团队中做开发,你应该在.env.example文件中引入你增加的环境配置信息,并提交给其它开发者知道,这样他们就能够理解使用你开发的部分应该引入哪些配置信息。

确定当前环境

当前环境是定义在.env文件中的APP_ENV变量里的,你可以通过App facadeenvironment 函数来获取:

$environment = App::environment();

当然你也可以通过 全局方法 envapp 来获取:

$environment = env('APP_ENV');
# or
$environment = app()->environment();

有时候我们需要特别识别一下当前环境是哪种环境,并根据不同的环境执行不同的业务逻辑,这时候就需要通过environment函数来进行判断匹配了,当然你可以在其中传递一个或多个环境参数,只要匹配到其中任何一个都会返回true:

if (App::environment('local')) {
  // if env('APP_ENV') === 'local'
}

if (App::environment('local', 'staging')) {
  // env('APP_ENV') === 'local' || env('APP_ENV') === 'staging'
}

缓存配置信息

config目录下有很多配置文件,配置文件中有不同的配置信息,为了启动程序更为迅速,我们可以在开发环境中将这些配置信息集中到一个配置文件中,这样,程序在被访问时,不会每次都要加载N个文件了,我们可以通过artisanconfig:cache命令 来做这件事情。所有配置文件被整合在一个文件里并被程序自动加载。

当然,在开发环境并不建议这么做,因为开发环境我们可能会频繁的更改配置信息,这样为了使配置信息及时生效我们不得不频繁的运行 php artisan config:cache命令, 偶尔我们会忘记执行命令。生产环境缓存配置文件应该是常态,并且应该在版本发布时执行缓存配置文件命令重新生成缓存配置信息。你应该将其做为自动发布的一部分。

维护模式

laravel提供了维护模式,维护模式在开启时,所有的访问请求都会被返回某个视图,这个视图是可以自定义的。如果维护模式开启,则每个请求都会返回 503 状态码。
开启维护模式的方法:

php artisan down

关闭维护模式的方法:

php artisan up

维护模式响应模板

维护模式响应的视图模板存放在resources/views/errors/503.blade.php, 你可以自由的修改。

维护模式 & 队列

在维护模式开启时,队列工作将会暂停执行,当维护模式关闭时,队列将继续进行处理工作。

备选方案到维护模式

由于开启维护模式需要关闭应用程序一段时间,所以你也许可以考虑像Envoyer这种不需要关闭应用程序的持续集成服务。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,793评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,567评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,342评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,825评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,814评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,680评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,033评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,687评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,175评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,668评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,775评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,419评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,020评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,206评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,092评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,510评论 2 343

推荐阅读更多精彩内容