# ThinkSDK

**Repository Path**: 37duman/ThinkSDK

## Basic Information

- **Project Name**: ThinkSDK
- **Description**: 基于ThinkPHP的各大开放平台 Open API SDK 扩展。
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2018-03-27
- **Last Updated**: 2024-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 1，SDK简介

本SDK是基于ThinkPHP开发类库扩展，因此只能在ThinkPHP平台下使用（ThinkPHP版本要求2.0以上）。DEMO中用到了控制器分层，因此运行DEMO需使用ThinkPHP3.1.2版本。

### 2，目前支持的平台
目前可用登录平台为：腾讯QQ，腾讯微博，新浪微博，网易微博，人人网，360，豆瓣，Github，Google，MSN，点点，百度，开心网，搜狐。

### 3，包含的文件

`ThinkSDK/ThinkOauth.class.php` SDK基类，主要用于Oauth的认证，所有平台的SDK均需要继承此类    
`ThinkSDK/sdk/DiandianSDK.class.php` （点点SDK）
`ThinkSDK/sdk/DoubanSDK.class.php` （豆瓣SDK）    
`ThinkSDK/sdk/GithubSDK.class.php` （Github SDK）    
`ThinkSDK/sdk/GoogleSDK.class.php` （Google SDK）    
`ThinkSDK/sdk/MsnSDK.class.php` （MSN SDK）    
`ThinkSDK/sdk/QqSDK.class.php` （腾讯QQ SDK）    
`ThinkSDK/sdk/RenrenSDK.class.php` （人人网SDK）    
`ThinkSDK/sdk/SinaSDK.class.php` （新浪微博SDK）    
`ThinkSDK/sdk/T163SDK.class.php` （网易微博SDK）    
`ThinkSDK/sdk/TencentSDK.class.php` （腾讯微博SDK）    
`ThinkSDK/sdk/X360SDK.class.php` （360 SDK）
`ThinkSDK/sdk/BaiduSDK.class.php` （百度SDK）    
`ThinkSDK/sdk/KaixinSDK.class.php` （开心网SDK）    
`ThinkSDK/sdk/SohuSDK.class.php` （搜狐SDK）

### 4，配置格式

SDK的配置格式如下（可参考DEMO中的配置）

	//将一下(TYPE)换成你对应的SDK类型
	'THINK_SDK_(TYPE)' => array(
		'APP_KEY'    => '', //应用注册成功后分配的 APP ID
		'APP_SECRET' => '', //应用注册成功后分配的KEY
		'CALLBACK'   => '', //注册应用填写的callback
	)

### 5，接入登录方法

* 添加ThinkPHP扩展，将整个ThinkSDK目录放入到ThinkPHP的扩展目录下~Extend/Library/ORG/~。
* 添加SDK配置，按以上配置格式在项目配置中添加对应的SDK配置。（可参考DEMO中的配置文件）
* 跳转到授权页面，导入SDK基类`import("ORG.ThinkSDK.ThinkOauth")`，获取SDK实例`$sdk=ThinkOauth::getInstance($type)`，跳转到授权页面`redirect($sdk->getRequestCodeURL())`。（可参考DEMO中的`Index/login`方法）
* 获取`access_token`，在授权成功的回调页面中，调用`$sdk->getAccessToken($code, $extend)`方法来获取`access_token`。（可参考DEMO中的`Index/callback`方法）

### 6，调用API方法

成功获取到`access_token`之后就可以调用相应平台的API了，调用方法比较简单，只需要调用`$sdk->call($api, $param, $method)`方法就可以了，其中：`$api`为接口名称，`$param`为接口参数（格式：`name1=value1&name2=value2`）, `$method`为请求方法（`GET`或`POST`）。

例如：

	import("ORG.ThinkSDK.ThinkOauth"); //导入SDK基类
	$qq   = ThinkOauth::getInstance('qq', $token); //实例化腾讯QQ开放平台对象 $token 参数为授权成功后获取到的 $token
	$data = $qq->call('user/get_user_info'); //调用接口