用戶(hù)、會(huì)話和第三方登錄集成

2018-11-21 21:32 更新

“你應(yīng)該明白，我的朋友，
宇宙從來(lái)無(wú)所謂起始，
它也永遠(yuǎn)不會(huì)有結(jié)局，
因?yàn)榘畹?，戈?duì)柕?，還有我，
直到我們頭發(fā)掉精光，
對(duì)這一點(diǎn)都深信不疑！”

--《物理世界奇遇記》

3.8.1 擴(kuò)展類(lèi)庫(kù)：用戶(hù)、會(huì)話和第三方登錄集成

首先，特別感謝@Aevit ，允許我將些擴(kuò)展類(lèi)庫(kù)進(jìn)行開(kāi)源。原來(lái)此類(lèi)庫(kù)的功能只是當(dāng)前開(kāi)發(fā)項(xiàng)目中的功能，我現(xiàn)將其抽離成可配置使用的擴(kuò)展類(lèi)庫(kù)，以供大家共享。

此類(lèi)庫(kù)主要特點(diǎn)有：

  • 1、可以和第三方登錄集成，包括：微信登錄、新浪登錄、QQ登錄
  • 2、為客戶(hù)端提供了直接可以調(diào)用的登錄接口
  • 3、為服務(wù)端提供了直接可以檢測(cè)用戶(hù)登錄態(tài)的操作
  • 4、支持token落地、高效緩存和分布式的數(shù)據(jù)庫(kù)存儲(chǔ)
  • 5、展示了如何開(kāi)發(fā)一個(gè)項(xiàng)目級(jí)的類(lèi)庫(kù)、包括數(shù)據(jù)庫(kù)配置、翻譯等

溫馨提示：
此擴(kuò)展類(lèi)庫(kù)還在開(kāi)發(fā)完善中，但已有項(xiàng)目在使用，感興趣的同學(xué)可以嘗試使用。

3.8.2 安裝

(1)擴(kuò)展包下載

從 PhalApi-Library 擴(kuò)展庫(kù)中下載獲取 User 用戶(hù)包，如使用：

git clone https://git.oschina.net/dogstar/PhalApi-Library.git

然后把 User 目錄復(fù)制到 ./PhalApi/Library/ 下，即：

cp ./PhalApi-Library/User ./PhalApi/Library/ -R

(2)數(shù)據(jù)庫(kù)表導(dǎo)入

默認(rèn)下，User類(lèi)庫(kù)會(huì)使用默認(rèn)的數(shù)據(jù)庫(kù)配置，但有追加一些需要用到的表。因此需要導(dǎo)入以下表：

$ cd /Library/User
$ tree

├── Data
│   ├── user_login_qq.sql
│   ├── user_login_sina.sql
│   ├── user_login_weixin.sql
│   ├── user_session.sql
│   └── user.sql

溫馨提示：
導(dǎo)入前，可以自行調(diào)整表的前綴。

(3)數(shù)據(jù)庫(kù)配置

將 PhalApi-Library/User/Config/dbs.php 里面的配置拷貝到你的項(xiàng)目配置：

    //請(qǐng)將以下配置拷貝到 ./Config/dbs.php 文件對(duì)應(yīng)的位置中

        //10張表，可根據(jù)需要，自行調(diào)整表前綴、主鍵名和路由
        'user_session' => array(
            'prefix' => 'phalapi_',
            'key' => 'id',
            'map' => array(
                array('db' => 'db_demo'),
                array('start' => 0, 'end' => 9, 'db' => 'db_demo'),
            ),
        ),

(4)入口注冊(cè)

//必須顯式注冊(cè)，以便可以讓服務(wù)自行初始化
DI()->userLite = new User_Lite();

(5)其他可選配置

  • 為了體現(xiàn)高效緩存的好處，建議先注冊(cè)DI()->cache
  • 為了接口更明朗的參數(shù)規(guī)則說(shuō)明，建議將下而規(guī)則追加到配置文件./Config/app.php中：
