前言

本文主要介绍 laravel 加载 config 配置文件的相关源码。

config 配置文件的加载

config 配置文件由类 \Illuminate\Foundation\Bootstrap\LoadConfiguration::class 完成:

  1. class LoadConfiguration
  2. {
  3. public function bootstrap(Application $app)
  4. {
  5. $items = [];
  6. if (file_exists($cached = $app->getCachedConfigPath())) {
  7. $items = require $cached;
  8. $loadedFromCache = true;
  9. }
  10. $app->instance('config', $config = new Repository($items));
  11. if (! isset($loadedFromCache)) {
  12. $this->loadConfigurationFiles($app, $config);
  13. }
  14. $app->detectEnvironment(function () use ($config) {
  15. return $config->get('app.env', 'production');
  16. });
  17. date_default_timezone_set($config->get('app.timezone', 'UTC'));
  18. mb_internal_encoding('UTF-8');
  19. }
  20. }

可以看到,配置文件的加载步骤:

  • 加载缓存
  • 若缓存不存在,则利用函数 loadConfigurationFiles 加载配置文件
  • 加载环境变量、时间区、编码方式

函数 loadConfigurationFiles 用于加载配置文件:

  1. protected function loadConfigurationFiles(Application $app, RepositoryContract $repository)
  2. {
  3. foreach ($this->getConfigurationFiles($app) as $key => $path) {
  4. $repository->set($key, require $path);
  5. }
  6. }

加载配置文件有两部分:搜索配置文件、加载配置文件的数组变量值

搜索配置文件

getConfigurationFiles 可以根据配置文件目录搜索所有的 php 为后缀的文件,并将其转化为 files 数组,其 key 为目录名以字符 . 为连接的字符串 ,value 为文件真实路径:

  1. protected function getConfigurationFiles(Application $app)
  2. {
  3. $files = [];
  4. $configPath = realpath($app->configPath());
  5. foreach (Finder::create()->files()->name('*.php')->in($configPath) as $file) {
  6. $directory = $this->getNestedDirectory($file, $configPath);
  7. $files[$directory.basename($file->getRealPath(), '.php')] = $file->getRealPath();
  8. }
  9. return $files;
  10. }
  11. protected function getNestedDirectory(SplFileInfo $file, $configPath)
  12. {
  13. $directory = $file->getPath();
  14. if ($nested = trim(str_replace($configPath, '', $directory), DIRECTORY_SEPARATOR)) {
  15. $nested = str_replace(DIRECTORY_SEPARATOR, '.', $nested).'.';
  16. }
  17. return $nested;
  18. }

加载配置文件数组

加载配置文件由类 Illuminate\Config\Repository\LoadConfiguration 完成:

  1. class Repository
  2. {
  3. public function set($key, $value = null)
  4. {
  5. $keys = is_array($key) ? $key : [$key => $value];
  6. foreach ($keys as $key => $value) {
  7. Arr::set($this->items, $key, $value);
  8. }
  9. }
  10. }

加载配置文件时间上就是将所有配置文件的数值放入一个巨大的多维数组中,这一部分由类 Illuminate\Support\Arr 完成:

  1. class Arr
  2. {
  3. public static function set(&$array, $key, $value)
  4. {
  5. if (is_null($key)) {
  6. return $array = $value;
  7. }
  8. $keys = explode('.', $key);
  9. while (count($keys) > 1) {
  10. $key = array_shift($keys);
  11. if (! isset($array[$key]) || ! is_array($array[$key])) {
  12. $array[$key] = [];
  13. }
  14. $array = &$array[$key];
  15. }
  16. $array[array_shift($keys)] = $value;
  17. return $array;
  18. }
  19. }

例如 dir1.dir2.app ,配置文件会生成 $array[dir1][dir2][app] 这样的数组。

配置文件数值的获取

当我们利用全局函数 config 来获取配置值的时候:

  1. function config($key = null, $default = null)
  2. {
  3. if (is_null($key)) {
  4. return app('config');
  5. }
  6. if (is_array($key)) {
  7. return app('config')->set($key);
  8. }
  9. return app('config')->get($key, $default);
  10. }

配置文件的获取和加载类似,都是将字符串转为多维数组,然后获取具体数组值:

  1. public static function get($array, $key, $default = null)
  2. {
  3. if (! static::accessible($array)) {
  4. return value($default);
  5. }
  6. if (is_null($key)) {
  7. return $array;
  8. }
  9. if (static::exists($array, $key)) {
  10. return $array[$key];
  11. }
  12. foreach (explode('.', $key) as $segment) {
  13. if (static::accessible($array) && static::exists($array, $segment)) {
  14. $array = $array[$segment];
  15. } else {
  16. return value($default);
  17. }
  18. }
  19. return $array;
  20. }