当前位置：首页 > news >正文

Laravel|Lumen项目配置信息config原理

news 2025/7/12 13:17:51

介绍

Laravel 框架的所有配置文件都保存在 config 目录中。每个选项都有说明，你可随时查看这些文件并熟悉都有哪些配置选项可供你使用。

使用

您可以在应用程序的任何位置使用全局 config 辅助函数轻松访问配置值。可以使用“点”语法访问配置值，其中包括您希望访问的文件名和选项。也可以指定默认值，如果配置选项不存在，将返回：

$value = config('app.timezone');// 如果配置值不存在，则检索默认值...
$value = config('app.timezone', 'Asia/Seoul');

使用分析

我们可以先看一下助手函数 config

if (! function_exists('config')) {/*** Get / set the specified configuration value.** If an array is passed as the key, we will assume you want to set an array of values.** @param  array|string|null  $key* @param  mixed  $default* @return mixed*/function config($key = null, $default = null){if (is_null($key)) {return app('config');}if (is_array($key)) {return app('config')->set($key);}return app('config')->get($key, $default);}
}

分析

app(‘config’) 是注册到服务容器的实例,这里我们追踪到config 的实例是

Illuminate\Contracts\Config\Repository

Repository 的 set & get 方法代码如下

    /*** Set a given configuration value.** @param  array|string  $key* @param  mixed  $value* @return void*/public function set($key, $value = null){$keys = is_array($key) ? $key : [$key => $value];foreach ($keys as $key => $value) {Arr::set($this->items, $key, $value);}}/*** Get the specified configuration value.** @param  array|string  $key* @param  mixed  $default* @return mixed*/public function get($key, $default = null){if (is_array($key)) {return $this->getMany($key);}return Arr::get($this->items, $key, $default);}

这时我们就可以清晰的知道，助手函数config($key = null, $default = null)的含义：

如果$key 不传或者传null，返回的是注册到服务容器中Repository实例
如果$key 为数组，那么修改Repository 的 items的值
其他情况返回 Repository 的 items[$key] ?? $default

此时我们就可能有疑问 Repositiry 中 items 值是什么时候进行赋值的呢？赋的值又是那些呢？接下来我们一点点的分析

绑定服务容器

在laravel运行中，并没有直接绑定 Repositiry 到容器中，而是第一次构建config实例的时候进行了绑定，app(‘config’) 或者 app()->make(‘config’) 时检测是否进行绑定，如果没有的话进行绑定，下面时make函数：

    /*** Resolve the given type from the container.** @param  string  $abstract* @param  array  $parameters* @return mixed*/public function make($abstract, array $parameters = []){$abstract = $this->getAlias($abstract);if (! $this->bound($abstract) &&array_key_exists($abstract, $this->availableBindings) &&! array_key_exists($this->availableBindings[$abstract], $this->ranServiceBinders)) {$this->{$method = $this->availableBindings[$abstract]}();$this->ranServiceBinders[$method] = true;}return parent::make($abstract, $parameters);}

根据代码可知

$this->availableBindings['config'] = registerConfigBindings

registerConfigBindings函数即为绑定到容器方法

    /*** Register container bindings for the application.** @return void*/protected function registerConfigBindings(){$this->singleton('config', function () {return new ConfigRepository;});}

因此在调用make(‘config’) 时若没有绑定，自动调用registerConfigBindings方法进行绑定

配置文件赋值

在bootstrap/app.php中，进行对配置文件进行了赋值，譬如：

$app->configure('auth');
$app->configure('permission');
$app->configure('excel');
$app->configure('database');

configure函数为：

    /*** Load a configuration file into the application.** @param  string  $name* @return void*/public function configure($name){if (isset($this->loadedConfigurations[$name])) {return;}$this->loadedConfigurations[$name] = true;$path = $this->getConfigurationPath($name);if ($path) {$this->make('config')->set($name, require $path);}}