ThinkPHP5——7 TP5框架配置類文件Config.php源碼分析

一、TP5配置類文件Config.php
Config.php文件位於框架目錄thinkphp下的library目錄下的think目錄下，完整路徑是thinkphp\library\think\Config.php

    <?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2018 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <[email protected]>
// +----------------------------------------------------------------------

namespace think;

class Config
{
    /**
     * @var array 配置參數
     * 僅限該類中的方法用 self::靜態成員 訪問
     */
    private static $config = [];

    /**
     * @var string 參數作用域
     * 僅限該類中的方法用 self::靜態成員 訪問
     */
    private static $range = '_sys_';

    /**
     * 設定配置參數的作用域
     * @access public
     * @param  string $range 作用域
     * @return void
     * 外部通過 Config::靜態成員 訪問
     */
    public static function range($range)
    {
        // 給私有屬性$range賦值
        self::$range = $range;

        if (!isset(self::$config[$range])) self::$config[$range] = [];
    }

    /**
     * 解析配置文件或內容
     * @access public
     * @param  string $config 配置文件路徑或內容 （必須）
     * @param  string $type   配置解析類型   xml或者json 格式
     * @param  string $name   配置名（如設置即表示二級配置）
     * @param  string $range  作用域
     * @return mixed
     * 外部通過 Config::靜態成員 訪問
     */
    public static function parse($config, $type = '', $name = '', $range = '')
    {
        $range = $range ?: self::$range;

        if (empty($type)) $type = pathinfo($config, PATHINFO_EXTENSION);

        $class = false !== strpos($type, '\\') ?
            $type :
            '\\think\\config\\driver\\' . ucwords($type);

        return self::set((new $class())->parse($config), $name, $range);
    }

    /**
     * 加載配置文件（PHP格式）
     * @access public
     * @param  string $file  配置文件名
     * @param  string $name  配置名（如設置即表示二級配置）
     * @param  string $range 作用域
     * @return mixed
     * 外部通過 Config::靜態成員 訪問
     */
    public static function load($file, $name = '', $range = '')
    {
        $range = $range ?: self::$range;

        if (!isset(self::$config[$range])) self::$config[$range] = [];

        if (is_file($file)) {
            $name = strtolower($name);
            $type = pathinfo($file, PATHINFO_EXTENSION);

            if ('php' == $type) {
                return self::set(include $file, $name, $range);
            }

            if ('yaml' == $type && function_exists('yaml_parse_file')) {
                return self::set(yaml_parse_file($file), $name, $range);
            }

            return self::parse($file, $type, $name, $range);
        }

        return self::$config[$range];
    }

    /**
     * 檢測某個配置項是否存在
     * @access public
     * @param  string $name 配置參數名（支持二級配置 . 號分割）
     * @param  string $range  作用域
     * @return bool  存在配置項返回true，否則false
     * 外部通過 Config::靜態成員 訪問
     */
    public static function has($name, $range = '')
    {
        $range = $range ?: self::$range;

        if (!strpos($name, '.')) {
            return isset(self::$config[$range][strtolower($name)]);
        }

        // 二維數組設置和獲取支持
        $name = explode('.', $name, 2);
        return isset(self::$config[$range][strtolower($name[0])][$name[1]]);
    }

    /**
     * 獲取配置參數 爲空則獲取所有配置 不傳入參數獲取所有配置
     * @access public
     * @param  string $name 配置參數名（支持二級配置 . 號分割）
     * @param  string $range  作用域
     * @return mixed
     * 外部通過 Config::靜態成員 訪問
     */
    public static function get($name = null, $range = '')
    {
        $range = $range ?: self::$range;

        // 無參數時獲取所有
        if (empty($name) && isset(self::$config[$range])) {
            return self::$config[$range];
        }

        // 非二級配置時直接返回
        if (!strpos($name, '.')) {
            $name = strtolower($name);
            return isset(self::$config[$range][$name]) ? self::$config[$range][$name] : null;
        }

        // 二維數組設置和獲取支持
        $name    = explode('.', $name, 2);
        $name[0] = strtolower($name[0]);

        if (!isset(self::$config[$range][$name[0]])) {
            // 動態載入額外配置
            $module = Request::instance()->module();
            $file   = CONF_PATH . ($module ? $module . DS : '') . 'extra' . DS . $name[0] . CONF_EXT;

            is_file($file) && self::load($file, $name[0]);
        }

        return isset(self::$config[$range][$name[0]][$name[1]]) ?
            self::$config[$range][$name[0]][$name[1]] :
            null;
    }

    /**
     * 設置配置參數 name 爲數組則爲批量設置
     * @access public
     * @param  string|array $name  配置參數名（支持二級配置 . 號分割）
     * @param  mixed        $value 配置值
     * @param  string       $range 作用域
     * @return mixed
     * 外部通過 Config::靜態成員 訪問
     */
    public static function set($name, $value = null, $range = '')
    {
        $range = $range ?: self::$range;

        if (!isset(self::$config[$range])) self::$config[$range] = [];

        // 字符串則表示單個配置設置
        if (is_string($name)) {
            if (!strpos($name, '.')) {
                self::$config[$range][strtolower($name)] = $value;
            } else {
                // 二維數組
                $name = explode('.', $name, 2);
                self::$config[$range][strtolower($name[0])][$name[1]] = $value;
            }

            return $value;
        }

        // 數組則表示批量設置
        if (is_array($name)) {
            if (!empty($value)) {
                self::$config[$range][$value] = isset(self::$config[$range][$value]) ?
                    array_merge(self::$config[$range][$value], $name) :
                    $name;

                return self::$config[$range][$value];
            }

            return self::$config[$range] = array_merge(
                self::$config[$range], array_change_key_case($name)
            );
        }

        // 爲空直接返回已有配置
        return self::$config[$range];
    }

    /**
     * 重置配置參數
     * @access public
     * @param  string $range 作用域
     * @return void
     * 外部通過 Config::靜態成員 訪問
     */
    public static function reset($range = '')
    {
        $range = $range ?: self::$range;

        if (true === $range) {
            self::$config = [];
        } else {
            self::$config[$range] = [];
        }
    }
}