一、ApiExecute函數(shù)
Z-BlogPHP1.7.3 新增了ApiExecute函數(shù),可以調(diào)用執(zhí)行公共模塊和私有模塊的API并返回結(jié)果。
函數(shù)定義:
/** * API 執(zhí)行. * * @param string $mod (模塊名) * @param string $act (方法名) * @param array $get (模擬$_GET參數(shù)) * @param array $post (模擬$_POST參數(shù)) */ function ApiExecute($mod, $act, $get = array(), $post = array()) {...}
示例:
$post = ApiExecute('post', 'get', array('id' => 2)); var_dump($post); //調(diào)用post模塊的get方法,輸入GET參數(shù)id=2,并返回結(jié)果array(文章數(shù)據(jù))
ApiExecute 函數(shù)的用處是在訪問 API 時(shí)也能執(zhí)行 ApiExecute 調(diào)用其它的 API,當(dāng)然也可以在系統(tǒng)的其它地方調(diào)用
二、私有模塊
私有模塊與公共模塊的區(qū)別是公共模塊可以被 api.php 路由訪問和 ApiExecute 函數(shù)調(diào)用;私有模塊只能在系統(tǒng)里被 ApiExecute 函數(shù)調(diào)用,不會(huì)被 api.php 路由訪問。
三、加載/移除私有模塊
一次添加指定目錄下的私有模塊, $modsdir 為私有模塊所在目錄:
ApiLoadPrivateMods($modsdir)
單個(gè)添加私有模塊:
ApiAddMod($modname, $filename)
單個(gè)刪除私有模塊:
ApiRemovePrivateMod($modname)
四、調(diào)試插件
為了方便開發(fā)過程測(cè)試調(diào)試 API,Z-BlogPHP提供部分軟件 API 調(diào)試接口包。
Postman是一個(gè)流行的API開發(fā)工具,用于測(cè)試、調(diào)試和發(fā)布API。它允許用戶輕松創(chuàng)建請(qǐng)求、設(shè)置參數(shù)、模擬響應(yīng)等操作,以便在開發(fā)過程中快速驗(yàn)證API的正確性和性能。
1、點(diǎn)擊圖標(biāo)【Run in Postman】,將 Z-BlogPHP 的 API 包 Fork 到自己工作臺(tái);
2、Fork 可以在自己的 Collection 中看到名為 Z-BlogPHP API 的資源包;
3、在資源包的設(shè)置中,切換到變量 Variable 選項(xiàng),填寫 ZBLOGPHP_HOST、USERNAME、PASSWORD 三個(gè)變量的值(填寫在 CURRENT VALUE );
4、在資源包各個(gè)模塊下已經(jīng)列出了所有操作方法(list、get、post、delete 等),直接選擇后調(diào)試即可;
5、調(diào)試時(shí)無需考慮鑒權(quán) token ,資源包會(huì)自動(dòng)處理,并附加上 token 進(jìn)行請(qǐng)求。