codecamp

do_hooks()

作用:执行 Api Hook 回调函数。 语法: null do_hooks(string $api[, mixed $input])

参数

  • $api 待执行的 API 名称,使用点语法,如 user.add
  • $input 传入的参数或者获取模块信息时得到的数组

别名

  • do_actions()

说明$input 参数是 Api Hook 回调函数的参数。在使用 add_hook() 函数为 API 添加回调函数时,回调函数可以选择传入 $input 参数,也可以不传入参数,可以选择返回值,也可以不返回。$input 参数是一个引用传递,默认值为 null。但除了 null 外,其他返回值都会被应用到 $input 参数中,等待下一个回调函数接收它。

需要注意的是,如果在某一个 Api Hook 回调函数中,return error() 被调用,即设置了错误信息,那么序列中的其他回调函数将不会再被调用。ModPHP 不会也没有能力(在顾及 Socket 服务时)自动报告错误消息给调用器,你需要手动这么做。

在模块类方法中调用了 do_hooks() 函数后,你需要使用if(error()) return [error()](http://modphp.hyurl.com/function-error); 来判断在出现错误时将错误返回给调用器。

示例

<?php
/** 自定义一个 Api 并绑定回调函数 */
add_hook('text.change', function($text){ //此时传入 $text 参数和不传入是一样的
    $text = 'Hi, ModPHP';
    return $text; //返回以应用更改
}, false);
$text  = 'Hello, World!'; //这个 $text 和 add_hook() 中的 $text 不是一回事
do_hooks('test.change', $text); //执行回调函数
echo $text; //将输出 Hi, ModPHP
/** 错误控制 */
class something extents mod{
    static function act($arg = array()){
        do_hooks('mod.act', $arg); //可能会出现错误,错误信息存储在 error() 中
        if(error()) return error(); //如果 error() 返回值不为空(有错误),则将错误返回给调用器
        /** 其他代码 */
    }
}
remove_hook()
config()
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

挂钩机制

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }