PHPackages                             xianrenqh/dingxiang-php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. xianrenqh/dingxiang-php-sdk

ActiveLibrary[API Development](/categories/api)

xianrenqh/dingxiang-php-sdk
===========================

Dingxiang PHP SDK

v0.0.3(3y ago)1146Apache-2.0PHP

Since Jun 28Pushed 3y ago1 watchersCompare

[ Source](https://github.com/xianrenqh/dingxiang-php-sdk)[ Packagist](https://packagist.org/packages/xianrenqh/dingxiang-php-sdk)[ RSS](/packages/xianrenqh-dingxiang-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)DependenciesVersions (3)Used By (0)

顶象PHP SKD
=========

[](#顶象php-skd)

因为要使用Thinkphp和Webman框架，而官方没有提供Composer安装，故自己弄一个集成。

依赖项
---

[](#依赖项)

请在安装之前确保以下模块已安装且可用，否则运行的时候会报错：

- PHP JSON模块
- PHP CURL模块

安装
--

[](#安装)

在项目的根目录执行安装指令：

> composer require xianrenqh/dingxiang-php-sdk

使用
--

[](#使用)

目前仅支持以下服务：

- 设备指纹
- 无感验证
- 实时风险决策

案例
--

[](#案例)

### php服务端使用

[](#php服务端使用)

```
use xianrenqh\Dingxiang\CaptchaClient;
$appId     = "appId";
$appSecret = "appSecret";
$client    = new CaptchaClient($appId, $appSecret);
$client->setTimeOut(2);

//指定服务器地址，saas可在控制台，应用管理页面最上方获取
$client->setCaptchaUrl("https://xxx.dingxiang-inc.com/api/tokenVerify");

$response = $client->verifyToken($param['captcha_token']);
var_dump($response->serverStatus);
//确保验证状态是SERVER_SUCCESS，SDK中有容错机制，在网络出现异常的情况会返回通过

if($response->result){
    echo "true";
    /**token验证通过，继续其他流程**/
}else{
    echo "false";
    /**token验证失败**/
}
```

### web端接入

[](#web端接入)

获取appId

请先进入顶象控制台（或点击右上角登陆按钮）中的“应用管理”或“应用配置”模块，并找到appId。

引入 JS

```

```

> 注意：由于验证码 JS 会不定期升级更新，请直接引用顶象 CDN 上的资源，以便及时获得最新安全防护。不要将 JS 文件下载到自己服务器使用。

初始化 以下分别列举Javascript、React、Vue的初始化接入示例代码：

#### Javascript 示例

[](#javascript-示例)

假设页面上有一个

```

```

，则可以像下面这样初始化验证码。

```
var myCaptcha = _dx.Captcha(document.getElementById('c1'), {
  appId: 'appId', //appId，在控制台应用管理或应用配置模块获取
  apiServer: 'https://xxx.dingxiang-inc.com',
 // apiServer域名地址在控制台页面->无感验证->应用管页面左上角获取，必须填写完整包括https://。
  success: function (token) {
    // console.log('token:', token)
    // 获取验证码token，用于后端校验，注意获取token若是sl开头的字符串，则是前端网络不通生成的降级token,请检查前端网络及apiServer地址。
  }
})
```

初始化完成后，验证码组件会被插入到

 中。#### React 示例

[](#react-示例)

假设页面上有一个

，则可以像下面这样初始化验证码：```
// 类组件使用componentDidMount
useEffect(() => {
  _dx.Captcha(document.getElementById('demo'), {
    appId: 'appId', //appId，在控制台应用管理或应用配置模块获取
    apiServer: 'https://xxx.dingxiang-inc.com',
    // apiServer域名地址在控制台页面->无感验证->应用管页面左上角获取，必须填写完整包括https://。
    success: token => {
      // 获取验证码token，用于后端校验，注意获取token若是sl开头的字符串，则是前端网络不通生成的降级token,请检查前端网络及apiServer地址。
      console.log(token);
    }
  });
}, [])
```

可点击查看 React完整示例代码 初始化完成后，验证码组件会被插入到 &lt;div id="demo"中。

#### Vue 示例

[](#vue-示例)

假设页面上有一个

，则可以像下面这样初始化验证码：```
mounted() {
  _dx.Captcha(this.$refs.demo, {
    // appId, 在控制台应用管理或应用配置模块获取
    appId: "appId",
    apiServer: 'https://xxx.dingxiang-inc.com',
    // apiServer域名地址在控制台页面->无感验证->应用管页面左上角获取，必须填写完整包括https://。
    success: token => {
      // 获取验证码token，用于后端校验，注意获取token若是sl开头的字符串，则是前端网络不通生成的降级token,请检查前端网络及apiServer地址。
      console.log(token);
    }
  });
}
```

可点击查看 Vue完整示例代码 初始化完成后，验证码组件会被插入到 &lt;div ref="demo"中。

其他具体使用方法请参考

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

1413d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ed4f84e03b6cfd0431c149514b0d5a0186271f2922b96bf2c59931e6308b6fcf?d=identicon)[xianrenqh](/maintainers/xianrenqh)

---

Top Contributors

[![xianrenqh](https://avatars.githubusercontent.com/u/16522281?v=4)](https://github.com/xianrenqh "xianrenqh (1 commits)")

### Embed Badge

![Health badge](/badges/xianrenqh-dingxiang-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/xianrenqh-dingxiang-php-sdk/health.svg)](https://phpackages.com/packages/xianrenqh-dingxiang-php-sdk)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[microsoft/microsoft-graph

The Microsoft Graph SDK for PHP

65723.5M96](/packages/microsoft-microsoft-graph)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
