Skip to content

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

字段类型说明
successbool是否成功
corestring核心数据内容
errorstring错误信息

获取在线数量 getOnlineKamiCount / getOnlineUserCount

php
// 获取在线卡密数量
$result = $verify->getOnlineKamiCount();
if ($result['success']) echo '在线卡密数: ' . $result['count'];

// 获取在线用户数量
$result = $verify->getOnlineUserCount();
if ($result['success']) echo '在线用户数: ' . $result['count'];

返回值array

字段类型说明
successbool是否成功
countint在线数量
errorstring错误信息

获取云文档 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

T3 网络验证 WebAPI 开发文档