# 配置
[TOC=2,3]
ThinkJS 提供了灵活的配置，可以在不同模式下使用不同的配置，且这些配置在服务启动时就已经生效，后续逻辑处理中可以直接使用这些配置。
`注意：不可将一个 http 请求中的私有值设置到配置中，这将会被下一个 http 设置的值给冲掉。`
## 项目环境
ThinkJS 默认支持 3 种项目环境，可以根据不同的环境进行配置，以满足不同情况下的配置需要。
* `development` 开发环境
* `testing` 测试环境
* `production` 线上环境
项目里也可以扩展其他的环境，当前使用哪种环境可以在 [入口文件](https://thinkjs.org/zh-CN/doc/2.0/app_structure.html#wwwindexjs) 中设置，设置 `env` 值即可。
## 定义配置文件
项目里可以设置公共配置文件和模块下的配置文件：
* 公共配置目录 `src/common/config`
* 模块配置目录 `src/[module]/config`
#### config/config.js
存放一些基本的配置，如：
~~~
export default {
port: 8360,
host: "",
encoding: "utf-8",
...
}
~~~
#### config/[name].js
存放具体功能的配置文件，如：`db.js` 为数据库配置，`redis` 为 redis 配置。
~~~
// db.js
export default {
type: "mysql",
host: "127.0.0.1",
port: "",
name: "",
user: "",
...
};
~~~
#### config/env/[mode].js
项目模式的配置，如：`env/development.js`，`env/testing.js`，`env/production.js`
~~~
//env/development.js
export default {
db: { //开发模式下数据库配置
type: "mysql",
host: "127.0.0.1",
port: "",
...
}
}
~~~
#### config/locale/[lang].js
国际化语言包配置，如： `locale/en.js`，`locale/zh-CN.js`。
* * *
配置格式采用 `key: value` 的形式，并且 `key` 不区分大小写。
## 加载配置文件
框架支持多种级别的配置文件，会按以下顺序进行读取：
`框架默认的配置 -> 项目模式下框架配置 -> 项目公共配置 -> 项目模式下的公共配置 -> 模块下的配置`
## 配置读取
### 通过 config 方法获取
在 Controller，Logic，Middleware 等地方可以通过 `this.config` 来获取。如：
~~~
let db = this.config("db"); //读取数据库的所有配置
let host = this.config("db.host"); //读取数据库的 host 配置，等同于 db.host
~~~
### 通过 http 对象上的 config 方法获取
http 对象也有 config 方法用来获取相关的配置，如：
~~~
let db = http.config("db");
~~~
### 其他地方配置读取
其他地方可以通过 `think.config` 来读取相关的配置：
~~~
let db = think.config("db"); //读取通用模块下的数据库配置
let db1 = think.config("db", undefined, "home"); //获取 home 模块下数据库配置
~~~
`注：` 路由解析前，无法通过 `config` 方法或者 http 对象上的 `config` 方法来获取非通用模块下的配置，所以路由解析前就使用的配置需要定义在通用模块里。
## 系统默认配置
### env
项目模式下的配置，`config/env/development.js`。
~~~
export default {
auto_reload: true,
log_request: true,
gc: {
on: false
},
error: {
detail: true
}
}
~~~
`config/env/testing.js` 和 `config/env/produciton.js` 无默认配置。
### locale
国际化语言包配置，默认的配置如下：
~~~
// config/locale/en.js
export default {
CONTROLLER_NOT_FOUND: "controller `%s` not found. url is `%s`.",
CONTROLLER_INVALID: "controller `%s` is not valid. url is `%s`",
ACTION_NOT_FOUND: "action `%s` not found. url is `%s`",
ACTION_INVALID: "action `%s` is not valid. url is `%s`",
WORKER_DIED: "worker `%d` died, it will auto restart.",
MIDDLEWARE_NOT_FOUND: "middleware `%s` not found",
ADAPTER_NOT_FOUND: "adapter `%s` not found",
GCTYPE_MUST_SET: "instance must have gcType property",
CONFIG_NOT_FUNCTION: "config `%s` is not a function",
CONFIG_NOT_VALID: "config `%s` is not valid",
PATH_EMPTY: "`%s` path muse be set",
PATH_NOT_EXIST: "`%s` is not exist",
TEMPLATE_NOT_EXIST: "can\"t find template file `%s`",
PARAMS_EMPTY: "params `%s` value can\"t empty",
PARAMS_NOT_VALID: "params `{name}` value not valid",
FIELD_KEY_NOT_VALID: "field `%s` in where condition is not valid",
DATA_EMPTY: "data can not be empty",
MISS_WHERE_CONDITION: "miss where condition",
INVALID_WHERE_CONDITION_KEY: "where condition key is not valid",
WHERE_CONDITION_INVALID: "where condition `%s`:`%s` is not valid",
TABLE_NO_COLUMNS: "table `%s` has no columns",
NOT_SUPPORT_TRANSACTION: "table engine is not support transaction",
DATA_MUST_BE_ARRAY: "data is not an array list",
PARAMS_TYPE_INVALID: "params `{name}` type invalid",
DISALLOW_PORT: "proxy on, cannot visit with port",
SERVICE_UNAVAILABLE: "Service Unavailable",
validate_required: "{name} can not be blank",
validate_contains: "{name} need contains {args}",
validate_equals: "{name} need match {args}",
validate_different: "{name} nedd not match {args}",
validate_after: "{name} need a date that\"s after the {args} (defaults to now)",
validate_alpha: "{name} need contains only letters (a-zA-Z)",
validate_alphaDash: "{name} need contains only letters and dashes(a-zA-Z_)",
validate_alphaNumeric: "{name} need contains only letters and numeric(a-zA-Z0-9)",
validate_alphaNumericDash: "{name} need contains only letters, numeric and dash(a-zA-Z0-9_)",
validate_ascii: "{name} need contains ASCII chars only",
validate_base64: "{name} need a valid base64 encoded",
validate_before: "{name} need a date that\"s before the {args} (defaults to now)",
validate_byteLength: "{name} need length (in bytes) falls in {args}",
validate_creditcard: "{name} need a valid credit card",
validate_currency: "{name} need a valid currency amount",
validate_date: "{name} need a date",
validate_decimal: "{name} need a decimal number",
validate_divisibleBy: "{name} need a number that\"s divisible by {args}",
validate_email: "{name} need an email",
validate_fqdn: "{name} need a fully qualified domain name",
validate_float: "{name} need a float in {args}",
validate_fullWidth: "{name} need contains any full-width chars",
validate_halfWidth: "{name} need contains any half-width chars",
validate_hexColor: "{name} need a hexadecimal color",
validate_hex: "{name} need a hexadecimal number",
validate_ip: "{name} need an IP (version 4 or 6)",
validate_ip4: "{name} need an IP (version 4)",
validate_ip6: "{name} need an IP (version 6)",
validate_isbn: "{name} need an ISBN (version 10 or 13)",
validate_isin: "{name} need an ISIN (stock/security identifier)",
validate_iso8601: "{name} need a valid ISO 8601 date",
validate_in: "{name} need in an array of {args}",
validate_notIn: "{name} need not in an array of {args}",
validate_int: "{name} need an integer",
validate_min: "{name} need an integer greater than {args}",
validate_max: "{name} need an integer less than {args}",
validate_length: "{name} need length falls in {args}",
validate_minLength: "{name} need length is max than {args}",
validate_maxLength: "{name} need length is min than {args}",
validate_lowercase: "{name} need is lowercase",
validate_mobile: "{name} need is a mobile phone number",
validate_mongoId: "{name} need is a valid hex-encoded representation of a MongoDB ObjectId",
validate_multibyte: "{name} need contains one or more multibyte chars",
validate_url: "{name} need an URL",
validate_uppercase: "{name} need uppercase",
validate_variableWidth: "{name} need contains a mixture of full and half-width chars",
validate_order: "{name} need a valid sql order string",
validate_field: "{name} need a valid sql field string",
validate_image: "{name} need a valid image file",
validate_startWith: "{name} need start with {args}",
validate_endWidth: "{name} need end with {args}",
validate_string: "{name} need a string",
validate_array: "{name} need an array",
validate_boolean: "{name} need a boolean",
validate_object: "{name} need an object"
}
~~~
### config
基本配置，`config/config.js`。
~~~
export default {
port: 8360, //服务监听的端口
host: "", //服务监听的 host
encoding: "utf-8", //项目编码
pathname_prefix: "", //pathname 去除的前缀，路由解析中使用
pathname_suffix: ".html", //pathname 去除的后缀，路由解析中使用
proxy_on: false, //是否使用 nginx 等 web server 进行代理
hook_on: true, //是否开启 hook
cluster_on: false, //是否开启 cluster
service_on: true, //Service available
timeout: 120, //120 seconds
auto_reload: false, //自动重新加载修改的文件，development 模式下使用
resource_on: true, // 是否处理静态资源请求， porxy_on 开启下可以关闭该配置
resource_reg: /^(static\/|[^\/]+\.(?!js|html)\w+$)/, //静态资源的正则
route_on: true, //是否开启自定义路由
log_pid: false, //是否记录服务的 pid
log_request: false, //是否打印请求的日志
create_server: undefined, //自定义启动服务
output_content: undefined, //自定义输出内容处理方式，可以进行 gzip 处理等
deny_module_list: [], //禁用的模块列表
default_module: "home", //默认模块
default_controller: "index", //默认的控制器
default_action: "index", //默认的 Action
callback_name: "callback", //jsonp 请求的 callback 名称
json_content_type: "application/json", //json 输出时设置的 Content-Type
subdomain: {} //子域名部署配置
}
~~~
### cache
缓存配置，`config/cache.js`。
~~~
export default {
type: "file", //缓存方式
prefix: "thinkjs_", //缓存名称前缀
timeout: 6 * 3600, //6 hours
path: runtimePrefix + "/cache", //文件缓存模式下缓存内容存放的目录
path_depth: 2, //子目录深度
file_ext: ".json" //缓存文件的扩展名
};
~~~
### cookie
cookie 配置，`config/cookie.js`。
~~~
export default {
domain: "", // cookie domain
path: "/", // cookie path
httponly: false, //是否 httponly
secure: false, //是否在 https 下使用
timeout: 0 //cookie 有效时间
};
~~~
### db
数据库配置，`config/db.js`。
~~~
export default {
type: "mysql", //数据库类型
host: "127.0.0.1", //数据库 host
port: "", //端口
name: "", //数据库名称
user: "", //账号
pwd: "", //密码
prefix: "think_", //数据表前缀
encoding: "utf8", //数据库编码
nums_per_page: 10, //一页默认条数
log_sql: true, //是否记录 sql 语句
log_connect: true, // 是否记录连接数据库的信息
cache: { // 查询数据缓存配置
on: true,
type: "",
timeout: 3600
}
};
~~~
### error
错误信息配置，`config/error.js`。
~~~
export default {
key: "errno", //error number
msg: "errmsg", //error message
value: 1000 //default errno
};
~~~
### gc
缓存、Session等垃圾处理配置，`config/gc.js`。
~~~
export default {
on: true, //是否开启垃圾回收处理
interval: 3600, // 处理时间间隔，默认为一个小时
filter: function(){ //如果返回 true，则进行垃圾回收处理
let hour = (new Date()).getHours();
if(hour === 4){
return true;
}
}
};
~~~
### hook
hook 配置，`config/hook.js`。
~~~
export default {
form_parse: ["parse_json_payload"],
resource_check: ["resource"],
resource_output: ["output_resource"],
route_parse: ["rewrite_pathname", "subdomain_deploy", "route"],
app_begin: ["check_csrf"],
view_init: [],
view_template: ["locate_template"],
view_parse: ["parse_template"],
view_filter: [],
view_end: ["write_html_cache"],
app_end: []
};
~~~
### post
post 请求时的配置，`config/post.js`。
~~~
export default {
json_content_type: ["application/json"],
max_file_size: 1024 * 1024 * 1024, //1G
max_fields: 100,
max_fields_size: 2 * 1024 * 1024, //2M,
ajax_filename_header: "x-filename",
file_upload_path: runtimePrefix + "/upload",
file_auto_remove: true
};
~~~
### redis
redis 配置，`config/redis.js`。
~~~
export default {
host: "127.0.0.1",
port: 6379,
password: "",
timeout: 0,
log_connect: true
};
~~~
### memcache
memcache 配置，`config/memcache.js`。
~~~
export default {
host: "127.0.0.1", //memcache host
port: 11211,
username: "", //
password: "",
timeout: 0, //缓存失效时间
log_connect: true
};
~~~
### session
session 配置，`config/session.js`。
~~~
export default {
name: "thinkjs",
type: "file",
path: runtimePrefix + "/session",
secret: "",
auth_key: "think_auth_list",
timeout: 24 * 3600,
cookie: { // cookie options
length: 32
}
};
~~~
### view
视图配置，`config/view.js`。
~~~
export default {
content_type: "text/html",
file_ext: ".html",
file_depr: "_",
root_path: "",
type: "ejs",
options: {}
};
~~~
### websocket
websocket 配置，`config/websocket.js`。
~~~
export default {
on: false, //是否开启 websocket
type: "think", //websocket 使用的库
allow_origin: "",
sub_protocal: "",
adapter: undefined,
path: "", //url path for websocket
messages: {
// open: "home/websocket/open",
}
};
~~~
## 扩展配置
项目里可以根据需要扩展配置，扩展配置只需在 `src/common/config/` 建立对应的文件即可，如：
~~~
// src/common/config/foo.js
export default {
name: "bar"
}
~~~
这样就可以通过 `think.config('foo')` 来获取对应的配置了。
- 快速入门
- 介绍
- 创建项目
- 项目结构
- 代码规范
- 升级指南
- 进阶应用
- 模块
- 控制器
- 视图
- 配置
- 路由
- 模型
- 介绍
- 事务
- 关联模型
- Mysql
- MongoDB
- SQLite
- Adapter
- 介绍
- Cache
- Session
- WebSocket
- Template
- 扩展功能
- thinkjs 命令
- 静态资源访问
- Middleware
- Service
- Cookie
- 错误处理
- 错误信息
- 数据校验
- 国际化
- 路径常量
- REST API
- 定时任务
- 线上部署
- 推荐模块
- API
- think
- think.base
- think.http.base
- http
- controller
- rest controller
- model
- model.mongo
- middleware