10 KiB
10 KiB
4.0 第三方登录接入流程
以下已做好的微信登录为例
第一步，配置微信第三方登录
修改 根目录的config/app.php文件，找到authorization_app填写需要接入的第三方登录：
//第三方登录总开关
'authorization_app'=>array(
//自己编写获取第三方登录链接对应的方法
'weChat'=>[
'icon' => '/images/login_wechat.png', // 第三方应用的图标
'app_callback_url'=>'\Base\Domain\Authorization', //自己编写获取第三方微信登录链接的类---包含命名空间
'desc'=>'微信', //第三方应用的描述
'sort_id'=>1, //排序字段
'type'=>1, //用于解绑的
'can_unbind'=>1, //可以解绑的
'authorization_type'=>1,
'can_bing'=>1, //可以在个人中心进行绑定
'can_bing_url_class'=>'\Base\Domain\Authorization',//自己编写获取第三方登录绑定链接的类--包含命名空间
'can_bing_url_fun'=>'weChat', //自己编写获取第三方登录绑定链接的类对应的方法
//以下根据自己申请得到的资料进行填写
'appid'=>'wx9b33877e791de406', //appid
'secret'=>'04b99c4526076e6d8ffbc6a5e6619bd2', //密钥
'login_redirect_uri'=>'http://www.yesdev.cn/server_callback/wechat_login.php', //登录回调地址配置
],
),
下面是详细配置步骤：
一般第三方登录都涉及了几个配置： 注：每个配置合起来是上面的配置，为清晰，把每个配置单独分开，便于理解
1、配置生成用于第三方登录的url的类和方法：
//key是自己编写用于获取第三方登录链接对应的方法
'weChat'=>[
'app_callback_url'=>'\Base\Domain\Authorization', //自己编写获取第三方登录链接的类---包含命名空间
),
2、填写配置申请到第三方登录得到的资料：
//key是自己编写用于获取第三方登录链接对应的方法
'weChat'=>[
//以下根据自己申请得到的资料进行填写
'icon' => '/images/login_wechat.png', // 第三方应用的图标
'desc'=>'微信', //第三方应用的描述
'appid'=>'', //appid
'secret'=>'', //密钥
'login_redirect_uri'=>'http://*****',
),
3、填写用于个人中心进行绑定所生成的url的类和方法：
//key是自己编写用于获取第三方登录链接对应的方法
'weChat'=>[
'can_bing'=>1, //可以在个人中心进行绑定
'can_bing_url_class'=>'\Base\Domain\Authorization',//自己编写获取第三方登录绑定链接的类--包含命名空间
'can_bing_url_fun'=>'weChat', //自己编写获取第三方登录绑定链接的类对应的方法
),
4、其它配置：
//key是自己编写用于获取第三方登录链接对应的方法
'weChat'=>[
'type'=>1, //用于解绑的，值跟下面的authorization_type值一样
'authorization_type'=>1,//对应于pp_authorization表中的authorization_type类型
),
第二步，根据配置新建或者编写对应的文件类和方法
1、根据配置编写用于第三方登录的url的类和方法：
如：配置编写了
//key是自己编写用于获取第三方登录链接对应的方法
'weChat'=>[
'app_callback_url'=>'\Base\Domain\Authorization', //自己编写获取第三方登录链接的类---包含命名空间
),
那么需要在路径/Base/Domain/下新建Authorization.php文件及编写weChat方法：
2、根据配置编写用于个人中心进行绑定所生成的url的类和方法：
如：配置编写了
'weChat'=>[
'can_bing'=>1, //可以在个人中心进行绑定
'can_bing_url_class'=>'\Base\Domain\Authorization',//自己编写获取第三方登录绑定链接的类--包含命名空间
'can_bing_url_fun'=>'weChat', //自己编写获取第三方登录绑定链接的类对应的方法
),
那么需要在路径Base/Domain/下新建Authorization.php文件及编写weChat方法：
3、根据配置编写用于回调地址及业务逻辑
如：配置编写了
//key是自己编写用于获取第三方登录链接对应的方法
'weChat'=>[
'login_redirect_uri'=>'http://www.xxx.cn/server_callback/wechat_login.php', //登录回调地址配置
),
那么需新建/public/server_callback/wechat_login.php 进行回调业务逻辑编写
第四步，编写具体业务逻辑前，先进行第三方登录数据库分析
以下是涉及第三方登录的三张表数据结构：
CREATE TABLE `pp_authorization` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`openid` varchar(10000) NOT NULL DEFAULT '0' COMMENT '第三方平台对应用户的唯一id',
`unionid` varchar(1000) NOT NULL DEFAULT '0' COMMENT '微信开放平台对应的unionidid',
`authorization_type` int(11) NOT NULL DEFAULT '0' COMMENT '第三登录类型：0无 1微信 2微信小程序 3qq 4是短信 5程序员客栈 等等',
`member_id` int(11) NOT NULL DEFAULT '0' COMMENT '版本的用户id',
`add_time` datetime DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=357 DEFAULT CHARSET=utf8mb4 COMMENT='第三方授权表';
CREATE TABLE `pp_authorization_details` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`nickname` varchar(255) NOT NULL DEFAULT '' COMMENT '昵称',
`sex` tinyint(2) unsigned NOT NULL DEFAULT '0' COMMENT '性别：1未知 2男 3女',
`headimgurl` varchar(10000) NOT NULL DEFAULT '' COMMENT '用户头像url',
`province` varchar(255) NOT NULL DEFAULT '' COMMENT '省',
`city` varchar(255) NOT NULL DEFAULT '' COMMENT '城市',
`country` varchar(255) NOT NULL DEFAULT '' COMMENT '国家',
`privilege` varchar(1000) NOT NULL DEFAULT '' COMMENT '用户特权信息',
`add_time` datetime DEFAULT NULL,
`authorization_id` int(11) NOT NULL DEFAULT '0' COMMENT '关联第三方表',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=355 DEFAULT CHARSET=utf8mb4 COMMENT='授权详情表';
CREATE TABLE `pp_member` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
`username` varchar(50) NOT NULL COMMENT '账号',
`salt` varchar(64) NOT NULL COMMENT '盐值',
`password` varchar(64) DEFAULT NULL COMMENT '密码',
`register_time` datetime DEFAULT NULL COMMENT '注册时间',
`avatar` varchar(500) DEFAULT '' COMMENT '头像',
`nickname` varchar(100) DEFAULT '' COMMENT '昵称',
`email` varchar(100) DEFAULT '' COMMENT '邮箱',
`sex` varchar(10) DEFAULT '' COMMENT '性别，0未知1男2女',
`mobile` varchar(20) DEFAULT '' COMMENT '手机号',
`ip` varchar(30) DEFAULT '' COMMENT '注册IP',
`uuid` varchar(64) DEFAULT '' COMMENT 'UUID，全局唯一ID',
`member_level` smallint(4) NOT NULL DEFAULT '0' COMMENT '用户等级(0~99区间表示用户,100~199区间表示开发者, 200~255区间表示内部管理员)',
`member_status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '用户状态(0表示禁止,1表示正常)',
`wx_openid` text COMMENT '微信openid ',
`wx_type` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '0微信公众号 1是微信小程序',
`balance` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '余额',
`from_channel` varchar(100) NOT NULL DEFAULT '' COMMENT '来源',
PRIMARY KEY (`id`),
UNIQUE KEY `username` (`username`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=50 DEFAULT CHARSET=utf8mb4 COMMENT='用户表';
第三方登录主要业务逻辑是： 首次进行登录把第三方信息写入pp_authorization表和pp_authorization_details表
个人绑定主要是pp_authorization表中的字段member_id对应pp_member的id
第三步，本框架的第三方登录业务编写规范
如有更成熟的编写规范可以自行编写，可以不往下看，只要配置正确就可以。
下面提供本框架的接入的三方登录规范
1、本框架第三方登录核心目录结构介绍
核心目录结构路径在/src/base路径下的Authorization目录和lib目录
2、WeChat.php 代码分析
3、WeChatBusiness.php 代码分析
4、WeChatBusiness.php 代码分析
主要是准备数据，如何首次登录写入
4、AuthorizationLogin.php 代码分析
主要是进行成员注册或绑定登逻辑
5、借鉴并进行开发
到这里就可以借鉴想应的写法进行开发了