Discuz Api 接口【旗艦版】二次開發(fā) - 在線手冊

admin

接口二次開發(fā)

本功能由PHP+MYSQL語言開發(fā)，無縫對接新秀網(wǎng)絡(luò)驗證系統(tǒng)，采用獨立入口文件、類文件、第三方類文件庫進行調(diào)用開發(fā)。所有功能實現(xiàn)及控制均采用api接口操作，數(shù)據(jù)輸出形式為JSON、XML兩種常見形式，達(dá)到毫秒級數(shù)據(jù)快速交換功能。 1、接口開發(fā)是結(jié)合新秀網(wǎng)絡(luò)驗證系統(tǒng)進行的二次開發(fā)，不能獨立使用； 2、接口開發(fā)遵循Discuz、新秀網(wǎng)絡(luò)驗證、PHP語言規(guī)范開發(fā)； 3、接口開發(fā)適用于新秀網(wǎng)絡(luò)驗證系統(tǒng)旗艦版ver1.0版本以后； 4、本功能與新秀網(wǎng)絡(luò)驗證系統(tǒng)、擴展框架系統(tǒng)，代碼相互獨立，但功能同時執(zhí)行； 5、接口開發(fā)可使用Discuz內(nèi)置函數(shù)、新秀網(wǎng)絡(luò)驗證內(nèi)置函數(shù)、PHP函數(shù)。

適用環(huán)境：php版本>7.0、Mysql版本>5.5以上、Discuz版本>3.5。

= Discuz資料庫  = Discuz插件開發(fā)文檔  = 開發(fā)交流  =  BUG反饋  =  QQ客服：3188639  QQ交流群：281079920

2 a* g% ~8 A1 M% e; p

接口開發(fā)常用函數(shù)

1、DB數(shù)據(jù)庫操作函數(shù)    /*常用MYSQL數(shù)據(jù)庫操作命令，增、減、改、查功能函數(shù)。*/

2、新秀網(wǎng)絡(luò)驗證數(shù)據(jù)庫對照表    /*新秀網(wǎng)絡(luò)驗證系統(tǒng)內(nèi)部，所有數(shù)據(jù)庫表及說明*/

3、Discuz官方數(shù)據(jù)庫對照表  /*Discuz官方數(shù)據(jù)庫表，包括discuz、UCente數(shù)據(jù)庫字典。*/

4、Discuz基礎(chǔ)框架、類、函數(shù)    /*包含Discuz官方基礎(chǔ)框架、類、函數(shù)、方法使用說明。*/

5、新秀網(wǎng)絡(luò)基礎(chǔ)框架類、函數(shù)    /*包含新秀網(wǎng)絡(luò)驗證基礎(chǔ)框架、類、函數(shù)、方法使用說明。*/

; V$ O+ W6 |, f5 K

二次接口開發(fā)示例

1、*

+ h8 u2 a" l( W. Y# h# Q* F% T1 A

使 用 簡 介

1、接口開發(fā)演示文件下載

dev.zip (4.21 KB, 下載次數(shù): 98) 2025-7-2 17:50 上傳 點擊文件名下載附件 【UTF8】

2、接口開發(fā)演示文件目錄說明

xinxiuvip_network_plugin\\新秀網(wǎng)絡(luò)驗證系統(tǒng)插件主目錄 —lib \\自定義類存放目錄 （用于開發(fā)者存放第三方類、自定義類，命名：lib_dev.php） ——lib_dev.php \\自定義方法庫開發(fā)文件 （自定義開發(fā)接口方法庫） —function \\自定義方法存放目錄 （用于開發(fā)者存放自定義開發(fā)接口類和方法） ——function_dev.php \\自定義方法類開發(fā)文件 （自定義開發(fā)接口方法類） —dev.inc.php \\自定義接口入口開發(fā)文件

3、如何安裝、開發(fā)、調(diào)試？

