一、在QQ互聯上註冊成為開發者
註冊指南地址：http://wiki.connect.qq.com/%E6%88%90%E4%B8%BA%E5%BC%80%E5%8F%91%E8%80%85

二、建立應用，獲取APP ID和APP Key
建立應用指南地址：http://wiki.connect.qq.com/__trashed-2
1、進入QQ互聯後臺建立網站應用
https://connect.qq.com/manage.html#/

2、網站基本資訊
此處主要填寫網站名字、選擇網站類別、網站簡介、以及上傳網站的log圖片

3、平臺資訊
網站地址：請填寫可訪問的域名，不能是IP地址
網站回撥域：請填寫可訪問的域名，不能是IP地址
主辦單位以及網站備案號

注：請注意網站回撥域，這個地址需要對應到後面SDK配置回撥地址的域匹配

三、下載對應SDK
我這裡使用PHP SDK，下載地址：

http://wiki.connect.qq.com/sdk%E4%B8%8B%E8%BD%BD

下載完SDK，需要使用SDK提供的網頁配置引數，如下截圖說明：


假設APP ID：123456789
假設APP Key：abcdefghl
假設第二步中申請的網站回撥域為 www.testqqlogin.com,
那麼回撥可以設定為：http://www.testqqlogin.com/?r=member/qqcallback
ps:
1、重點關注第二步中回撥域的設定，需要設定為域名形式，如www.xxx.com,test.yyy.com等，而非www.aaaa.com/test.php
2、同樣，重點關注SDK配置回撥設定，前面域名必須和QQ互聯回撥域設定一致，比如：
假如回撥域設定為：www.testqqlogin.com
那麼SDK回撥必須設定為 http://www.testqqlogin.com/oauth/callback.php 或者 http://www.testqqlogin.com/?r=member/qqcallback

但是，不能把SDK回撥域設定為以下
http://www.testqqlogin.com/index.php?r=member/qqcallback

當完成以上配置之後，它會自動在SDK目錄下的API\comm生成一個名為inc.php的配置檔案，開發人員只需要把SDK中的API這個目錄提取到自己的專案中即可

四、程式碼配置

4.1、前端網頁QQ三方登入按鈕(按鈕ID為login_qq)事件配置

<script>

        $(document).ready(function () {
            $('#login_qq').click(function () {
                window.location.href = "<?=\yii\helpers\Url::to(['member/qqlogin'])?>";
//                window.open("<?//=\yii\helpers\Url::to(['member/qqlogin'])?>//","TencentLogin","width=800,height=600,menubar=0,scrollbars=1,resizable=1,status=1,titlebar=0,toolbar=0,location=1");
            });
        });

    </script>
 

4.2、PHP後端處理程式碼，處理前端QQ三方登入按鈕

/**
 * 跳轉QQ登入頁面
 */
public function actionQqlogin(){
	require_once ("../vendor/qqlogin/qqConnectAPI.php");
	$qc = new \QC();
	$qc->qq_login();
}

4.3、QQ登入成功，回撥

/**
 * 處理QQ登入之後QQ伺服器的回撥callback
 */
public function actionQqcallback(){
	require_once ('../vendor/qqlogin/qqConnectAPI.php');
	//獲取登入QQ的資訊
	$auth = new \OAuth();
	$access_token = $auth->qq_callback();
	$openid = $auth->get_openid();
	$qc = new \QC($access_token, $openid);
	$userInfo = $qc->get_user_info();//獲取使用者資訊陣列，包括暱稱，頭像等

	//寫session
	$session = \Yii::$app->session;
	$session['userinfo'] = $userInfo;
	$session['openid'] = $openid;

	//QQ登入前，判斷QQ對應使用者是否已經在資料庫中，否則先插入資料庫，並跳到actionQqreg這個函式執行
	$model = new User();
	if(!$model->findQqUser($openid)){//沒找到，先註冊
		return $this->redirect(['member/qqreg']);
	}

	//QQ登入
	if($model->qqlogin()){
		return $this->redirect(['/']);
	}else{
		\Yii::$app->session->setFlash('thirdparty_info', '登入失敗');
		return $this->render('auth',['model'=>$model]);
	}
}

4.4、處理回撥中的QQ第一次登入，需要寫入資料庫

/**
 * QQ註冊,寫入資料庫
 */
public function actionQqreg(){
	$this->layout = 'layout_second';
	$model = new User();
	if(\Yii::$app->request->isPost){
		$model->scenario = User::SCENARIO_REG_QQ;
		//組裝
		$post = \Yii::$app->request->post();
		$post['User']['openid'] = \Yii::$app->session['openid'];
		if($model->load($post) && $model->validate()){
			//QQ使用者新增
			if($model->regQqUser() !== false){
				//QQ登入
				if($model->qqlogin()){
					return $this->redirect(['/']);
				}else{
					\Yii::$app->session->setFlash('info', '註冊失敗');
				}
			}else{
				\Yii::$app->session->setFlash('info', '註冊失敗');
			}
			$model->userpass = '';
			$model->useremail = '';
			$model->repass = '';
		}
	}

	return $this->render('qqreg', ['model'=>$model]);
}

五、問題

5.1、點選qq登入按鈕，但頁面卻是一片空白，這是什麼原因呢

這是QQ外掛的問題，需要調整其SDK原始碼qq_login函式，把header改為js方式跳轉，如下

//header("Location:$login_url");
echo "<script>window.location.href='$login_url'</script>";

六、總結

PHP整合QQ網頁登入功能，整體上都很簡單。主要花費的時間在回撥域和回撥地址設定上，這導致我花了很長時間去調整，這和之前整合支付寶支付很類似，同樣在回撥地址的設定出錯，導致整體整合進度延後。這也是我為什麼在第三步中詳細描述設定的原因，希望能幫助到整合QQ網頁登入的同學