PHP 第三方登录 (QQ登录)过程详解 demo

nanxia6个月前学无止境433

Step1:获取Authorization Code

请求地址 :
PC网站:https://graph.qq.com/oauth2.0/authorize
请求方法 :
GET
请求参数 :
请求参数请包含如下内容:

参数是否必须含义
response_type必须授权类型,此值固定为“code”。
client_id必须申请QQ登录成功后,分配给应用的appid。
redirect_uri必须成功授权后的回调地址,必须是注册appid时填写的主域名下的地址,建议设置为网站首页或网站的用户中心。注意需要将url进行URLEncode。
state必须client端的状态值。用于第三方应用防止CSRF攻击,成功授权后回调时会原样带回。请务必严格按照流程检查用户与state参数状态的绑定。
scope可选请求用户授权时向用户显示的可进行授权的列表。可填写的值是[API文档](https://wiki.connect.qq.com/api%e5%88%97%e8%a1%a8 "API列表")中列出的接口,如果要填写多个接口名称,请用逗号隔开。例如:scope=get_user_info,list_album,upload_pic 不传则默认请求对接口get_user_info进行授权。建议控制授权项的数量,只传入必要的接口名称,因为授权项越多,用户越可能拒绝进行任何授权。
display可选PC网站接入时使用。用于展示的样式。不传则默认展示为PC下的样式。如果传入“mobile”,则展示为mobile端下的样式。

返回说明 :

  1. 如果用户成功登录并授权,则会跳转到指定的回调地址,并在redirect_uri地址后带上Authorization Code和原始的state值。如:
    PC网站:http://graph.qq.com/demo/index.jsp?code=9A5F**06AF&state=test
    注意:此code会在10分钟内过期。

  2. 如果用户在登录授权过程中取消登录流程,对于PC网站,登录页面直接关闭;
    错误码说明 :
    接口调用有错误时,会返回code和msg字段,以url参数对的形式返回,value部分会进行url编码(UTF-8)。
    PC网站接入时,错误码详细信息请参见:100000-100031:PC网站接入时的公共返回码

Step2:通过Authorization Code获取Access Token

请求地址 :
PC网站:https://graph.qq.com/oauth2.0/token
请求方法 :
GET
请求参数 :
请求参数请包含如下内容:

参数是否必须含义
grant_type必须授权类型,在本步骤中,此值为“authorization_code”。
client_id必须申请QQ登录成功后,分配给网站的appid。
client_secret必须申请QQ登录成功后,分配给网站的appkey。
code必须上一步返回的authorization code。如果用户成功登录并授权,则会跳转到指定的回调地址,并在URL中带上Authorization Code。例如,回调地址为www.qq.com/my.php,则跳转到:http://www.qq.com/my.php?code=520DD95263C1CFEA087******注意此code会在10分钟内过期。
redirect_uri必须与上面一步中传入的redirect_uri保持一致。
fmt可选因历史原因,默认是x-www-form-urlencoded格式,如果填写json,则返回json格式

返回说明 :

如果成功返回,即可在返回包中获取到Access Token。 如(不指定fmt时):

access_token=FE04CCE2&expires_in=7776000&refresh_token=88E4BE14

参数说明描述
access_token授权令牌,Access_Token。
expires_in该access token的有效期,单位为秒。
refresh_token在授权自动续期步骤中,获取新的Access_Token时需要提供的参数。注:refresh_token仅一次有效

错误码说明 :
接口调用有错误时,会返回code和msg字段,以url参数对的形式返回,value部分会进行url编码(UTF-8)。
PC网站接入时,错误码详细信息请参见:100000-100031:PC网站接入时的公共返回码

Step3:(可选)权限自动续期,获取Access Token

Access_Token的有效期默认是30天,过期后需要用户重新授权才能获得新的Access_Token。本步骤可以实现授权自动续期,避免要求用户再次授权的操作,提升用户体验。
请求地址 :
PC网站:https://graph.qq.com/oauth2.0/token
请求方法 :
GET
请求参数 :
请求参数请包含如下内容:

参数是否必须含义
grant_type必须授权类型,在本步骤中,此值为“refresh_token”。
client_id必须申请QQ登录成功后,分配给网站的appid。
client_secret必须申请QQ登录成功后,分配给网站的appkey。
refresh_token必须首次:使用在Step2中获取到的最新的refresh_token。后续:使用刷新后返回的最新refresh_token
fmt可选因历史原因,默认是x-www-form-urlencoded格式,如果填写json,则返回json格式

返回说明 :
如果成功返回,即可在返回包中获取到Access Token。 如(不指定fmt时):
access_token=FE04CCE2&expires_in=7776000&refresh_token=88E4BE14。

参数说明描述
access_token授权令牌,Access_Token。
expires_in该access token的有效期,单位为秒。
refresh_token在授权自动续期步骤中,获取新的Access_Token时需要提供的参数。每次生成最新的refresh_token,且仅一次有效,一次登录,refresh_token整个续票过程,最长有效期:6个月。

获取用户OpenID_OAuth2.0

1 请求地址

PC网站:https://graph.qq.com/oauth2.0/me

2 请求方法

GET

3 请求参数

请求参数请包含如下内容:

参数是否必须含义
access_token必须在Step1中获取到的access token。
fmt可选因历史原因,默认是jsonpb格式,如果填写json,则返回json格式

4 返回说明

PC网站接入时,获取到用户OpenID,返回包如下(如果fmt参数未指定):

callback( {"client_id":"YOUR_APPID","openid":"YOUR_OPENID"} );

openid是此网站上唯一对应用户身份的标识,网站可将此ID进行存储便于用户下次登录时辨识其身份,或将其与用户在网站上的原有账号进行绑定。

5 错误码说明

接口调用有错误时,会返回code和msg字段,以url参数对的形式返回,value部分会进行url编码(UTF-8)。
PC网站接入时,错误码详细信息请参见:100000-100031:PC网站接入时的公共返回码


第一版测试DEMO




<?php/*
 * @Descripttion: www.nx260.com
 * @version: 1.0
 * @Author: Nanxia
 * @Date: 2022-12-10 01:08:41
 * @LastEditors: Nanxia
 * @LastEditTime: 2022-12-15 01:18:18
 */$APPID = '填写应用APPID';$APPKey = '填写应用APPKey';$state = urlencode($_GET['state']);$redirect_uri = urlencode('http://api.nx260.com/qq/callback.php').'&state='.$state; //调用登录 获取Authorization Code
 if ($_GET['state']&&$_GET['login']) {    $state = urlencode($_GET['state']);    $url = 'https://graph.qq.com/oauth2.0/authorize?response_type=code&client_id='.$APPID.'&redirect_uri='.$redirect_uri;
    header('Location: '.$url.'');
}#通过Authorization Code获取Access Tokenif ($_GET['code']&&$_GET['state']) {    $url = 'https://graph.qq.com/oauth2.0/token?grant_type=authorization_code&client_id='.$APPID.'&client_secret='.$APPKey.'&code='.$_GET['code'].'&redirect_uri='.$redirect_uri;    $file_contents = file_get_contents($url);
    parse_str($file_contents,$arr);    echo $_GET['state'];    $access_token = $arr['access_token'];$expires_in = $arr['expires_in'];$refresh_token = $arr['refresh_token'];    if (!empty($access_token)) {        $url = 'https://graph.qq.com/oauth2.0/me?access_token='.$access_token.'&unionid=1&fmt=json';       // echo file_get_contents($url);
        $token = json_decode(file_get_contents($url),true);        $url2 = 'https://graph.qq.com/user/get_user_info?access_token='.$access_token.'&oauth_consumer_key='.$APPID.'&openid='.$token['openid'];        $a = file_get_contents($url2);
        print_r(json_decode($a,true));
    }
}



相关文章

PHP 常用的header头部定义汇总

header('HTTP/1.1 200 OK'); // ok 正常访问 header('HTTP/1.1 40...

小储云商城下单对接API PHP版

该示例用于直接下单,返回成功or失败,无其他功能,根据官方文档简单调写<?php          //接收参...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。