normal.php

normal.php有两个。一个在项目根目录下的Config中,另外一个在Application/web[应用名]/Config中

项目根目录下的normal.php

  2.     'default_db' => [ //默认的数据库连接串
  3.         'driver' => 'MySql.MySql', //数据库驱动
  4.         'master' => [
  5.             'host' => 'localhost', //数据库主机
  6.             'username' => 'root', //数据库用户名
  7.             'password' =>'', //数据库密码
  8.             'dbname' => 'cmlphp', //数据库名
  9.             'charset' => 'utf8', //数据库编码
  10.             'tableprefix' => 'cml_', //数据表前缀
  11.             'pconnect' => false, //是否开启数据库长连接
  12.             'engine'=>''//数据库引擎
  13.         ],
  14.         'slaves'=> [], //从库配置
  16.         //查询数据缓存时间，表数据有变动会自动更新缓存。设置为0表示表数据没变动时缓存不过期。
  17.         //这边设置为3600意思是即使表数据没变动也让缓存每3600s失效一次,这样可以让缓存空间更合理的利用.
  18.         //如果不想启用缓存直接配置为false
  19.         'cache_expire' => 3600,
  20.     ],
  22.     // 缓存服务器的配置
  24.     'default_cache' => [
  25.         'on' => 0, //为1则启用，或者不启用
  26.         'driver' => 'Memcache',
  27.         'prefix' => 'd_c_57c17_',
  28.         'server' => [
  29.             [
  30.                 'host' => '127.0.0.1',
  31.                 'port' => 11211
  32.             ],
  33.             //多台...
  34.         ],
  35.     ],
  36.     'lock_prefix' => 'd_l_57c17_', //加锁前缀

在projxxx/Config/[cli/development/product]/normal.php中包含了开发会用到的常用配置，包换数据库连接串、缓存配置、锁配置等。

而在projxxx/Application/web/Config章节中我们说过。web应用中独立的配置存放在目录projxxx/Application/web/Config下。所以我们如果有一些应用特殊的配置只要配置在projxxx/Application/web/Config/normal.php中即可。建议是缓存、数据库连接等特殊的配置都配置在上层normal.php中，只有一些应用特殊的配置才配置在应用下的normal.php中

