您现在的位置是：首页 > 博客日记 > Php Php
第三方登录包(整合微信、QQ、微博、支付宝、GitHub、Facebook、Twitter、Line、Google)
2018-07-05 00:00:00 【Php】 人已围观
Integrating many third party login interfaces, including qq-login、wx-login、sina-login、github-login、alipay-login and so on
通用第三方登录说明文档
- 微信
- 微博
- 支付宝
- GitHub
- Line
安装
composer require tinymeng/oauth:~1.0.2 -vvv
类库使用的命名空间为
\\tinymeng\\oauth
目录结构
.├── example 代码源文件目录│ └── wx_proxy.php 微信多域名代理文件├── src 代码源文件目录│ ├── Connector│ │ ├── Gateway.php 必须继承的抽象类│ │ └── GatewayInterface.php 必须实现的接口│ ├── Gateways│ │ ├── Alipay.php│ │ ├── Facebook.php│ │ ├── Github.php│ │ ├── Google.php│ │ ├── Line.php│ │ ├── Qq.php│ │ ├── Twitter.php│ │ ├── Weibo.php│ │ └── Weixin.php│ ├── Helper│ │ ├── ConstCode.php 公共常量│ │ └── Str.php 字符串辅助类│ └── OAuth.php 抽象实例类├── composer.json composer文件├── LICENSE MIT License└── README.md 说明文件
公共方法
在接口文件中，定义了4个方法，是每个第三方基类都必须实现的，用于相关的第三方登录操作和获取数据。方法名如下：
/*** Description: 得到跳转地址* @author: JiaMeng <666@majiameng.com>* Updater:* @return mixed*/public function getRedirectUrl();/*** Description: 获取当前授权用户的openid标识* @author: JiaMeng <666@majiameng.com>* Updater:* @return mixed*/public function openid();/*** Description: 获取格式化后的用户信息* @author: JiaMeng <666@majiameng.com>* Updater:* @return mixed*/public function userInfo();/*** Description: 获取原始接口返回的用户信息* @author: JiaMeng <666@majiameng.com>* Updater:* @return mixed*/public function getUserInfo();
微信有一个额外的方法，用于获取代理请求的地址
/*** 获取中转代理地址*/public function getProxyURL();
/*** 回调中如果是App登录*/$userInfo = OAuth::$name($this->config)->setIsApp()->userInfo();
典型用法
以ThinkPHP5为例
<?phpnamespace app\index\controller;use think\Config;use tinymeng\OAuth2\OAuth;use tinymeng\tools\Tool;class Login extends Common{protected $config;/*** Description: 登录* @author: JiaMeng <666@majiameng.com>* Updater:* @param $name* @return mixed*/public function index($name){if (empty(input('get.'))) {/** 登录 */$result = $this->login($name);$this->redirect($result);}/** 登录回调 */$this->callback($name);return $this->fetch('index');}/*** Description: 获取配置文件* @author: JiaMeng <666@majiameng.com>* Updater:* @param $name*/public function getConfig($name){//可以设置代理服务器，一般用于调试国外平台//$this->config['proxy'] = '//127.0.0.1:1080';$this->config = Config::get($name);if($name == 'weixin'){if(!Tool::isMobile()){$this->config = $this->config['pc'];//微信pc扫码登录}elseif(Tool::isWeiXin()){$this->config = $this->config['mobile'];//微信浏览器中打开}else{echo '请使用微信打开!';exit();//手机浏览器打开}$this->config['state'] = '//www.majiameng.com/login/weixin';}}/*** Description: 登录链接分配，执行跳转操作* Author: JiaMeng <666@majiameng.com>* Updater:*/public function login($name){/** 获取配置 */$this->getConfig($name);/*** 如果需要微信代理登录，则需要：* 1.将wx_proxy.php放置在微信公众号设定的回调域名某个地址，如 //www.abc.com/proxy/wx_proxy.php* 2.config中加入配置参数proxy_url，地址为 //www.abc.com/proxy/wx_proxy.php* 然后获取跳转地址方法是getProxyURL，如下所示*///$this->config['proxy_url'] = '//www.abc.com/proxy/wx_proxy.php';$oauth = OAuth::$name($this->config);if(Tool::isMobile() || Tool::isWeiXin()){/*** 对于微博，如果登录界面要适用于手机，则需要设定->setDisplay('mobile')* 对于微信，如果是公众号登录，则需要设定->setDisplay('mobile')，否则是WEB网站扫码登录* 其他登录渠道的这个设置没有任何影响，为了统一，可以都写上*/$oauth->setDisplay('mobile');}return $oauth->getRedirectUrl();}/*** Description: 登录回调* @author: JiaMeng <666@majiameng.com>* Updater:* @param $name* @return bool*/public function callback($name){/** 获取配置 */$this->getConfig($name);/** 获取第三方用户信息 */$userInfo = OAuth::$name($this->config)->userInfo();/*** 如果是App登录* $userInfo = OAuth::$name($this->config)->setIsApp()->userInfo();*///获取登录类型$userInfo['type'] = \tinymeng\OAuth2\Helper\ConstCode::getType($userInfo['channel']);var_dump($userInfo);die;}}
通过系统自动设置state，如有需要请自行处理验证，state也放入config里即可
Line和Facebook强制要求传递state，如果你没有设置，则会传递随机值
如果要验证state，则在获取用户信息的时候要加上->mustCheckState()方法。
$snsInfo = OAuth::$name($this->config)->mustCheckState()->userinfo();
注意，不是所有的平台都支持传递state，请自行阅读官方文档链接,各个文档在实现类里有说明.
配置文件样例
1.微信
微信会返回特有的unionid字段
'weixin'=>['pc'=>['app_id' => 'wx52e2b2464*****','app_secret' => 'd5dad705a1159d*********','callback' => '//i.959.cn/qq-login.php','scope' => 'snsapi_login',//扫码登录],'mobile'=>['app_id' => 'wx6ca7410f8******','app_secret' => '30a206b87b7689b19f11******','callback' => '//i.959.cn/qq-login.php','scope' => 'snsapi_userinfo',//静默授权=>snsapi_base;获取用户信息=>snsapi_userinfo],]
2.QQ
'qq'=>['app_id' => '1014*****','app_secret' => '8a2b322610d7a0d****','scope' => 'get_user_info','callback' => '//majiameng.com/login/qq','withUnionid' => true //已申请unioid打通]
QQ现在可以获取unionid了，详见: //wiki.connect.qq.com/unionid%E4%BB%8B%E7%BB%8D
只需要配置参数$config['withUnionid'] = true，默认不会请求获取Unionid
3.微博
'app_id' => '78734****','app_secret' => 'd8a00617469018d61c**********','scope' => 'all',
4.GitHub
'application_name' => '佳萌驿站','app_id' => 'a56b04a5********','app_secret' => '93ae7e5b137c6228e******************','callback' => '//majiameng.com/app/github',
5.支付宝
'app_id' => '2016052*******','scope' => 'auth_user','pem_private' => Env::get('ROOT_PATH') . 'pem/private.pem', // 你的私钥'pem_public' => Env::get('ROOT_PATH') . 'pem/public.pem', // 支付宝公钥
6.Facebook
'app_id' => '2774925********','app_secret' => '99bfc8ad35544d7***********','scope' => 'public_profile,user_gender',//user_gender需要审核，所以不一定能获取到
facebook有个特殊的配置$config['field']，默认是'id,name,gender,picture.width(400)'，你可以根据需求参考官方文档自行选择要获取的用户信息
7.Twitter
'app_id' => '3nHCxZgcK1WpYV**********','app_secret' => '2byVAPayMrG8LISjopwIMcJGy***************',
8.Line
'app_id' => '159******','app_secret' => '1f19c98a61d148f2************','scope' => 'profile',
9.Google
'app_id' => '7682717*******************.apps.googleusercontent.com','app_secret' => 'w0Kq-aYA***************','scope' => '//www.googleapis.com/auth/userinfo.profile',
返回样例
Array([openid] => 1047776979*******[channel] => 1; //登录类型请查看 \tinymeng\OAuth2\Helper\ConstCode[nickname] => 'Tinymeng' //昵称[gender] => 1; //0=>未知 1=>男 2=>女 twitter和line不会返回性别，所以这里是0，Facebook根据你的权限，可能也不会返回，所以也可能是0[avatar] => http://thirdqq.qlogo.cn/qqapp/101426434/50D523803F5B51AAC01616105161C7B1/100 //头像)
大家如果有问题要交流，就发在这里吧： OAuth2 交流 或发邮件 666@majiameng.com
关注TinyMeng博客，更多精彩分享，敬请期待！