#### **开发准备** **SDK 获取** 1. 直接下载 点击 [此处](http://xunxicloud-1251332768.file.myqcloud.com/sinser-php-sdk.zip) 下载 SDK 2. GitHub ~~~ #在GitHub中获取代码 https://github.com/iSinser/sinser-php-sdk ~~~ 将源代码放入您的项目目录下即可使用 3. Composer 在项目目录下,新建一个composer.json的文件,内容如下 ~~~ #利用Composer下载 { "require": { "isinser/sinser-php-sdk": ">=1.0.0" } } ~~~ 然后使用下面的命令进行安装: `composer install` 或直接使用以下代码: `composer require isinser/sinser-php-sdk` #### **调用说明** 在调用 PHP SDK 封装的相关功能前,需配置参数。 ~~~ $sinser = new sinser; $user = '';//ID 即登录帐号 需改动 $ak = '';//SID 需改动 $sk = '';//SecretKey 需改动 $salt = rand('100000','999999');//盐值 无需改动 $sign_time = time();//签名时间戳 无需改动 ~~~ 将 SDK 中以上赋值代码的 $user 、$ak 、$sk 三个变量的值替换为开发者所拥有的各项数据。 #### **基本方法描述** #### **发起统计** **请求示例** ~~~ //生成有效签名 $Authorization = $sinser -> getAuthorization($user,$ak,$sk,$sign_time,$salt); ~~~ **参数说明** Authorization()方法共四个参数,描述如下: | 参数 | 描述 | | --- | --- | | 参数一 | 填写开发者的登录帐号 | | 参数二 | 填写需统计对象的 SID | | 参数三 | 填写开发者的 SecretKey | | 参数四 | 签名签发时间戳(已配置,无需更改) | | 参数五 | 盐值 salt ,即6位随机数(已配置,无需更改) | #### **发起统计** **请求示例** ~~~ //发起统计 $ret = $sinser -> statistics($ak,$Authorization); ~~~ **参数说明** statistics()方法共两个参数,描述如下: | 参数 | 描述 | | --- | --- | | 参数一 | 填写需统计对象的 SID | | 参数二 | 填写由 getAuthorization() 方法生成的鉴权密钥(Authorization) | #### **查询数据** **请求示例** ~~~ //发起统计 $ret = $sinser -> getdata($ak,$sk); ~~~ **参数说明** statistics()方法共三个参数,描述如下: | 参数 | 描述 | | --- | --- | | 参数一 | 填写需统计对象的 SID | | 参数二 | 填写开发者的 SecretKey | #### **用户上线** 发起统计请求中已包含了用户上线,该独立的接口仅用于保持用户存活,达到用户长期在线。 **请求示例** ~~~ //用户上线 $ret = $sinser -> online($ak,$Authorization); ~~~ **参数说明** online()方法共两个参数,描述如下: | 参数 | 描述 | | --- | --- | | 参数一 | 填写需统计对象的 SID | | 参数二 | 填写由 getAuthorization() 方法生成的鉴权密钥(Authorization) |