下面列出框架所有惯例配置，如有需要修改复制相应的值到normal.php中即可

  2. <?php
  3. /* * *********************************************************
  4.  * [cmlphp] (C)2012 - 3000 http://cmlphp.com
  5.  * @Author  linhecheng<linhechengbush@live.com>
  6.  * @Date: 14-2-21 下午2:23
  7.  * @version  @see \Cml\Cml::VERSION
  8.  * cmlphp框架惯例配置文件
  9.  * *********************************************************** */
  11. return [
  12.     //调试模式  默认关闭
  13.     'debug' => false,
  14.     'db_fields_cache' => true, //在debug模式实时获取字段列表，线上模式是否开启数据库字段缓存到文件。自v2.6.3起。开启本功能主要用于获取主键缓存
  16.     'time_zone' => 'PRC', //时区
  18.     //数据库配置
  19.     'default_db' => [
  20.         'driver' => 'Pdo', //数据库驱动
  21.         'master' => [
  22.             'host' => 'localhost', //数据库主机
  23.             'username' => 'root', //数据库用户名
  24.             'password' => '', //数据库密码
  25.             'dbname' => 'cmlphp', //数据库名
  26.             'charset' => 'utf8mb4', //数据库编码
  27.             'tableprefix' => 'sun_', //数据表前缀
  28.             'pconnect' => false, //是否开启数据库长连接
  29.             'engine' => ''//数据库引擎
  30.         ],
  31.         'slaves'=>[],
  33.         //查询数据缓存时间，表数据有变动会自动更新缓存。设置为0表示表数据没变动时缓存不过期。
  34.         //这边设置为3600意思是即使表数据没变动也让缓存每3600s失效一次,这样可以让缓存空间更合理的利用.
  35.         //如果不想启用缓存直接配置为false
  36.         'cache_expire' => 3600,
  38.         //是否记录执行慢的sql语句。只针对mysql有效。这个不能长期开，只能要分析sql性能的时候比如只开个5会钟有一定的log后就应该关掉。默认为false。
  39.         //为整形的时候则为执行时间大于这个时间的sql都记录到log下 比如配置为1则为执行超过1s的sql都记录到 notice.log里
  40.         'log_slow_sql' => false,
  41.     ],
  43.     /**
  44.     使用MongoDB
  45.     'db_mongo' => [
  46.         'driver' => 'MongoDB', //数据库驱动
  47.         'master' => [
  48.             'host' => 'localhost:27017',
  49.             'username' => '',
  50.             'password' => '',
  51.             'dbname' => 'test',
  52.             //'replicaSet' => '' //replicaSet名称
  53.         ],
  54.         'slaves'=>[],
  55.     ],
  56.      **/
  58.     // 缓存服务器的配置
  59.     'default_cache' => [
  60.         'on' => 0, //为1则启用，或者不启用
  61.         'driver' => 'Memcache',
  62.         'prefix' => 'cml_',
  63.         'server' => [
  64.             [
  65.                 'host' => '127.0.0.1',
  66.                 'port' => 11211,//必须是整形
  67.                 //'weight' => 100 //权重memcached扩展有效
  68.             ],
  69.             //多台...
  70.         ],
  71.     ],
  72.     /**
  73.     //文件缓存
  74.     'default_cache' => [
  75.         'on' => 0, //为1则启用，或者不启用
  76.         'driver' => 'File',
  77.         'prefix' => 'cml_'
  78.     ],
  79.     //apc缓存
  80.     'default_cache' => [
  81.         'on' => 0, //为1则启用，或者不启用
  82.         'driver' => 'Apc',
  83.         'prefix' => 'cml_'
  84.     ],
  85.     //Redis缓存
  86.     'default_cache' => [
  87.         'on' => 0, //为1则启用，或者不启用
  88.         'driver' => 'Redis',
  89.         'prefix' => 'cml_',
  90.         'server' => [
  91.             [
  92.                 'host' => '127.0.0.1',
  93.                 'port' => 6379,
  94.                 //'pconnect' => false //默认使用长连接
  95.                 //'db' => 6
  96.                 //'password' => '123456' //没有密码的时候不要配置
  97.             ],
  98.             //多台...
  99.         ],
  100.         //'back' => [//当server中有机器挂掉且back有开启时。会自动使用back来替换挂掉的server方便处理异常情况
  101.         //    'host' => '127.0.0.1',
  102.         //    'port' => 6379
  103.         //]
  104.     ],
  105.     */
  107.     /*模板设置*/
  108.     'view_render_engine' => 'html',//默认的视图渲染引擎，html/excel/json/xml
  109.     'default_charset' => 'utf-8', // 默认输出编码
  110.     'http_cache_control' => 'private', // 网页缓存控制
  111.     'output_encode' => true, // 页面压缩输出
  113.     /*Html引擎配置。只适用于html模板引擎*/
  114.     'html_theme' =>'', //默认只有单主题
  115.     'html_template_suffix' => '.html',     // 默认模板文件后缀
  116.     'html_left_deper' => '{{', //模板左定界符
  117.     'html_right_deper' => '}}', //模板右定界符
  119.     /*系统模板定义*/
  120.     'html_exception' => CML_CORE_PATH.'/Tpl/cmlException.tpl', // 默认成功跳转对应的模板文件
  121.     '404_page' => CML_CORE_PATH.'/Tpl/404.tpl', // 404跳转页
  122.     'debug_page' => CML_CORE_PATH.'/Tpl/debug.tpl', // debug调试信息模板
  125.     /* URL设置 */
  126.     'url_model' => 1,       // URL访问模式,可选参数1、2、3,代表以下四种模式：
  127.     // 1 (PATHINFO 模式显示index.php); 2 (PATHINFO 不显示index.php); 3 (兼容模式)  默认为PATHINFO 模式，提供最好的用户体验和SEO支持
  128.     'url_pathinfo_depr' => '/', // PATHINFO模式下，各参数之间的分割符号
  129.     'url_html_suffix' => '.html',  // URL伪静态后缀设置
  130.     'url_default_action' => 'web/Default/index', //默认操作
  131.     'var_pathinfo' => 'r',  // PATHINFO 兼容模式获取变量例如 ?r=/module/action/id/1中的s ,后面的分隔符/取决于url_pathinfo_depr
  132.     //'static__path' => 'http://static.cml.com/', //模板替换的{{public}}静态地址(访问静态资源用)  默认为 入口文件所在目录
  134.     /*安全过滤*/
  135.     'auth_key'=>'a5et3e41d', //Encry加密key
  136.     'check_csrf' => 1, //检查csrf跨站攻击 0、不检查，1、只检查post数据提交方式，2、get/post都检查 默认只检查post
  137.     'form_token'=> 0, //表单令牌 0不开启，1开启
  139.     /*语言包设置*/
  140.     'lang' =>'zh-cn',  //读取zh-cn.php文件
  142.     /*cookie设置*/
  143.     'cookie_prefix'=> 'cml_', //cookie前缀
  144.     'cookie_expire' => 0,    // Coodie有效期
  145.     'cookie_domain' => '',      // Cookie有效域名
  146.     'cookie_path' => '/',     // Cookie路径
  147.     'userauthid' => 'CmlUserAuth',  //用户登录成功之后的cookie标识
  149.     /*Session设置*/
  150.     'session_prefix' => 'cml_', //session前缀
  151.     'session_user' => 0, //SESSION保存位置自定义 0不开启、1开启
  152.     'session_user_loc' => 'db', //自定义保存SESSION的位置时 定义保存的位置  db、cache两种
  153.     'session_user_loc_table' => 'session', //自定义保存SESSION的保存位置设置为db时的表名
  154.     'session_user_loc_tableprefix' => 'cml_', //自定义保存SESSION的保存位置设置为db时的表前缀
  156.     /**锁配置**/
  157.     'lock_prefix' => 'cml_',
  158.     'locker_use_cache' => 'default_cache', //上锁使用的缓存
  160.     /**日志配置**/
  161.     'log_warn_log' => false, //警告级别的日志默认不记录
  162.     'log_prefix' => 'cml_log', //会显示到日志内容中,同时当以redis为驱动的时候会做为队列的前缀
  163.     //Log类使用redis为驱动时使用的缓存配置key
  164.     'redis_log_use_cache' => 'default_cache',//只有在该缓存的驱动为redis的时候才有效,否则会报错
  166.     /**队列配置**/
  167.     //Redis队列使用的缓存
  168.     'redis_queue_use_cache' => 'default_cache',//只有在该缓存的驱动为redis的时候才有效,否则会报错
  170.     /*系统路由-统一用小写url*/
  171.     'cmlframework_system_route' => [
  172.         'cmlframeworkstaticparse' => '\\Cml\\Tools\\StaticResource::parseResourceFile'
  173.     ],
  174.     'static_file_version' => 'v1', //开发模式会自动在静态文件后加时间缀，实时过期,线上模板版本号固定，如有需要在这里改版本号强制过期
  176.     /*php-console配置*/
  177.     'dump_use_php_console' => false, //开启本功能需要先安装php-console composer require php-console/php-console ~3.0
  178.     'php_console_password' => 'cmlphp_php_console_pw123456',
  180.     /**
  181.      * 是否开启全局紧急模式--慎用。主要用于在系统mysql负载过高(如遇到攻击)mysql压力过大。先将所有查询转移至缓存。消化压力高峰
  182.      *
  183.      * 开启时 mysql的查询缓存不会在数据变更时实时更新。
  184.      * 所以如果要开启请确定开启后不会对业务造成影响。如:扣积分前的查询积分数，这种对数据实时要求高的，在开启本模式时要做下判断并屏蔽。
  185.      */
  186.     'emergency_mode_not_real_time_refresh_mysql_query_cache' => false, //配置成int型则为缓存刷新周期。如配置成 300 则为数据变更时每五分钟更新一次mysql查询缓存
  188.     'var_page' => 'page', //分页时传递当前页数的变量名
  190.     'route_app_hierarchy' => 1, //路由找控制器的时候遍历应用目录的层级，默认为1
  191. ];

原文: http://doc.cmlphp.com/devintro/config/normal.html