阅读(1434)
赞(8)
add_hook()
2017-06-13 17:10:23 更新
作用：添加 Api Hook 回调函数。
语法： null add_hook(mixed $api, callable $callback[, boolean $apiIsSet])
参数：
$api设置 API 名称，使用点语法，如 user.add，也可以设置为一个索引数组同时为多个 API 添加同一个回调函数。$callback回调函数，可以是一个函数名，也可以是一个匿名函数。$apiIsSet该 API 是否为一个集合，默认为 true，即同一个 API 中存储多个回调函数（数组），如果设置为 false，则该 API 仅存储 $callback 一个回调函数
别名：
add_action()
说明：
$callback 回掉函数支持最多一个参数，这个参数同时也是 do_hooks() 函数的第二个参数，在函数中可以对这个参数就行判断，修改等，最后将其返回或不反回（返回 null），甚至返回其他内容（但要求类型和这个参数相同）。
如果返回值既不是 null 也不是return error() ，则返回值会应用到 do_hooks() 函数的第二个参数上，来实现更改请求参数。
如果设置了 $apiIsSet 参数为 false，那么 return error() 也会被应用到 do_hooks() 函数的第二个参数上。
在回调函数中，可以通过判断请求参数，来决定接下来的行为，比如当请求参数不存在或者不匹配时，可以使用return error() 来返回错误信息。
{ $user['user_avatar'] = template_url('avatar.png'); //为用户设置一个默认头像
return $user; //将 $user 返回，必需，不返回不会应用修改
});
/** 或者为 Api 设置一个名字 */
add_action('user.add.auto_avatar', function($user){
/** 代码 */
}, false); //此时需要将第三个参数设置为 fasle
/** 或者使用一个函数名做为回调函数 */
add_action('user.add', 'auto_avatar'); //此时不能将第三个参数设置为 false，因为 user.add 是一个系统预定的集合
function auto_avatar($user){
/** 代码 */
}
/** 使用 return error() 返回错误 */
add_action('user.update.check_login', function(){
if(!is_login()) return error('用户未登录，不允许操作。');
}, false);</code></pre></div>
<div style=){kind=link}
← hooks()