return array(

    /**
     * 應(yīng)用接口層的統(tǒng)一參數(shù)
     */
    'apiCommonRules' => array(
        //其他原來(lái)的參數(shù)配置
        ...

        //登錄信息
        'userId' => array(
            'name' => 'user_id', 'type' => 'int', 'default' => 0, 'require' => false,
        ),
        'token' => array(
            'name' => 'token', 'type' => 'string', 'default' => '', 'require' => false,
        ),
    ),

(6)checkApiParams.php的初始化

同樣，需要在checkApiParams.php文件顯式注冊(cè)，才能讓User這個(gè)擴(kuò)展類(lèi)庫(kù)完成自我的必要初始化：

//裝載你的接口
DI()->loader->addDirs(array('Demo', 'Library'));
DI()->userLite = new User_Lite();

否則會(huì)導(dǎo)致service不存在。

3.8.3 入門(mén)使用

(1)對(duì)于客戶(hù)端

(1-1)微信登錄

1、功能說(shuō)明

實(shí)現(xiàn)通過(guò)微信登錄，并且首次登錄時(shí)，自動(dòng)創(chuàng)建用戶(hù)并綁定。

2、接口URL

/?service=User_User_Login.weixin + 公共參數(shù)(免登錄態(tài))

3、接口參數(shù)
參數(shù)必須默認(rèn)值說(shuō)明
wx_openid1微信OPENID
wx_token1微信TOKEN
wx_expires_in1微信失效時(shí)間
4、返回結(jié)果
返回字段
參數(shù)類(lèi)型說(shuō)明
infoobject登錄成功后的相關(guān)信息
user_idint用戶(hù)ID
tokenstring用戶(hù)TOKEN
is_newint是否為首次登錄，0不是，1是
結(jié)果示例
{
    "ret": 200,
    "data": {
        "code": 0,  //0正常登錄
        "info": {
            "user_id": 3,  //用戶(hù)ID
            "token": "430C0F31FAF1FB1565E4290D1B61185A2408A6DEEA1604C1B5AEB14E44BDF2E0",  //用戶(hù)TOKEN
            "is_new": 0   //是否為首次登錄，0不是，1是
        },
        "msg": ""
    },
    "msg": ""
}
請(qǐng)求示例

/service=User_User_Login.weixin&wx_openid=wx_122348561111&wx_token=ASDF&wx_expires_in=130000000&name=weixinName&avatar=phpunit.png

(1-2)QQ登錄

1、功能說(shuō)明

實(shí)現(xiàn)通過(guò)QQ登錄，并且首次登錄時(shí)，自動(dòng)創(chuàng)建用戶(hù)并綁定。

2、接口URL

/?service=User_User_Login.qq + 公共參數(shù)(免登錄態(tài))

3、接口參數(shù)
參數(shù)必須默認(rèn)值說(shuō)明
qq_openid1QQ的OPENID
qq_token1QQ的TOKEN
qq_expires_in1QQ的失效時(shí)間
4、返回結(jié)果
返回字段
參數(shù)類(lèi)型說(shuō)明
infoobject登錄成功后的相關(guān)信息
user_idint用戶(hù)ID
tokenstring用戶(hù)TOKEN
is_newint是否為首次登錄，0不是，1是
結(jié)果示例
{
    "ret": 200,
    "data": {
        "code": 0,  //0正常登錄
        "info": {
            "user_id": 3,  //用戶(hù)ID
            "token": "430C0F31FAF1FB1565E4290D1B61185A2408A6DEEA1604C1B5AEB14E44BDF2E0",  //用戶(hù)TOKEN
            "is_new": 0   //是否為首次登錄，0不是，1是
        },
        "msg": ""
    },
    "msg": ""
}
請(qǐng)求示例

/service=User_User_Login.qq&qq_openid=xxxx&qq_token=ASDF&qq_expires_in=130000000&name=sinaName&avatar=http://dev.phalapi.com/no_avatar.png

(1-3)新浪微博登錄

1、功能說(shuō)明

實(shí)現(xiàn)通過(guò)新浪微博登錄，并且首次登錄時(shí)，自動(dòng)創(chuàng)建用戶(hù)并綁定。

2、接口URL

/?service=User_User_Login.sina

3、接口參數(shù)
參數(shù)必須默認(rèn)值說(shuō)明
sina_openid1新浪微博OPENID
sina_token1新浪微博TOKEN
sina_expires_in1新浪微博失效時(shí)間
4、返回結(jié)果
返回字段
參數(shù)類(lèi)型說(shuō)明
infoobject登錄成功后的相關(guān)信息
user_idint用戶(hù)ID
tokenstring用戶(hù)TOKEN
is_newint是否為首次登錄，0不是，1是
結(jié)果示例
{
    "ret": 200,
    "data": {
        "code": 0,  //0正常登錄
        "info": {
            "user_id": 3,  //用戶(hù)ID
            "token": "430C0F31FAF1FB1565E4290D1B61185A2408A6DEEA1604C1B5AEB14E44BDF2E0",  //用戶(hù)TOKEN
            "is_new": 0   //是否為首次登錄，0不是，1是
        },
        "msg": ""
    },
    "msg": ""
}
請(qǐng)求示例

/service=User_User_Login.weixin&wx_openid=wx_122348561111&wx_token=ASDF&wx_expires_in=130000000&name=weixinName&avatar=phpunit.png

(1-4)用戶(hù)信息

1、功能說(shuō)明

獲取用戶(hù)個(gè)人信息

2、接口URL

/?service=User_User_Info.getUserInfo + 公共參數(shù)

3、接口參數(shù)
參數(shù)必須默認(rèn)值說(shuō)明
other_user_id1用戶(hù)id
4、返回結(jié)果
返回字段
參數(shù)類(lèi)型說(shuō)明
infoobject登錄成功后的相關(guān)信息
user_idint用戶(hù)ID
usernamestring用戶(hù)名
nicknamestring用戶(hù)昵稱(chēng)
avatarstring用戶(hù)頭像url
結(jié)果示例
{
    "ret": 200,
    "data": {
        "code": 0,
        "info": {
            "username": "aevit",
            "nickname": "test",
            "avatar": "",
            "user_id": 1
        },
        "msg": ""
    },
    "msg": ""
}
請(qǐng)求示例

/service=User_User_Info.getUserInfo&other_user_id=1

(2)對(duì)于服務(wù)端

(1)溫柔式檢測(cè)登錄態(tài)

$isLogin = DI()->userLite->check();

(2)強(qiáng)制式檢測(cè)登錄態(tài)

DI()->userLite->check(true);

(3)更多操作

當(dāng)需要對(duì)用戶(hù)進(jìn)行退出登錄時(shí)，可以在接口中執(zhí)行：

DI()->userLite->logout();

當(dāng)需要為用戶(hù)新建一個(gè)會(huì)話時(shí)，可以在接口中執(zhí)行：

DI()->userLite->generateSession(1); //假設(shè)用戶(hù)ID為1

當(dāng)需要為用戶(hù)延長(zhǎng)登錄態(tài)有效時(shí)間時(shí)（默認(rèn)為一個(gè)月），可以在接口進(jìn)行心跳操作，從而再延長(zhǎng)一個(gè)月有效時(shí)間：

DI()->userLite->heartbeat();

3.8.4 示例

(1)假設(shè)在我們的應(yīng)用的接口中：

<?php

class Api_Test extends PhalApi_Api {

    public function go() {
        Di()->userLite->check(true);

        return 'ok';
    }
}

(2)先調(diào)用微信的登錄：

/user/?service=User_User_Login.Weixin&wx_openid=wx_122348561111&wx_token=ASDF&wx_expires_in=130000000&name=weixinName&avatar=phpunit.png

返回：

{
    "ret": 200,
    "data": {
        "code": 0,
        "info": {
            "user_id": 94,
            "token": "8509BE9C80B67009C559E6A2C4B88E02C885DA6B9FEFFC2DA080999377D08FBF",
            "is_new": 0
        },
        "msg": ""
    },
    "msg": ""
}

(3)再調(diào)用我們應(yīng)用 的接口：

/user/?service=Test.go&user_id=94&token=CE1218493B3A441FCF630E24E98FD3640133EBA6D734C90A620A11C07CE35323

返回：

{"ret":200,"data":"ok","msg":""}

(4)未登錄下，返回：

{"ret":401,"data":[],"msg":"\u975e\u6cd5\u8bf7\u6c42\uff1auser not login"}
以上內(nèi)容是否對(duì)您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)