PHP QQ网页三方登录

一、在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网页登录的同学