ThinkPHP5項目中實現(xiàn)QQ第三方登錄功能
1. 找到官方SDK里面的核心文件
框架外使用的時候是include 'qqConnectAPI.php'
,打開這個文件可以看到它是包含了另外幾個文件的,comm文件夾下的幾個文件無非就是定義一些常量,記錄一下你的APP KEY這些信息,都無關(guān)緊要,只要把class文件夾下的幾個類文件放到tp5里面就好了,而且仔細看一下代碼會發(fā)現(xiàn)其實只要拿到三個類就完全可以實現(xiàn)功能了。
2. 放到tp框架里
tp5推薦將第三方的東西,同時又不是composer安裝的統(tǒng)一放到extend目錄下,因為可能以后還要做其他擴展,這里將qq登錄相關(guān)的單獨建一個qqlogin文件夾,
可以看到里面只有三個類,我去掉了一個Recorder和一個ErrorCase類,見名知意,這兩個的作用是記錄一些信息,如access_token,還有異常處理,這里我就直接刪掉了。另外注意,按照psr4規(guī)范,類名要跟文件名一致,所以要把文件名改一下,同時加上命名空間extend\qqlogin,tp5所有的類都要有命名空間。
另外為了防止tp5找不到我們需要的文件,最好在config.php文件里注冊一條根命名空間,在第30行:
// 注冊的根命名空間
'root_namespace' => [
'extend\qqlogin' => '../extend/qqlogin/',
'extend\baidu' => '../extend/bdlogin/'
],
3. 改造源代碼
因為QC.php是繼承了Oauth.php,我們從后者改起,去掉require_once,加上命名空間這個就不說了,首先看成員屬性,類常量是騰訊平臺的地址,不用管,原來有三個屬性,recorder、error不需要,注釋掉或直接刪掉。下文同樣,要想象跟這兩個單詞有仇,看到就注釋或刪掉。
// protected $recorder;
public $urlUtils;
// protected $error;
public $state;
public $appid = "****";
public $callback = "http://****/index/user/qqcallback";
public $scope = "get_user_info";
下面四個屬性是需要添加的,state用于防止CSRF攻擊,下面三個看官方文檔就知道是什么東西了,這些原來是在comm文件夾下的inc.php存放的,現(xiàn)在直接拿過來變成成員屬性。
然后構(gòu)造函數(shù),實例化三個類,有兩個已經(jīng)不存在了,而且上面說了,跟這兩個單詞有仇,看到就要注釋或刪掉。
再看下面的第一個成員方法qq_login()
public function qq_login(){
$appid = $this->recorder->readInc("appid");
$callback = $this->recorder->readInc("callback");
$scope = $this->recorder->readInc("scope");
//---生成唯一隨機串防CSRF攻擊
$state = md5(uniqid(rand(), TRUE));
$this->recorder->write('state',$state);
*
*
return $login_url;
// header("Location:$login_url");
}
我們已經(jīng)有仇把有那兩個單詞的這幾行刪掉了,我們又需要這些東西,不要忘了我們上面增加了三個成員屬性,這些值我們已經(jīng)有了下面用的時候通過$this->appid
就好了。state驗證的時候我們可以通過session去驗證,在tp5里面提供了助手函數(shù)去寫session:
session( 'state' , $this ->state); |
最后一句是header跳轉(zhuǎn),暫不知道什么原因在tp5里面并不能看到跳轉(zhuǎn)效果,于是直接將url返回,再在控制器里面通過tp5的重定向函數(shù)$this->redirect()
實現(xiàn)跳轉(zhuǎn)。
下面看qq_callback()
public function qq_callback(){
// $state = $this->recorder->read("state");
//---驗證state防止CSRF攻擊
if(input('state') != session('state')){
// $this->error("30001");
exit('30001');
}
*
*
// return $params["access_token"];
session('access_token',$params["access_token"]);
}
出現(xiàn)那兩個單詞的已經(jīng)注釋了,我們在qq_login里面有寫session,這里直接取sessio比較就行了,input()也是tp5的助手函數(shù),可以獲得get、post請求的參數(shù),結(jié)果是一個數(shù)組,但是不能夠再動態(tài)為其添加鍵值對,想要添加的話必須將其賦給一個變量,再對變量進行操作。這里有錯誤的話直接exit打印出錯誤號,官方文檔有詳細的錯誤號說明。在最后也是直接將獲取到的access_token寫進session。
下面的get_openid()
方法類似,參數(shù)列表用session構(gòu)建,返回值直接寫進session。
然后再修改QC.php,只需修改構(gòu)造方法,把數(shù)組的三個變量給一下值就好了。
$this->keysArr = array(
"oauth_consumer_key" => (int)$this->appid,
"access_token" => session('access_token'),
"openid" => session('openid')
);
4. 控制器調(diào)用
改造完成,可以在控制器里面使用了,附上代碼入下:
use extend\qqlogin\QC;
// 處理qq登錄
public function qqlogin()
{
$qq = new QC();
$url = $qq->qq_login();
$this->redirect($url);
}
// qq登錄回調(diào)函數(shù)
public function qqcallback(UserModel $user)
{
$qq = new QC();
$qq->qq_callback();
$qq->get_openid();
$qq = new QC();
$datas = $qq->get_user_info();
* // 拿到用戶信息后的處理
*
}
切記:
在回調(diào)函數(shù)里面要實例化兩次QC才能拿到用戶信息,第二次實例化的時候才有openid和access_token兩個參數(shù)。