# 4.6 配置
配置是框架的重要组成部分,MSF框架的配置组件采用了第三方的[hassankhan/config](https://github.com/hassankhan/config),它支持多种配置书写的文件格式如:PHP,INI,XML,JSON,YAML,可以满足大部分的配置需求。但是建议采用PHP数组文件来配置我们的服务。
## PHP配置数组文件
配置采用PHP数组的形式进行书写,每个配置文件的最后一行都需要返回,即`return $config`,如:
```php
<?php
/**
* MongoDb配置文件
*
* @author camera360_server@camera360.com
* @copyright Chengdu pinguo Technology Co.,Ltd.
*/
$config['mongodb']['test']['server'] = 'mongodb://192.168.1.106:27017';
$config['mongodb']['test']['options'] = ['connect' => true];
$config['mongodb']['test']['driverOptions'] = [];
return $config;
````
## 配置目录
在应用程序的主目录中有`config`目录,是用来存放所有配置文件,配置目录的参考结构:
```
├── config // 配置目录
│ ├── check.php // 代码检查配置
│ ├── server.php // 主配置文件（server服务相关）
│ ├── constant.php // 业务常量定义文件
│ ├── log.php // 全局日志配置
│ ├── http.php // HTTP服务配置
│ ├── params.php // 全局业务配置（和运行环境无关）
│ ├── dev // 研发联调环境特殊配置目录
│ ├── docker // docker环境特殊配置目录
│ ├── product // 生产环境特殊配置目录
│ ├── qa // QA环境特殊配置目录
```
对于各个环境的差异配置,单独存在在不同的目录中,如:
`config/docker` 存放Docker环境配置
`config/dev` 存放研发联调环境配置
`config/qa` 存放QA环境配置
`product` 存放生产环境配置
## 主配置文件
是配置服务实例的大部分配置,包括Http Server的参数配置,服务器进程pid文件目录,服务进程名称,服务器worker、Task、reactor数量等等。
### 主配置重要选项说明
#### $config['server']
- $config['server']['process_title']
server服务进程标题前缀
- $config['server']['runtime_path']
server服务运行时目录
- $config['server']['pid_path']
server服务运行时pid目录
- $config['server']['route_tool']
server服务路由分发请求的类名,首先查找app\Route目录,再查到php-msf\src\Route目录,默认为`NormalRoute`
#### $config['server']['set']
- $config['server']['set']['reactor_num']
swoole server的reactor数量,更多请参考[reactor_num](https://wiki.swoole.com/wiki/page/281.html)
- $config['server']['set']['worker_num']
swoole server的worker数量,更多请参考[worker_num](https://wiki.swoole.com/wiki/page/275.html)
- $config['server']['set']['backlog']
swoole server的backlog队列长度,更多请参考[backlog](https://wiki.swoole.com/wiki/page/279.html)
- $config['server']['set']['dispatch_mode']
swoole server的数据包分发策略,对于http服务器推荐设置为1,更多请参考[dispatch_mode](https://wiki.swoole.com/wiki/page/277.html)
- $config['server']['set']['task_worker_num']
swoole server的task worker数量,更多请参考[task_worker_num](https://wiki.swoole.com/wiki/page/276.html)
swoole server的其他配置项,具体参考:[配置选项](https://wiki.swoole.com/wiki/page/274.html)
#### $config['config_manage_enable']
是否启动配置进程,设置为true或者false
#### $config['auto_reload_enable']
是否开启自动检测文件更新,并重启服务,在开发环境建议设置为true,生产环境设置为false
#### $config['user_timer_enable']
是否开启自定义业务Timer进程，为业务需求而定，主要用于一些定时业务，设置为true或者false
#### $config['http_server']
Http服务器相关配置,主要有以下几个重要子配置项
- $config['http_server']['port']
Http服务器监听的端口
- $config['http_server']['socket']
Http服务器监听的地址
#### $config['http']
- $config['http']['domain']
使用Http服务器时,绑定的域名列表
- $config['http']['domain']['localhost']
使用Http服务器时,绑定一个localhost的域名
- $config['http']['domain']['localhost']['root']
使用Http服务器时,绑定了一个localhost的域名,并且域名对应的根目录为此配置项的值，需要特别注意的是，一旦配置了root，那该目录下所有文件就可以被用户访问到
- $config['http']['domain']['localhost']['index']
使用Http服务器时,绑定了一个localhost的域名,并且域名对应的索引文件此配置项的值
- $config['http']['default_method']
使用Http服务器时,Controller的默认方法名,在路由请求时使用
## 日志配置
```php
<?php
/**
* 日志配置文件
*
* @author camera360_server@camera360.com
* @copyright Chengdu pinguo Technology Co.,Ltd.
*/
$config['server']['log'] = [
'handlers' => [
'application' => [
'levelList' => [
\PG\Log\PGLog::EMERGENCY,
\PG\Log\PGLog::ALERT,
\PG\Log\PGLog::CRITICAL,
\PG\Log\PGLog::ERROR,
\PG\Log\PGLog::WARNING
],
'dateFormat' => "Y/m/d H:i:s",
'format' => "%datetime% [%level_name%] [%channel%] [logid:%logId%] %message%\n",
'stream' => RUNTIME_DIR . '/application.log',
'buffer' => 0,
],
'notice' => [
'levelList' => [
\PG\Log\PGLog::NOTICE,
\PG\Log\PGLog::INFO,
\PG\Log\PGLog::DEBUG
],
'dateFormat' => "Y/m/d H:i:s",
'format' => "%datetime% [%level_name%] [%channel%] [logid:%logId%] %message%\n",
'stream' => RUNTIME_DIR . '/notice.log',
'buffer' => 0,
]
]
];
return $config;
```
更新配置示例请参考示例项目[php-msf-demo/config](https://github.com/pinguo/php-msf-demo/blob/master/config/log.php)
## 使用配置
在任何地方都可以通过`getInstance()->config`来访问读取配置,另外在继承`\PG\MSF\Base\Core`类的子类（比如Controller/Model等等）都可以通过`$this->getConfig()`来获取配置对象,访问配置项的代码如:
[php-msf/config/params.php](https://github.com/pinguo/php-msf/pinguo/config/params.php)
```php
<?php
/**
* 业务参数
*
* @author camera360_server@camera360.com
* @copyright Chengdu pinguo Technology Co.,Ltd.
*/
$config['params']['mock_ids'] = [
'581af00d4b58d59d22e8d7a6',
'581198754b58d54465ef4cad',
'580c7fa44b58d53f43e21c43',
'57ef6aec4b58d50d24e21a2a',
'57ee28ed4b58d52f24e21969',
'57eb6a484b58d50e3d078076',
'57e23b444b58d52f1e6689fc',
'57dfc9fc4b58d5581e668918',
'57de06b74b58d5471e66882f',
'57d8b78f4b58d5311e6686d5',
];
return $config;
```
```php
getInstance()->config->get('params.mock_ids', [])
```
get()方法的第一个参数为key名称,对于多维数组的配置,采用点分隔;第二个参数为配置选项默认值,即没有读取到配置时的默认配置。
- 0 文档说明
- 1 为什么研发新框架
- 1.1 传统php-fpm工作模式的问题
- 1.2 压测数据对比
- 1.3 小结
- 2 微服务框架研发概览
- 2.1 通信框架技术选型
- 2.2 swoole
- 2.3 协程原理
- 2.4 异步、并发
- 2.5 小结
- 3 框架运行环境
- 3.1 环境变量
- 3.2 运行代码
- 3.3 docker
- 3.4 小结
- 4 框架结构
- 4.1 结构概述
- 4.2 控制器
- 4.3 模型
- 4.4 视图
- 4.5 同步任务
- 4.6 配置
- 4.7 路由
- 4.8 小结
- 5 框架组件
- 5.1 协程
- 5.2 类的加载
- 5.3 异步Http Client
- 5.4 请求上下文
- 5.5 连接池
- 5.6 对象池
- 5.7 RPC
- 5.8 公共库
- 5.9 RESTful
- 5.10 多语言
- 5.11 杂项
- 5.12 小结
- 6 常见问题
- 7 附录