php的laravel框架快速集成微信登录的方法


Posted in PHP onDecember 12, 2016

本文面向的是php语言laravel框架的用户,介绍的是基于该框架实现的一个简易集成微信登录的方法。使用方法如下:

1. 安装php_weixin_provider

在项目下运行composer require thirdproviders/weixin,即可完成安装。安装成功后,在项目的vendor目录下应该能看到php_weixin_provider的库文件:

php的laravel框架快速集成微信登录的方法

2. 配置微信登录的参数

一共有7个参数可以配置,分别是:

  • client_id:对应公众号创建的应用appid
  • client_secret:对应公众号创建的应用appid
  • redirect:对应微信授权成功后的回调地址
  • proxy_url:对应微信授权的代理服务地址(其作用可阅读这篇文章了解)
  • device:区别是PC端微信登录还是移动端微信登录,默认值为pc,如果是移动端,可设置为空
  • state_cookie_name:授权链接中会包含随机的state参数,这个参数在微信回调的时候会原封不动的返回来,届时可通过验证state参数是否与授权链接中传入的参数相同,来判断请求是否有效,防止CSRF攻击。这个方案,会在授权时把state参数先存到cookie里面,所以这个参数用来指定这个state参数存入的cookie名称,默认值是wx_state_cookie
  • state_cookie_time:指定wx_state_cookie的有效时长,默认是5分钟
  • 这七个参数有2种设置方式。

第一种是把这些参数以大写的形式配置到.env配置文件里面:

php的laravel框架快速集成微信登录的方法

注:1、每个配置项都是大写,且以WEIXIN_开头;2、前三个配置项与前面介绍的参数名称不完全一致,KEY对应client_id,SECRET对应client_secret,REDIRECT_URI对应redirect;3、其它的与前面介绍的参数名称一致。

第二种是把这些参数配置到config/services.php文件里面去:

php的laravel框架快速集成微信登录的方法

这种方式的配置,每个配置项的名称与前面介绍的一致。

要注意的内容:

由于php_weixin_provider是基于laravel/socialite实现的,它要求必须配置client_id,client_secret和redirect,否则php_weixin_provider实例化过程就会出错;对于client_id和client_secret,我认为统一配置在一个地方是没有问题的,但是对于redirect,如果统一配置,不一定符合所有场景的需求,因为不是每一个用到微信登录的地方,最后的回调地址都是同一个;所以建议把redirect先配置成一个有效或无效非空的回调地址;反正在后面使用php_weixin_provider的时候还可以在调用的时候更改这个参数的值。

proxy_url如果有,也建议配置在公共的地方;

state_cookie_name和state_cookie_time由于都有默认值,基本上无需重新配置;
device可以在使用的时候再指定。

所有配置参数都可以在使用的时候重新指定。

3. 注册php_weixin_provider

在项目的config/app.php文件里面,找到providers配置节,把如下代码加到它的配置数组里面:

php的laravel框架快速集成微信登录的方法

4. 注册第三方登录事件的监听

在项目的app/Providers/EventServiceProvider.php里面加入以下代码:

php的laravel框架快速集成微信登录的方法

laravel框架整体上是一种IOC跟事件驱动的思想,熟悉js就会对事件驱动非常熟悉,熟悉设计模式,就会对IOC(控制反转,也称为DI:依赖注入)比较熟悉,这个是理解第3步和第4步配置作用的关键。

5. 编写微信登录的接口

举例如下:

//采用代理跳转,从PC端微信登录
Route::get('/login', function () {
 return Socialite::with('weixin')
  ->setProxyUrl('http://proxy.your.com')
  ->setRedirectUrl(url('/login/notify'))
  ->redirect();
});
//采用代理跳转,从手机端微信登录
Route::get('/login2', function () {
 return Socialite::with('weixin')
  ->setProxyUrl('http://proxy.your.com')
  ->setDevice('')
  ->setRedirectUrl(url('/login/notify'))
  ->redirect();
});
//不采用代理跳转,从PC端微信登录
Route::get('/login', function () {
 return Socialite::with('weixin')
  ->setRedirectUrl(url('/login/notify'))
  ->redirect();
});
//不采用代理跳转,从手机端微信登录
Route::get('/login4', function () {
 return Socialite::with('weixin')
  ->setDevice('')
  ->setRedirectUrl(url('/login/notify'))
  ->redirect();
});

Socialite::with('weixin')会返回php_weixin_provider的实例,也就是它:

php的laravel框架快速集成微信登录的方法

拿到这个实例之后,就可以采用链式的方式调用它提供的所有public方法,比如设置配置参数,setDevice等等。

6. 编写微信登录回调的接口

举例如下:

//登录回调
Route::get('/login/notify', function () {
 $user = null;
 try {
  $user = Socialite::with('weixin')->user();
 } catch(\Exception $e) {
  return '获取微信用户异常';
 }
 return $user->nickname;
});

通过Socialite::with('weixin')拿到php_weixin_provider实例后,调用user方法,就会自动跟微信调用相关接口,并把微信的返回值封装成对象返回。如果在此过程中,有任何错误都会以异常的形式抛出,比如state参数校验失败,比如code失效等。

