Lumen 6 中文文档 配置信息
介绍
Lumen框架的所有配置项都放置在了 .env
文件。
访问配置值
通过使用全局的辅助函数 config
,可以很容易在应用程序的任何地方访问配置项的值。 访问配置项的值可以使用「点」语法,其中包含了要访问的文件和选项的名称。还可以指定默认值,当访问的配置项不存在的时候,将会返回给定的默认值。
$value = config('app.locale');
以数组作为参数的方式传递给 config
辅助函数,可以动态的设置配置项的值。
config(['app.locale' => 'en']);
在配置文件生效之前,你首先应该使用 configure
方法将它加载到自己的应用程序中。这个加载过程可以在 bootstrap/app.php
文件中完成。
$app->configure('app');
环境配置
根据应用程序的运行环境的不同,设置不同的配置值的做法通常很有用。例如,你想在本地和生产环境中使用不同的缓存驱动,这个时候通过不同的环境配置很容易就可以实现。
Lumen 利用 Vance Lucas 的 PHP 库 DotEnv 使得此项功能的实现变得非常简单。在全新的 Lumen 根目录中,会包含一个 .env.example
文件。你应该将文件 .env.example
重命名为 .env
。
当应用程序收到请求时,.env 文件中列出的所有变量将被加载到 PHP 的超级全局变量 $_ENV 中。你可以使用 env
函数检索这些变量的值。
$debug = env('APP_DEBUG', true);
传递给 env
函数的第二个值是「默认值」。如果给定的键不存在于环境变量,则会使用该值。
不要将你的 .env
文件提交到代码管理中,因为每个开发人员或者服务器对应用程序的配置值可以能会有所不同。
如果你们是团队协作开发,你应该提交你的 .env.example
文件。通过在 .env.example
文件中给新增的配置项添加占位符值,可以让团队其他人员清晰的看到运行你提交的程序需要添加的配置项。
确定当前项
当前应用程序的运行环境,由 .env
文件中的环境变量 APP_ENV
决定的。可以使用应用程序实例调用 environment
方法来检索。
$environment = app()->environment();
你也可以传递参数给 environment
方法来检查是否与当前运行环境匹配。如果有需要,你还可以传递多个值给 environment
方法,如果当前环境与给定参数中的任何一个值匹配,则该方法将会返回 true
。
if (app()->environment('local')) {
// The environment is local
}
if (app()->environment('local', 'staging')) {
// The environment is either local OR staging...
}
猜你喜欢: