一、ApiExecute函数
Z-BlogPHP1.7.3 新增了ApiExecute函数,可以调用执行公共模块和私有模块的API并返回结果。
函数定义:
/** * API 执行. * * @param string $mod (模块名) * @param string $act (方法名) * @param array $get (模拟$_GET参数) * @param array $post (模拟$_POST参数) */ function ApiExecute($mod, $act, $get = array(), $post = array()) {...}
示例:
$post = ApiExecute('post', 'get', array('id' => 2)); var_dump($post); //调用post模块的get方法,输入GET参数id=2,并返回结果array(文章数据)
ApiExecute 函数的用处是在访问 API 时也能执行 ApiExecute 调用其它的 API,当然也可以在系统的其它地方调用
二、私有模块
私有模块与公共模块的区别是公共模块可以被 api.php 路由访问和 ApiExecute 函数调用;私有模块只能在系统里被 ApiExecute 函数调用,不会被 api.php 路由访问。
三、加载/移除私有模块
一次添加指定目录下的私有模块, $modsdir 为私有模块所在目录:
ApiLoadPrivateMods($modsdir)
单个添加私有模块:
ApiAddMod($modname, $filename)
单个删除私有模块:
ApiRemovePrivateMod($modname)
四、调试插件
为了方便开发过程测试调试 API,Z-BlogPHP提供部分软件 API 调试接口包。
Postman是一个流行的API开发工具,用于测试、调试和发布API。它允许用户轻松创建请求、设置参数、模拟响应等操作,以便在开发过程中快速验证API的正确性和性能。
1、点击图标【Run in Postman】,将 Z-BlogPHP 的 API 包 Fork 到自己工作台;
2、Fork 可以在自己的 Collection 中看到名为 Z-BlogPHP API 的资源包;
3、在资源包的设置中,切换到变量 Variable 选项,填写 ZBLOGPHP_HOST、USERNAME、PASSWORD 三个变量的值(填写在 CURRENT VALUE );
4、在资源包各个模块下已经列出了所有操作方法(list、get、post、delete 等),直接选择后调试即可;
5、调试时无需考虑鉴权 token ,资源包会自动处理,并附加上 token 进行请求。