Appearance
PHP SDK
T3 网络验证 PHP SDK,支持 Base64 自定义编码集和 RSA 两种加密算法。
适用场景
- PHP Web 应用 / 命令行脚本
- 适用于 PHP 7.0+
依赖说明
- Base64 模式:无额外依赖
- RSA 模式:需要 PHP
openssl扩展(通常已内置)
初始化
php
<?php
require_once __DIR__ . '/t3sdk/t3sdk.php';
$verify = new T3Verify();
// RSA 算法(推荐)
$verify->init([
'login_code' => '你的单码登录调用码',
'notice_code' => '你的公告调用码',
'version_code' => '你的版本号调用码',
'heartbeat_code' => '你的心跳调用码',
'appkey' => '你的程序APPKEY',
'rsa_public_key' => '-----BEGIN PUBLIC KEY-----
你的RSA公钥
-----END PUBLIC KEY-----',
'encode_type' => 'rsa',
]);后台配置
使用 SDK 前,请先完成 后台快速配置。您也可以在后台「SDK 下载与注入」页面一键自动配置并下载已注入配置信息的 SDK,无需手动填写。
推荐调用顺序
API 方法参考
返回值格式
所有方法返回关联数组(array),包含 success(bool)和业务数据字段。
获取机器码
php
$machineCode = getMachineCode();获取程序公告 getNotice()
php
$result = $verify->getNotice();
if ($result['success']) {
echo "公告: {$result['notice']}\n";
}获取最新版本号 getLatestVersion()
php
$result = $verify->getLatestVersion();
if ($result['success']) {
echo "最新版本: {$result['version']}\n";
}单码卡密登录 login($kami, $imei)
php
$result = $verify->login($card, $machineCode);
if ($result['success']) {
echo "到期时间: {$result['end_time']}\n";
$statecode = $result['statecode'];
}单码心跳验证 heartbeat($kami, $statecode)
php
$result = $verify->heartbeat($card, $statecode);
if ($result['success']) {
echo "心跳验证成功\n";
}检查更新 checkUpdate($ver)
php
$result = $verify->checkUpdate('1000');
if ($result['success']) {
if ($result['has_update']) {
echo "最新版本: {$result['ver']}\n";
echo "更新公告: {$result['uplog']}\n";
echo "下载地址: {$result['upurl']}\n";
}
}查询卡密信息 queryKami($kami)
php
$result = $verify->queryKami($card);
if ($result['success']) {
echo "到期时间: {$result['end_time']}\n";
echo "剩余时间: {$result['available']}秒\n";
}用户注册 userRegister($user, $password, $email)
php
$result = $verify->userRegister('username', 'password', 'email@example.com');
if ($result['success']) {
echo "注册成功\n";
}用户登录 userLogin($user, $password, $imei)
php
$result = $verify->userLogin('username', 'password', $machineCode);
if ($result['success']) {
echo "到期时间: {$result['end_time']}\n";
$userStatecode = $result['statecode'];
}用户心跳验证 userHeartbeat($user, $password, $statecode)
php
$result = $verify->userHeartbeat('username', 'password', $userStatecode);用户充值 recharge($user, $card)
php
$result = $verify->recharge('username', 'recharge_card');用户绑定QQ bindQQ($user, $password, $openid, $accessToken)
php
$result = $verify->bindQQ('username', 'password', 'openid', 'access_token');用户QQ登录 qqLogin($openid, $accessToken)
php
$result = $verify->qqLogin('openid', 'access_token');解绑设备 unbindKami / unbindUser
php
// 单码解绑
$result = $verify->unbindKami($card, $machineCode);
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";
// 用户解绑
$result = $verify->unbindUser('username', 'password', $machineCode);
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";IP 解绑 ipUnbindKami / ipUnbindUser
php
// 单码 IP 解绑
$result = $verify->ipUnbindKami($card);
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";
// 用户 IP 解绑
$result = $verify->ipUnbindUser('username', 'password');
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";获取远程变量 getVariableByKami / getVariableByUser
php
// 通过卡密获取
$result = $verify->getVariableByKami($card, '变量ID', '变量名称');
if ($result['success']) echo "变量值: {$result['value']}\n";
else echo "失败: {$result['error']}\n";
// 通过用户获取
$result = $verify->getVariableByUser('username', 'password', '变量ID', '变量名称');
if ($result['success']) echo "变量值: {$result['value']}\n";
else echo "失败: {$result['error']}\n";修改远程变量 modifyVariableByKami / modifyVariableByUser
php
// 通过卡密修改
$result = $verify->modifyVariableByKami($card, '变量ID', '新内容');
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";
// 通过用户修改
$result = $verify->modifyVariableByUser('username', 'password', '变量ID', '新内容');
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";修改核心数据 modifyCoreByKami / modifyCoreByUser
php
// 通过卡密修改
$result = $verify->modifyCoreByKami($card, '核心数据');
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";
// 通过用户修改
$result = $verify->modifyCoreByUser('username', 'password', '核心数据');
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";获取核心数据 getCoreByKami / getCoreByUser
php
// 通过卡密获取
$result = $verify->getCoreByKami($card);
if ($result['success']) echo '核心数据: ' . $result['core'];
// 通过用户获取
$result = $verify->getCoreByUser('username', 'password');
if ($result['success']) echo '核心数据: ' . $result['core'];返回值:array
| 字段 | 类型 | 说明 |
|---|---|---|
success | bool | 是否成功 |
core | string | 核心数据内容 |
error | string | 错误信息 |
获取在线数量 getOnlineKamiCount / getOnlineUserCount
php
// 获取在线卡密数量
$result = $verify->getOnlineKamiCount();
if ($result['success']) echo '在线卡密数: ' . $result['count'];
// 获取在线用户数量
$result = $verify->getOnlineUserCount();
if ($result['success']) echo '在线用户数: ' . $result['count'];返回值:array
| 字段 | 类型 | 说明 |
|---|---|---|
success | bool | 是否成功 |
count | int | 在线数量 |
error | string | 错误信息 |
获取云文档 getCloudDoc($token)
php
$result = $verify->getCloudDoc('云文档Token');
if ($result['success']) {
echo "内容: {$result['content']}\n";
}应用签名比对 appSign($autograph)
php
$result = $verify->appSign('应用签名');
if ($result['success']) {
echo " {$result['msg']}\n";
echo " 后台签名: {$result['autograph']}\n";
} else {
echo " 失败: {$result['error']}\n";
}用户修改密码 changePassword($user, $oldpass, $newpass)
php
$result = $verify->changePassword('username', '旧密码', '新密码');禁用 disableKami / disableUser
php
// 禁用卡密
$result = $verify->disableKami($card);
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";
// 禁用用户
$result = $verify->disableUser('username', 'password');
echo $result['success'] ? " {$result['msg']}\n" : " 失败: {$result['error']}\n";用户注销 userCancel($user, $password)
php
$result = $verify->userCancel('username', 'password');完整示例
php
<?php
require_once __DIR__ . '/t3sdk/t3sdk.php';
$verify = new T3Verify();
$verify->init([
'login_code' => 'F2FA89AD46C050B2',
'notice_code' => '3512425FE75AE73A',
'version_code' => 'F119CF1323743DBC',
'heartbeat_code' => 'B1D2263C3702177F',
'appkey' => '5d116108006a454d538839ccff2d32f9',
'rsa_public_key' => '-----BEGIN PUBLIC KEY-----
...
-----END PUBLIC KEY-----',
'encode_type' => 'rsa',
]);
$card = '你的卡密';
$machineCode = getMachineCode();
// 1. 获取公告
$result = $verify->getNotice();
if ($result['success']) echo "公告: {$result['notice']}\n";
// 2. 获取版本号
$result = $verify->getLatestVersion();
if ($result['success']) echo "最新版本: {$result['version']}\n";
// 3. 单码登录
$result = $verify->login($card, $machineCode);
if ($result['success']) {
echo "到期时间: {$result['end_time']}\n";
// 4. 心跳验证
$hb = $verify->heartbeat($card, $result['statecode']);
if ($hb['success']) echo "心跳验证成功\n";
}运行
bash
php main.php