返回的$user对象包含的有效属性有:

php的laravel框架快速集成微信登录的方法

小结:

这个方案是基于laravel/socialite实现,并发布到composer来使用的。laravel/socialite是laravel官方提供的第三方登录的模块,基于它可以很方便的集成大部分第三方平台的认证,目前它官方已经提供很多第三方的登录实现:https://socialiteproviders.github.io/。除了国外的facebook,google,github等,国内的微信,微博,qq也都有提供。我在一开始也用的是它官方提供的默认的微信登录provider来做的,但是后来我发现了以下几个问题:

1. 不支持微信授权的代理;

2. pc端跟移动端竟然还是分两个项目来做的:

php的laravel框架快速集成微信登录的方法

3. 它封装的user对象里竟然不包含unionid

4. 更改配置参数的方式,实在是让人觉得难以使用:

php的laravel框架快速集成微信登录的方法

所以我就在它官方的微信登录provider基础上,按照自己的想法,重新实现了一个来解决我发现的这些问题。

PHP 相关文章推荐
获取远程文件大小的php函数
Jan 11 PHP
PHP学习笔记之二
Jan 17 PHP
解析PHP留言本模块主要功能的函数说明(代码可实现)
Jun 25 PHP
php 生成短网址原理及代码
Jan 23 PHP
php中多维数组按指定value排序的实现代码
Aug 19 PHP
PHP启动windows应用程序、执行bat批处理、执行cmd命令的方法(exec、system函数详解)
Oct 20 PHP
PHP中COOKIES使用示例
Jul 26 PHP
PHP和C#可共用的可逆加密算法详解
Oct 26 PHP
PHP合并数组的2种方法小结
Nov 24 PHP
php使用curl模拟浏览器表单上传文件或者图片的方法
Nov 10 PHP
PHP实现的抓取小说网站内容功能示例
Jun 27 PHP
PHP使用QR Code生成二维码实例
Jul 07 PHP
php 遍历目录,生成目录下每个文件的md5值并写入到结果文件中
Dec 12 #PHP
php+ajax+json 详解及实例代码
Dec 12 #PHP
解决微信授权回调页面域名只能设置一个的问题
Dec 11 #PHP
Zend Framework数据库操作方法实例总结
Dec 11 #PHP
smarty模板数学运算示例
Dec 11 #PHP
Zend Framework入门应用实例详解
Dec 11 #PHP
Zend Framework前端控制器用法示例
Dec 11 #PHP
You might like
ThinkPHP使用心得分享-分页类Page的用法
2014/05/15 PHP
Symfony核心类概述
2016/03/17 PHP
PHP 闭包详解及实例代码
2016/09/28 PHP
PHP图片水印类的封装
2017/07/06 PHP
jquery easyui的tabs使用时的问题
2010/03/23 Javascript
jQuery前台数据获取实现代码
2011/03/16 Javascript
原生js操作checkbox用document.getElementById实现
2013/10/12 Javascript
javascript间隔定时器(延时定时器)学习 间隔调用和延时调用
2014/01/13 Javascript
JS DOM实现鼠标滑动图片效果
2020/09/17 Javascript
js自制图片放大镜功能
2017/01/24 Javascript
Javascript继承机制详解
2017/05/30 Javascript
ES6中字符串string常用的新增方法小结
2017/11/07 Javascript
详解如何在React组件“外”使用父组件的Props
2018/01/12 Javascript
JQuery获取可视区尺寸和文档尺寸及制作悬浮菜单示例
2019/05/14 jQuery
解决vue单页面 回退页面 keeplive 缓存问题
2020/07/22 Javascript
分享15个最受欢迎的Python开源框架
2014/07/13 Python
Python Web框架Flask中使用新浪SAE云存储实例
2015/02/08 Python
python 日期操作类代码
2018/05/05 Python
深入理解Django-Signals信号量
2019/02/19 Python
2020版Python学习路线图(附学习资料)
2020/09/15 Python
HTML5之SVG 2D入门8—文档结构及相关元素总结
2013/01/30 HTML / CSS
定义一结构体变量,用其表示点坐标,并输入两点坐标,求两点之间的距离
2015/08/17 面试题
酒店保洁主管岗位职责
2013/11/28 职场文书
初中国旗下的演讲稿
2014/08/28 职场文书
2014教师教育实践活动对照检查材料思想汇报
2014/09/21 职场文书
2014年审计工作总结
2014/11/17 职场文书
2014年计生工作总结
2014/11/21 职场文书
世界环境日活动总结
2015/02/11 职场文书
幼师辞职信范文
2015/02/27 职场文书
2015年社区服务活动总结
2015/03/25 职场文书
2015秋学期开学寄语
2015/05/28 职场文书
民间借贷纠纷起诉书
2015/08/03 职场文书
高中政治教学反思
2016/02/23 职场文书
导游词之山东八仙过海景区
2019/11/11 职场文书
详解 TypeScript 枚举类型
2021/11/02 Javascript
SpringBoot项目多数据源及mybatis 驼峰失效的问题解决方法
2022/07/07 Java/Android