附录

默认配置

  1.  /**
  2.  * 框架默认配置
  3.  * 可以在App/Conf/config.js里修改下面的配置值
  4.  * @type {Object}
  5.  */
  6. module.exports = {
  7.   port: 8360, //监听端口
  8.   use_proxy: false, //是否使用代理访问，如：nginx。开启后不能通过ip+端口直接访问
  9.   encoding: 'utf8', //输出数据的编码
  10.   url_pathname_prefix: '',  //不解析的pathname前缀
  11.   url_pathname_suffix: '.html', //不解析的pathname后缀，这样利于seo
  12.   app_tag_on: true, //是否支持标签功能
  13.   url_resource_on: true,  //是否监听静态资源类请求
  14.   url_resource_reg: /^(resource\/|static\/|favicon\.ico)/, //判断是否是静态资源的正则
  15.   url_route_on: true, //是否开启自定义路由功能
  17.   post_json_content_type: ['application/json'], //post数据为json时的content-type
  18.   post_max_file_size: 1024 * 1024 * 1024, //上传文件大小限制，默认1G
  19.   post_max_fields: 100, //最大表单数，默认为100
  20.   post_max_fields_size: 2 * 1024 * 1024, //单个表单长度最大值，默认为2MB
  21.   post_ajax_filename_header: 'x-filename', //通过ajax上传文件时文件名对应的header，如果有这个header表示是文件上传
  23.   app_group_list: ['Home', 'Admin', 'Restful'], //分组列表
  24.   deny_group_list: [],
  25.   default_group: 'Home', //默认分组
  26.   default_controller: 'Index', //默认模块
  27.   default_action: 'index',  //默认Action
  28.   call_controller: 'Home:Index:_404', //controller不存在时执行方法，此配置表示调用Home分组下IndexController的_404Action方法
  29.   call_method: '__call', //当找不到方法时调用什么方法，这个方法存在时才有效
  30.   before_action: '__before', //调用一个action前调用的方法，会将action名传递进去
  31.   after_action: '__after', //调用一个action之后调用的方法，会将action名传递进去
  32.   url_params_bind: true, //方法参数绑定,将URL参数值绑定到action的参数上
  33.   action_suffix: 'Action', //action后缀
  34.   url_callback_name: 'callback', //jsonp格式的callback名字
  35.   json_content_type: 'application/json', //发送json时的content-type
  36.   auto_send_content_type: true, //是否自动发送Content-Type,默认值为`tpl_content_type`配置值
  37.   log_process_pid: true, //记录进程的id,方便其他脚本处理。
  38.   use_cluster: false, //是否使用cluster，默认不使用，0：为cpu的数量，可以自定义值
  39.   autoload_path: {}, //autoload查找的path，用于thinkRequire加载自定义库的时候查找
  40.   create_server_fn: '', //自定义create server全局函数名，可以在Common/common.js里实现
  42.   restful_group: 'Restful', //RESTFUL API默认分组
  44.   load_ext_config: [], //加载额外的配置文件 CONF_PATH
  45.   load_ext_file: [], //加载额外的文件 COMMON_PATH
  47.   use_websocket: false, //是否使用websocket
  48.   websocket_allow_origin: '', //允许从那里发送过来的websocket，可以是字符串、数组、回调函数，为空表示不检测
  49.   websocket_sub_protocal: '', //websocket子协议，可以是个字符串也可以是回调函数
  50.   websocket_message_handle: undefined, //websocket消息处理函数
  52.   error_tpl_path: THINK_PATH + '/View/error.html', //错误页模版
  53.   error_no_key: 'errno', //错误number的key
  54.   error_no_default_value: 1000, //错误号默认值
  55.   error_msg_key: 'errmsg', //错误消息的key
  57.   cookie_domain: '', //cookie有效域名
  58.   cookie_path: '/',   //cookie路径
  59.   cookie_timeout: 0, //cookie失效时间，0为浏览器关闭，单位：秒
  61.   session_name: 'thinkjs', //session对应的cookie名称
  62.   session_type: 'File', //session存储类型, 空为内存，还可以为File
  63.   session_path: '', //File类型下文件存储位置，默认为系统的tmp目录
  64.   session_options: {}, //session对应的cookie选项
  65.   session_sign: '', //session对应的cookie使用签名
  66.   session_timeout: 24 * 3600, //服务器上session失效时间，单位：秒
  68.   db_type: 'mysql', // 数据库类型
  69.   db_host: '127.0.0.1', // 服务器地址
  70.   db_port: '', // 端口
  71.   db_name: '', // 数据库名
  72.   db_user: 'root', // 用户名
  73.   db_pwd: '', // 密码
  74.   db_prefix: 'think_', // 数据库表前缀
  75.   db_charset: 'utf8', // 数据库编码默认采用utf8
  76.   db_ext_config: {}, //数据库连接时候额外的参数
  77.   db_fieldtype_check: false, // 是否进行字段类型检查
  78.   db_fields_cache: true, // 启用字段缓存
  79.   db_nums_per_page: 20, //默认每页显示的条数
  80.   db_like_fields: [], //自动进行模糊查询,|连接，如: ['title', 'content']
  81.   db_cache_on: true, //是否启用查询缓存，如果关闭那么cache方法则无效
  82.   db_cache_type: '', //缓存类型，默认为内存缓存
  83.   db_cache_path: CACHE_PATH + '/db', //缓存路径，File类型下有效
  84.   db_cache_timeout: 3600, //缓存时间，默认为1个小时
  85.   db_log_sql: false, //是否打印sql语句
  86.   db_buffer_tostring: true, //是否将buffer转为字符串
  88.   tpl_content_type: 'text/html', //模版输出类型
  89.   tpl_file_suffix: '.html', //模版文件名后缀
  90.   tpl_file_depr: '_', //controller和action之间的分隔符
  91.   tpl_engine_type: 'ejs', //模版引擎名称
  92.   tpl_engine_config: {}, 
  94.   token_on: false, //是否开启token功能
  95.   token_name: 'token', //token name
  96.   token_key: '{__TOKEN__}', //记录token在模版中的位置替换用。默认自动查找<form和</head>标签替换
  98.   log_console: false, //是否记录日志，开启后会重写console.error等系列方法
  99.   log_console_path: LOG_PATH + '/console', //日志文件存放路径
  100.   log_console_type: ['error'], //默认只接管console.error日志
  101.   log_memory: false, //记录内存使用和负载
  102.   log_memory_path: LOG_PATH + '/memory', //日志文件存放路径
  103.   log_memory_interval: 60 * 1000, //一分钟记录一次
  105.   cache_type: 'File', //数据缓存类型
  106.   cache_key_prefix: '__thinkjs__', //缓存key前置(memcache和redis下有效)
  107.   cache_timeout: 6 * 3600, //数据缓存有效期，单位: 秒
  108.   cache_path: CACHE_PATH,  //缓存路径设置 (File缓存方式有效)
  109.   cache_file_suffix: '.json', //File缓存方式下文件后缀名
  110.   cache_gc_hour: [4], //缓存清除的时间点，数据为小时
  112.   html_cache_on: false, //HTML静态缓存
  113.   html_cache_timeout: 3600, //缓存时间，单位为秒
  114.   html_cache_rules: {}, //缓存规则
  115.   html_cache_path: CACHE_PATH + '/html',
  116.   html_cache_file_callback: undefined, //生成缓存文件的回调函数
  117.   html_cache_file_suffix: '.html', //缓存文件后缀名
  119.   memcache_host: '127.0.0.1', //memcache host
  120.   memcache_port: 11211, //memecache端口
  122.   redis_host: '127.0.0.1', //redis host
  123.   redis_port: 6379, // redis port
  124. };

这些配置的值都可以在App/Conf/config.js文件里重新设置。

系统常量

系统里定义很多系统常量，方便在项目中使用。

  • APP_DEBUG 开启调试，开发中使用，上线后需要关闭
  • APP_MODE 运行模式
  • THINK_PATH thinkjs库的目录
  • THINK_VERSION 当前thinkjs的版本
  • THINK_LIB_PATH thinkjs的lib路径
  • THINK_EXTEND_PATH thinkjs的扩展路径
  • APP_PATH 项目App路径，如:/home/welefen/www.test.com/App
  • COMMON_PATH Common路径，对应为App/Common
  • LIB_PATH Lib路径，对应为App/Lib
  • CONF_PATH 配置路径，对应为App/Conf
  • VIEW_PATH 模版路径，对应为App/View
  • RUNTIME_PATH runtime路径，对应为App/Runtime
  • DATA_PATH 临时数据路径，对应为App/Runtime/Data
  • CACHE_PATH 缓存路径，对应为App/Runtime/Cache