Discuz 验证扩展【X3.5】 二次开发 - 在线手册
验证扩展二次开发
本扩展由PHP+MYSQL语言开发,通过内嵌在新秀网络验证系统HOOK钩子,在正常API接口执行时自动调用,不需要扩展时无需设置。1、验证扩展是结合新秀网络验证系统进行的二次开发,不能独立使用;2、验证扩展开发遵循Discuz、新秀网络验证、PHP语言规范开发;3、验证扩展适用于新秀网络验证系统3.5ver1.1版本以后;4、本功能与新秀网络验证系统,代码相互独立,但功能同时执行;5、验证扩展开发可使用Discuz内置函数、新秀网络验证内置函数、PHP函数等。
适用环境:php版本>5.6、Mysql版本>5.5以上、Discuz版本>3.5。
= Discuz资料库= Discuz插件开发文档= 开发交流=BUG反馈=QQ客服:3188639QQ交流群:281079920
二次开发常用函数
1、DB数据库操作函数 /*常用MYSQL数据库操作命令,增、减、改、查功能函数。*/
2、新秀网络验证数据库对照表 /*新秀网络验证系统内部,所有数据库表及说明*/
3、Discuz官方数据库对照表/*Discuz官方数据库表,包括discuz、UCente数据库字典。*/
4、Discuz基础框架、类、函数 /*包含Discuz官方基础框架、类、函数、方法使用说明。*/
5、新秀网络基础框架类、函数 /*包含新秀网络验证基础框架、类、函数、方法使用说明。*/
6、PHP在线手册 /*PHP官方原生态语法、类、库手册。*/
验证扩展开发视频教程
新手入门教程 链接:http://www.xinxiuvip.com/video_list_3.html
验证扩展开发开发示例
1、获取版块主题API更改返回值 点击访问
使 用 简 介
1、下载安装3.5ver1.2以上新秀网络验证系统:点击下载2、安装完成后,在后台点击插件 —> “验证扩展”页面3、根据内置扩展开发说明,进行开发即可,完成后直接保存。
4、内置扩展文件目录说明
Discuz论坛系统内绝对路径:\source\plugin\xinxiu_network\extend\extend_network.phpxinxiu_network \\新秀网络验证系统插件主目录—extend \\内置扩展存放目录——extend_network.php \\验证扩展开发文件 (即:后台“验证扩展”页面内编辑的文件)
5、如何安装、开发、调试?
#1、下载新秀网络验证文件后,自带扩展文件,无需额外下载。#2、使用PHP代码编辑软件或后台验证扩展页面,对扩展文件 extend_network.php 进行开发,注意:UTF8及GBK编码问题。【开发者必须具备基础以上PHP语言水平】#3、如需新增方法类时,请不要与Discuz通用函数类、新秀验证框架通用函数类、PHP语言通用函数类冲突,否则无法使用,开发调试时请做好数据库备份。#4、根据扩展开发文档开发,不想使用某一个钩子功能时,代码进行注释即可,无需删除代码: 单行注释:在代码行前输入: // 双斜杠即可。 多行注释:在代码块上下输入: /* 注释代码行 */即可。
验证扩展 开发 源文件 extend_network.php
<?php
/*
技术支持 QQ:3188639 QQ交流群:281079920
官方网站 http://www.xinxiuvip.com/
获取授权 http://www.xinxiuvip.com/plugin.php?id=xinxiu_license:accredit
扩展开发手册 http://www.xinxiuvip.com/forum.php?mod=viewthread&tid=432
严禁反编译、逆向等任何形式的侵权行为,违者将追究法律责任!
*/
if(!defined('IN_DISCUZ')) {
exit('Access Denied');
}
C::import('class/client','plugin/xinxiu_network',false);//引入系统核心类
class extend_network extends class_client{
public $config;//可自定义变量,在构造方法中设置变量值。
public function __construct()//构造方法
{
$this->config = xx_G::xinxiu_network();//获取新秀网络插件配置信息
parent::__construct(false);//禁止删除或更改
}
//内置扩展代码区域
}
验证全局hook嵌入点实例
/**
* 全局hook特定的类钩子操作
* 此函数调用`hook_xinxiuvip`钩子,允许在特定的程序点插入自定义逻辑。
* 它接受一个包含`$_GET`变量和当前配置的数组作为参数,以便在钩子函数中使用。
* @param string $get_array传递所有当前GET数据
* @param array $config 传递插件配置信息
*/
public function hook_xinxiuvip($get_array,$config){
var_dump($get_array,$config);
}
URLS参数加密传输代码实例
public function hook_urls($function,$action,$urls){
/**
* 高级自定义,参数传输urls解密处理功能
* 如果参数中带有&urls参数,就会调用此功能
* @param string $function 接口模块
* @param string $action 接口方法
* @param string $urls 接口密串
* 无需返回值,直接处理json返回
*/
//将加密的密文串进行解密还原
$str = base64_decode($urls);
//将解密还原的密文串,重新按明文api接口进行组装
$geturl = $_SERVER['SERVER_NAME'].'/plugin.php?id='.$function.'&action='.$action.$str;
$outp = xx_curl::get_url($geturl);//利用内置的api接口get方法进行访问
exit($outp);//退出,并返回数据
}
传输、管理密钥自定义代码实例
public function hook_apikey($key,$salt,$apikey){
/**
* 使用带传输密钥的接口时,触发对传输密钥进行自定义验证!
* @param string $key 用户提交的传输密钥
* @param string $salt 后台设置的salt值
* @param string $apikey 后台设置的传输密钥
* 接收三个参数,进行判断比对!
*/
$md5str = md5($apikey.$salt);
if ($key == $md5str){//判断是否相等
return true;
//正确不做任何处理,跳过系统下一步key逻辑验证。
}else{
return false;
//错误,则进行系统下一步key逻辑验证。也可使用$this->json_output(400,\'返回错误信息\');直接结束。
}
}
public function hook_adminkey($key,$salt,$adminkey){
/**
* 使用带管理密钥的接口时,触发对管理密钥进行自定义验证!
* @param string $key 用户提交的管理密钥
* @param string $salt 后台设置的salt值
* @param string $adminkey 后台设置的管理密钥
* 接收三个参数,进行判断比对!
*/
$md5str = md5($adminkey.$salt);//base64或者RSA、RC4、sha1~
if ($key == $md5str){//判断是否相等
return true ;
//正确不做任何处理,跳过系统下一步adminkey逻辑验证。
}else{
return false;
//错误,则进行系统下一步adminkey逻辑验证。也可使用$this->json_output(400,\'返回错误信息\');直接结束。
}
}
所有接口方法、接口参数代码实例
举例:
用户登录接口:http://xxx.com/...&action=login_user&username=demo&password=demo
其中:login_user 是 接口方法username、password 是 接口参数!
public function hook_action_login_user($uid,$array_get){//所有接口方法调用
/**
* 所有接口方法使用时,触发此操作!调用方式为:“hook_action_+接口方法”,例:hook_action_login_user
* @param string $uid 用户uid
* @param array$array_get 接收用户提交的所有参数及对应值
* 接收以上两个参数,无需返回值,自动执行系统下一步操作。
*/
var_dump($uid,$array_get);//输出返回数据
}
public function hook_param_username($params,$value){//所有参数调用
/**
* 所有接口方法使用时,触发此操作!调用方式为:“hook_param_+参数”,例:hook_param_username
* @param string $params 接口传输参数username名字
* @param string $value 接口传输参数username对应的值
* 接收以上一个参数的值,并返回一个替换的值。return
*/
//正常情况下用户名是 demo
$params = base64_decode($value);//如果是BASE64加密,对值进行解密
return $params;//返回解密结果,替换username参数的值
}
接口方法执行结束代码实例
public function hook_exit_login_user($output){//所有接口方法执行结束,记录日志到数据库之前调用
/**
* 所有接口方法使用时,触发此操作!调用方式为:“hook_exit_接口方法”,例:hook_exit_login_user
* @param string $output 执行结果
* 接收$output参数,无需返回值,如无退出操作,则进行下一步日志入库。
*/
exit($output);//直接退出,则实现日志不入库。
}
login_user登录接口代码实例
public function hook_login_user_start(){//login_user登录接口开始
/**
* 用户通过login_user登录前触发
* 截取提交参数信息$_GET;
* 具体信息参数解释详见login_user接口文档
* 无需返回值,不能结束
*/
var_dump($_GET);
}
public function hook_login_user_end($arr){//login_user登录接口结束
/**
* 用户通过login_user登录结束后触发
* 接收返回数据$arr;
* $arr--用户uid 、$arr--用户名、$arr--用户密码、$arr--用户邮箱;
* 其中$arr大于 0:返回用户 ID,表示用户登录成功、-1:用户不存在,或者被删除、-2:密码错、-3:安全提问错
* 无需返回值,不能结束
*/
var_dump($arr);
}
login_register注册接口代码实例
public function hook_login_register_start(){//login_register注册接口开始
/**
* 用户通过login_register登录前触发
* 截取提交参数信息$_GET;
* 具体信息参数解释详见login_register接口文档
* 无需返回值,不能结束
*/
var_dump($_GET);
}
public function hook_login_register_end($uid){//login_register注册接口结束
/**
* 用户通过login_register登录结束后触发
* 接收返回数据$uid;
* 当$uid大于 0:返回用户 ID,表示用户注册成功、-1:用户名不合法、-2:包含不允许注册的词语、
-3:用户名已经存在、-4:Email 格式有误、-5:Email 不允许注册、-6:该 Email 已经被注册
* 无需返回值,不能结束
*/
var_dump($uid);
}
页:
[1]