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

--《物理世界奇遇記》

3.8.1 擴(kuò)展類庫：用戶、會話和第三方登錄集成

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

此類庫主要特點(diǎn)有：

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

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

3.8.2 安裝

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

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

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

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

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

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

默認(rèn)下，User類庫會使用默認(rèn)的數(shù)據(jù)庫配置，但有追加一些需要用到的表。因此需要導(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ù)庫配置

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

    //請將以下配置拷貝到 ./Config/dbs.php 文件對應(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)入口注冊

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

(5)其他可選配置

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

return array(

    /**
     * 應(yīng)用接口層的統(tǒng)一參數(shù)
     */
    'apiCommonRules' => array(
        //其他原來的參數(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文件顯式注冊，才能讓User這個擴(kuò)展類庫完成自我的必要初始化：

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

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

3.8.3 入門使用

(1)對于客戶端

(1-1)微信登錄

1、功能說明

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

2、接口URL

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

3、接口參數(shù)

4、返回結(jié)果

返回字段

結(jié)果示例

{
    "ret": 200,
    "data": {
        "code": 0,  //0正常登錄
        "info": {
            "user_id": 3,  //用戶ID
            "token": "430C0F31FAF1FB1565E4290D1B61185A2408A6DEEA1604C1B5AEB14E44BDF2E0",  //用戶TOKEN
            "is_new": 0   //是否為首次登錄，0不是，1是
        },
        "msg": ""
    },
    "msg": ""
}

請求示例

/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、功能說明

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

2、接口URL

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

3、接口參數(shù)

4、返回結(jié)果

返回字段

結(jié)果示例

{
    "ret": 200,
    "data": {
        "code": 0,  //0正常登錄
        "info": {
            "user_id": 3,  //用戶ID
            "token": "430C0F31FAF1FB1565E4290D1B61185A2408A6DEEA1604C1B5AEB14E44BDF2E0",  //用戶TOKEN
            "is_new": 0   //是否為首次登錄，0不是，1是
        },
        "msg": ""
    },
    "msg": ""
}

請求示例

/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、功能說明

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

2、接口URL

/?service=User_User_Login.sina

3、接口參數(shù)

4、返回結(jié)果

返回字段

結(jié)果示例

{
    "ret": 200,
    "data": {
        "code": 0,  //0正常登錄
        "info": {
            "user_id": 3,  //用戶ID
            "token": "430C0F31FAF1FB1565E4290D1B61185A2408A6DEEA1604C1B5AEB14E44BDF2E0",  //用戶TOKEN
            "is_new": 0   //是否為首次登錄，0不是，1是
        },
        "msg": ""
    },
    "msg": ""
}

請求示例

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

(1-4)用戶信息

1、功能說明

獲取用戶個人信息

2、接口URL

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

3、接口參數(shù)

4、返回結(jié)果

返回字段

結(jié)果示例

{
    "ret": 200,
    "data": {
        "code": 0,
        "info": {
            "username": "aevit",
            "nickname": "test",
            "avatar": "",
            "user_id": 1
        },
        "msg": ""
    },
    "msg": ""
}

請求示例

/service=User_User_Info.getUserInfo&other_user_id=1

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

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

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

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

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

(3)更多操作

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

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

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

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

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

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"}