TP5学习（二）：配置

在TP5中，一般来说应用的配置文件是自动加载的，加载的顺序是：

惯例配置->应用配置->场景配置->模块配置->动态配置

惯例配置

框架内置有一个惯例配置文件（位于thinkphp/convention.php），按照大多数的使用对常用参数进行了默认配置。

所以，对于应用的配置文件，往往只需要配置和惯例配置不同的或者新增的配置参数，如果你完全采用默认配置，甚至可以不需要定义任何配置文件。

应用配置

应用配置文件是应用初始化的时候首先加载的公共配置文件，默认位于application/config.php。

场景配置

每个应用都可以在不同的情况下设置自己的状态（或者称之为应用场景），并且加载不同的配置文件。

举个例子，你需要在公司和家里分别设置不同的数据库测试环境。那么可以这样处理，在公司环境中，我们在应用配置文件中配置：

'app_status'=>'office'

那么就会自动加载该状态对应的配置文件（默认位于application/office.php）。

如果我们回家后，我们修改定义为：

'app_status'=>'home'

那么就会自动加载该状态对应的配置文件（位于application/home.php）。

模块配置

每个模块会自动加载自己的配置文件（位于application/当前模块名/config.php）。

模块还可以支持独立的状态配置文件，命名规范为：application/当前模块名/应用状态.php。

如果你的应用的配置文件比较大，想分成几个单独的配置文件或者需要加载额外的配置文件的话，可以考虑采用动态配置（参考后面的描述）。

动态配置

加载配置文件：

Config::load('配置文件名');

配置文件一般位于APP_PATH目录下面，如果需要加载其它位置的配置文件，需要使用完整路径，例如：

Config::load(APP_PATH.'config/config.php')

系统默认的配置定义格式是PHP返回数组的方式，例如：

return [
    '配置参数1'=>'配置值',
    '配置参数1'=>'配置值',
    // ... 更多配置
 ];

如果你定义格式是其他格式的话，可以使用parse方法来导入，例如：

Config::parse(APP_PATH.'my_config.ini','ini');
Config::parse(APP_PATH.'my_config.xml','xml');

parse方法的第一个参数需要传入完整的文件名或者配置内容。

如果不传入第二个参数的话，系统会根据配置文件名自动识别配置类型

parse方法除了支持读取配置文件外，也支持直接传入配置内容，例如：

$config = 'var1=val
var2=val';
Config::parse($config,'ini');

支持直接传入配置文件内容的时候 第二个参数必须显式指定。

标准的ini格式文件定义：

配置参数1=配置值
配置参数2=配置值

标准的xml格式文件定义

<config>
 <var1>val1</var1>
 <var2>val2</var2>
 </config>

读取配置

设置完配置参数后，就可以使用get方法读取配置了，例如：

echo Config::get('配置参数1');

系统定义了一个助手函数config，以上可以简化为：

echo config('配置参数1');

读取所有的配置参数：

dump(Config::get());
 // 或者 dump(config());

或者你需要判断是否存在某个设置参数：

Config::has('配置参数2');
// 或者 config('?配置参数2');

如果需要读取二级配置，可以使用：

echo Config::get('配置参数.二级参数');
echo config('配置参数.二级参数');

系统不支持二级以上的配置参数读取，需要手动分步骤读取。

有作用域的情况下，仍然支持二级配置的操作。

设置配置参数

使用set方法动态设置参数，例如：

Config::set('配置参数','配置值');
// 或者使用助手函数
config('配置参数','配置值');

也可以批量设置，例如：

Config::set([
    '配置参数1'=>'配置值',
    '配置参数2'=>'配置值'
]);
// 或者使用助手函数
config([
    '配置参数1'=>'配置值',
    '配置参数2'=>'配置值'
]);

配置作用域

配置参数支持作用域的概念，默认情况下，所有参数都在同一个系统默认作用域下面。如果你的配置参数需要用于不同的项目或者相互隔离，那么就可以使用作用域功能，作用域的作用好比是配置参数的命名空间一样。

// 导入my_config.php中的配置参数，并纳入user作用域
Config::load('my_config.php','','user'); 
// 解析并导入my_config.ini 中的配置参数，读入test作用域
Config::parse('my_config.ini','ini','test'); 
// 设置user_type参数，并纳入user作用域
Config::set('user_type',1,'user'); 
// 批量设置配置参数，并纳入test作用域
Config::set($config,'test'); 
// 读取user作用域的user_type配置参数
echo Config::get('user_type','user'); 
// 读取user作用域下面的所有配置参数
dump(Config::get('','user')); 
dump(config('',null,'user')); // 同上
// 判断在test作用域下面是否存在user_type参数
Config::has('user_type','test'); 

可以使用range方法切换当前配置文件的作用域，例如：

Config::range('test');

环境变量配置

在开发过程中，可以在应用根目录下面的.env来模拟环境变量配置，.env文件中的配置参数定义格式采用ini方式，例如：

app_debug =  true
app_trace =  true

如果部署环境单独配置了环境变量，那么就需要删除.env配置文件，避免冲突。

环境变量配置的参数会全部转换为大写，值为 null，no 和 false 等效于 “”，值为 yes 和 true 等效于 “1”。

ThinkPHP5.0默认的环境变量前缀是PHP_，也可以通过改变ENV_PREFIX常量来重新设置。

环境变量不支持数组参数，如果需要使用数组参数可以，使用下划线分割定义配置参数名：

database_username =  root
database_password =  123456

或者使用

[database]
username =  root
password =  123456

获取环境变量的值可以使用下面的两种方式获取：

Env::get('database.username');
Env::get('database.password');
// 同时下面的方式也可以获取
Env::get('database_username');
Env::get('database_password');

可以支持默认值，例如：

// 获取环境变量 如果不存在则使用默认值root
Env::get('database.username','root');

可以直接在应用配置中使用环境变量，例如：

return [
    'hostname'  =>  Env::get('hostname','127.0.0.1'),
];

环境变量中设置的app_debug和app_trace参数会自动生效（优先于应用的配置文件），其它参数则必须通过Env::get方法才能读取。