控制层核心

• classstring, null
  读取调度或设置类名称, null(默认)=读取调度{"class" : 类名, "action" : 方法}, 字符串=("class" | "action")读取调度值
• actionstring
  调用的方法名, null(默认)=读取调度, 字符串=设置方法名
• check
  加载类返回值校验,false=永不通过,null=永远通过

<?php
/**
 * 如果加载'/demo/ofControllers.php'的返回值通过check, 便new对象后调用index方法
 * 返回 index 方法的返回值
 */
$result = of::dispatch('demo_ofControllers', 'index', 'allow');
if( is_array($result) ) {
    echo json_encode($result);                                         //ajax + hmtl 方式开发很有用
}
/**
 * 返回值为{'class': 'demo_ofControllers', 'action' => 'index'}
 */
of::dispatch();
/**
 * 修改调度信息
 */
of::dispatch('demo_test', 'demo', false);

• namestring
  配置名,以'.'分割读取深层数据
• default
  默认值,没读到数据时,替换原值做为以后使用
• actionstring
  附属动作

   
      0=无任何操作
      1=读取到的数据格式化成磁盘路径
      2=读取到的数据格式化成网络路径
      4=本次使用实时配置读取数据

<?php
of::config('_of.xx.cc');    //读取框架变量['xx']['cc']的值

• keystring
  事件类型
• eventbool, null, asCall
  true=触发事件,false=删除事件,null=管理事件,其它=添加事件(符合回调结构)
• formatstring
  添加时=true为特殊结构,删除时=指定删除的回调,触发时=自定义参数[_]键的值,默认null

<?php
/**
 * 框架内部事件说明如下 :
 * of::halt             代码执行结束后回调
 * of::error            自定义异常或错误
 *     触发参数 : 对象=异常对象, 数组=指定错误 {
 *          "code" : 错误代码, 默认 E_USER_NOTICE
 *          "info" : 错误描述, 默认 "Unknown error"
 *          "file" : 文件路径, 默认 代码触发文件
 *          "line" : 错误行数, 默认 代码触发行数
 *     }
 * of::config           加载框架最新配置时触发, 如: of::congif(xxx, yyy, 4);
 *     触发参数 : {
 *          "config" :&框架配置
 *     }
 * of::dispatch         调度信息变化时调用
 *     触发参数 : {
 *          "class"  : &调度类名
 *          "action" : &调度方法
 *          "check"  : &校验参数
 *     }
 * of::loadClass        加载新类前调用
 *     注册参数 : {
 *          "filter" :*匹配的类前缀触发回调
 *          "router" : 路由模式, 映射前缀,字符串=类前缀替换该字符串(第一个字符不为"/"时会把"_"替换为"/"做为寻类路径)
 *          "asCall" : 回调模式, 函数回调,不能与router共存
 *          "params" : 回调参数,用[_]键指定触发参数位置
 *     }
 *     触发参数 : 回调模式下生效 {
 *          "name" : 类名
 *          "code" :&代码, 更改执行的代码, null=不更改
 *          "file" :&路径, 更改代码的路径, null=不更改
 *     }
 * of_view::display     加载视图模板前触发
 *     触发参数 : {
 *          "tplDir"  : &加载的模板路径
 *          "viewObj" : of_view对象
 *     }
 * of_db::rename        重命名指定连接池
 *     触发参数 : {
 *          "oName" : 旧名称
 *          "nName" : 新名称
 *     }
 * of_db::before        sql语句执行前触发
 *     触发参数 : {
 *          "sql"  : &sql语句
 *          "pool" : 连接池键
 *     }
 * of_db::after         sql语句执行后触发
 *     触发参数 : {
 *          "sql"    : &sql语句
 *          "pool"   : 连接池键
 *          "result" : &执行的结果集
 *     }
 * of_db::error         sql出现错误时回调
 *     触发参数 : {
 *          "code" : 错误编码
 *          "info" : 错误信息
 *          "note" : 详细日志
 *          "sql"  : &sql语句
 *          "pool" : 连接池键
 *     }
 * of_base_htmlTpl_engine::compile     编译模版引擎前触发
 *     触发参数 : {
 *          "tplObj" : &模板的hParse对象
 *          "tplDir" : 模版的磁盘路径
 *     }
 * of_base_error_writeLog::error     发生错误时触发
 *     触发参数 : {
 *          "type" : 错误来源, 其中一个(js, php, mysql)
 *          "data" : 错误信息
 *     }
 *     回调返回 :
 *          true=接替日志记录, 框架不记录日志
 * of_base_com_net::before     请求开始前触发
 *     触发参数 : {
 *          "params" :&请求参数 {
 *              "type"    : 交互类型(大写字符串)可以是 OPTIONS,GET,HEAD,POST,PUT,DELETE,TRACE
 *              "data"    : 报文主体数据(字符串)
 *              "get"     : get数据(字符串)
 *              "cookie"  : cookie数据(字符串)
 *              "header"  : 自定义头信息(字符串)
 *              "timeout" : [连接超时, 响应超时]
 *              "url"     : 访问路径(字符串)

 *              其它调用调用参数
 *          }
 *     }
 * of_base_com_net::after     请求结束后触发
 *     触发参数 : {
 *          "params" :&请求参数, 同"of_base_com_net::before事件"结构
 *          "result" :&请求结果, 同"of_base_com_net::request"响应结构
 *     }
 */