#1、下載演示文件后，上傳至新秀網(wǎng)絡(luò)驗證插件根目錄。discuz論壇插件根目錄 \source\plugin\xinxiuvip_network_plugin\ #2、使用PHP代碼編輯軟件，對入口文件 dev.inc.php 和 自定義方法類文件 function_dev.php 進行開發(fā)，注意：UTF8及GBK編碼問題。 #3、如需新增接口文件，請根據(jù)演示文件，修改 “dev” 為您想要的文件名，但不能與新秀框架插件內(nèi)文件名沖突，且開發(fā)的接口方法，不能與新秀框架沖突。 #4、功能代碼開發(fā)完成，組裝調(diào)試接口： [PHP] 純文本查看 復(fù)制代碼 //根據(jù)演示文件中組裝url接口地址 demo35.xinxiuvip.com/plugin.php?id=xinxiuvip_network_plugin:dev&soft=2&action=dev_demo1&key=123456&demo1=demo1&demo2=demo2 [PHP] 純文本查看 復(fù)制代碼 //根據(jù)演示文件中接口訪問返回的結(jié)果 { "code": "200", "result": "OK", "count": 2, "data": { "demo1": "demo1", "demo2": "demo2" }, "sqltime": "0s" }

dev.inc.php入口文件代碼實例

[PHP] 純文本查看 復(fù)制代碼 <?php #以下兩行代碼，用于開發(fā)環(huán)境下代碼錯誤提示，可根據(jù)提示信息進行代碼檢查，無誤后即可注釋掉！ // ini_set("display_errors", "on"); // error_reporting(E_ALL); #注釋結(jié)束 #防止游客直接輸入網(wǎng)址進行訪問，權(quán)限檢測，勿動！！！ if (!defined('IN_DISCUZ')) { exit('Access Denied'); } #注釋結(jié)束 #引入自定義開發(fā)類文件，此文件保存位置 'function/dev' 代表 function/function_dev.php 如需修改請按格式進行！ C::import('function/dev', 'plugin/xinxiuvip_network_plugin', false);//注意這里和接口二次開發(fā)不同 $api = new function_dev();//實例化function_dev.php類操作，實例化后可用$api->調(diào)用function_dev.php中的類方法！ #注釋結(jié)束 #此處為入口文件，根據(jù)接口方法，調(diào)用對應(yīng)類方法。 switch ($api->action) { //$api->action 獲取入口方法，勿動！！！ #此處代碼根據(jù)接口開發(fā)需求，可以無限添加循環(huán)。 case 'dev_demo1': // 判斷是否是此方法，如果是則進入下一步！ $demo1 = web_client::safe_check('demo1', true); //判斷參數(shù)傳輸，params為參數(shù)名稱，iscore為是否是必填項（true為必填，false為可空） $demo2 =web_client::safe_check('demo2', false);//判斷參數(shù)傳輸，params為參數(shù)名稱，iscore為是否是必填項（true為必填，false為可空） $api->dev_demo1($demo1,$demo2);//調(diào)用function_dev.php實例化后類方法，根據(jù)類方法設(shè)置傳入?yún)?shù)。 break; #注釋結(jié)束 #此處代碼是判斷接口輸入是否正確。勿刪！！！ default: web_output::json_output(400,'error010'); break; #注釋結(jié)束 } #注釋結(jié)束

function_dev.php自定義方法類代碼實例

[PHP] 純文本查看 復(fù)制代碼 <?php #以下兩行代碼，用于開發(fā)環(huán)境下代碼錯誤提示，可根據(jù)提示信息進行代碼檢查，無誤后即可注釋掉！ //ini_set("display_errors", "on"); //error_reporting(E_ALL); #注釋結(jié)束 #防止游客直接輸入網(wǎng)址進行訪問，權(quán)限檢測，勿動！！！ if (!defined('IN_DISCUZ')) { exit('Access Denied'); } #注釋結(jié)束 #引入核心系統(tǒng)類，勿刪！！！ C::import('class/plugin', 'plugin/xinxiuvip_network_plugin', false); #注釋結(jié)束 #如何引入自定義系統(tǒng)類？ #1、將自定義核心類、第三方核心類上傳至extend文件夾下； #2、通過 C::import 、 require_once 兩種引入形式引入第三方核心類； #3、在下方方法中使用 lib_dev::demo_dev(); 進行調(diào)用，具體功能看lib_dev封裝代碼； C::import('lib/dev', 'plugin/xinxiuvip_network_plugin', false);//如果沒有自定義類庫，請將此處注釋掉！ #注釋結(jié)束 class function_dev extends class_plugin { public $action_all = array('dev_demo1'); //所有接口必填，用逗號隔開！！！除以下key、adminkey所包含以外，未包含的接口都是通過token令牌進行訪問。 public $function_action_key = array('dev_demo1'); //使用key密鑰訪問的接口 public $function_action_adminkey = array(); //使用管理密鑰adminkey訪問的接口 /** * 構(gòu)造方法 __construct() 是在實例化對象時被自動調(diào)用 * 用途：可以用于初始化程序(可以給成員屬性賦值，也可以調(diào)用成員方法) */ public function __construct() { parent::__construct(); //繼承父類構(gòu)造方法 } #此處為標(biāo)準(zhǔn)類方法，可根據(jù)DISCUZ、新秀網(wǎng)絡(luò)驗證內(nèi)置函數(shù)進行調(diào)用，也可使用PHP官方函數(shù)進行操作。 public function dev_demo1($demo1, $demo2) { #-具體DISCUZ內(nèi)置函數(shù)、新秀網(wǎng)絡(luò)驗證內(nèi)置函數(shù)、PHP函數(shù)，論壇相應(yīng)帖子有專門介紹。 $data = array( //組合數(shù)組 'demo1' => $demo1, 'demo2' => $demo2 ); $data['time'] = lib_dev::demo_dev(time());//調(diào)用lib自定義封裝類庫示例； #======================================== #嵌入點開發(fā)，注意：此擴展方法在應(yīng)用中心-內(nèi)置鉤子頁面設(shè)置； web_client::class_hook('hook_dev_demo1',array($data)); /* * 下面是接口拓展對應(yīng)的方法 * 注意class_hook中的'hook_dev_demo1' 就是擴展文件中的方法名！ * 將下面代碼復(fù)制到-內(nèi)置鉤子開發(fā)頁面中。 * public function hook_dev_demo1($data){ var_dump($data); } */ #======================================== web_output::json_output('200', '', $data); // 新秀內(nèi)置打印函數(shù)，打印結(jié)果，并結(jié)束程序。 #-具體DISCUZ內(nèi)置函數(shù)、新秀網(wǎng)絡(luò)驗證內(nèi)置函數(shù)、PHP函數(shù)，論壇相應(yīng)帖子有專門介紹。 } #注釋結(jié)束 /** * 析構(gòu)方法 __destruct() 是在對象被銷毀時自動調(diào)用 * 用途：可以進行資源的釋放操作或文件的關(guān)閉操作或信息保存操作 */ public function __destruct() { return parent::__destruct(); // TODO: 析構(gòu)方法 } }

: o; Z( w9 V- C! R

lib_dev.php自定義封裝類庫代碼實例

[PHP] 純文本查看 復(fù)制代碼 <?php #以下兩行代碼，用于開發(fā)環(huán)境下代碼錯誤提示，可根據(jù)提示信息進行代碼檢查，無誤后即可注釋掉！ //ini_set("display_errors", "on"); //error_reporting(E_ALL); #注釋結(jié)束 #引入驗證自帶核心系統(tǒng)類，勿刪！！！ C::import('class/xinxiu', 'plugin/xinxiuvip_network', false); #注釋結(jié)束 class lib_dev { /** * 自定義封裝類庫方法演示，根據(jù)自己的需求進行功能開發(fā)！ * demo_dev 為自定義方法名 * @param [type] $value * @return void */ public static function demo_dev($value) { return $value;//直接返回傳回的值 } }

* ^* Y9 Z0 K% X7 T  B7 ?3 `. a

將接口添加到接口管理數(shù)據(jù)庫實例

將設(shè)定好的接口方法添加到接口管理中心。如果不在此處添加將報錯。   x  z% w2 Z$ [5 r; c1 @& H/ j