/**
 * 事件列表结构如下($event为null时会返回对应事件类型的引用) : {
 *     事件类型 : {
 *         "change" : 添加删除时会变true
 *         "list"   : [{
 *             "isCall" : true=是回调类型,false=特殊结构
 *             "event"  : 回调事件
 *             "change" : 新加时会为true
 *         }]
 *     }
 * }
 */

<?php
//演示通过'of::loadClass'事件生成一个新的事件
of::event('of::loadClass', array(
    'filter' => 'of_base_com_timer',
    'asCall' => function ($params) {
        //读取源代码
        $params['code'] || $params['code'] = file_get_contents(OF_DIR . '/base/com/timer.php');
        //定位修改方法
        $temp = array(
            //定位到getCron方法
            strpos($params['code'], 'getCron() {'),
            //准备注入的事件
            'of::event(__METHOD__, true, array(\'cron\' => &$cron));'
        );
        //将事件注入到return前的位置
        $params['code'] = preg_replace("@^(.{{$temp[0]}}.*?)(return)@s", "\${1}{$temp[1]}}\${2}", $params['code']);
    }
));

• namestring
  方法名, 可以用 &name 来表示返回引用
• argsstring
  参数列表, 参考 create_function
• codestring
  方法体, 参考 create_function
• staticbool
  是否为静态函数, true=静态, false=动态

• datastring, array
  指定替换的数据
• funcstring
  addslashes=添加反斜线, stripslashes=删除反斜线

• baseData
  被替换的数据
• replace
  替换的数据

• callarray, 一般来自监听事件

  调用函数的信息有四种写法 :
  1. 符合 is_callable 格式的, 如 匿名方法, "class::action" 或 [object, action]
  2. 每次调用创建对象的格式, 如 [class, action], 会将会创建class的对象
  3. 自定义调用的信息 {
      "asCall" : 符合上面两种规范
      "params" : call_user_func_array 格式的参数,用[_]键指定类名位置,默认最后一位 array(
          自定义参数一,
          自定义参数二,
          '_' => null,    //params的参数会传到此处
          自定义参数三,
  }
  4. 含"."的字符串, 会从of::config中读取对应配置后按上述格式解析, 配合动态配置更灵活

  //调用函数
  $call = 'action';
  //调用静态方法
  $call = 'className::action';
  //调用动态方法
  $call = array(new className, 'action');
  //实例化类后调用动态方法
  $call = array('className', 'action');
  //自定义参数写法
  $call = array(
      'asCall' => 上述四种写法
      'params' => array(
          自定义参数一,
          '_' => null,
          自定义参数三
      )
  );
  //实例演示
  function action($a = 'a', $b = 'b', $c = 'c') {
      echo $a, $b, $c;
  }
  of::callFunc('action', '-');                        //输出: -bc
  of::callFunc(array(                                 //输出: m-n
      'asCall' => 'action',
      'params' => array('m', '_' => 0, 'n')           //"_"键为"-"参数的位置
  ), '-');
  

• params一般来自触发事件
  传入到 [_] 位置的参数
• return
  指定无法回调的返回值, 不指定调用失败时报错

• pathstring
  指定格式化的路径,'_'开头的去掉'_',其它字符以加上指定前缀,数组则以回调的返回值为值
• prefixstring
  path不以'_'开头字符串的前缀

• keystring, array
  null(默认)=返回 data, 字符串=以"."作为分隔符表示数组深度, 数组=以数组的方式代替传参[key, data, default, isEscape]
• dataarray
  被查找的数组
• defaultmixed
  没查找到的代替值(null)
• extendsint
  扩展参数, 使用"|"连接多个功能, 0(默认)=不转义, 1=以"`"作为key的转义字符, 2=默认值赋值到原数据

• codestring
  检查的代码, 符合 eval 的规范
• execbool
  是否执行 false=不执行, true=执行, 字符串=执行且指定文件路径
• tipsbool string
  是否显示行号源码 false=不显示, true=显示
• datamixed
  执行时返回的数据

<?php
/**
 * 语法通过返回 null
 * 语法失败返回 {
 *     "info" : 错误信息
 *     "line" : 错误行数
 *     "tips" : 按 tips 参数显示的代码
 * }
 */
of::syntax('if');     // {"info":"syntax error, unexpected $end, expecting '('","line":1}
of::syntax('echo __FILE__;', 'file.php');     // file.php