集成 efault 創建 興趣 有效 common type 下載 初始化

直播APP開發擴展類庫用戶、會話和第三方登錄集成，允許我將些擴展類庫進行開源。原來此類庫的功能只是當前開發項目中的功能，我現將其抽離成可配置使用的擴展類庫，以供大家共享。
此類庫主要特點有：
1、可以和第三方登錄集成，包括：微信登錄、微博登錄、QQ登錄
2、為客戶端提供了直接可以調用的登錄接口
3、為服務端提供了直接可以檢測用戶登錄態的操作
4、支持token落地、高效緩存和分布式的數據庫存儲
5、展示了如何開發一個項目級的類庫、包括數據庫配置、翻譯等
溫馨提示：
此擴展類庫還在開發完善中，但已有項目在使用，感興趣的同學可以嘗試使用。
##3.8.2 安裝 ###(1)擴展包下載 從?PhalApi-Library?擴展庫中下載獲取?User?用戶包，如使用：
$ git clone https: //git.oschina.net/dogstar/PhalApi-Library.git
然後把?User?目錄復制到?./PhalApi/Library/?下，即：
$ cp ./PhalApi-Library/User ./PhalApi/Library/ -R
###(2)數據庫表導入 默認下，User類庫會使用默認的數據庫配置，但有追加一些需要用到的表。因此需要導入以下表：
$ cd /Library/User
$ tree
├── Data
│?? ├── user_login_qq.sql
│?? ├── user_login_sina.sql
│?? ├── user_login_weixin.sql
│?? ├── user_session.sql
│?? └── user.sql
溫馨提示：
導入前，可以自行調整表的前綴。
###(3)數據庫配置 將 PhalApi-Library/User/Config/dbs.php 裏面的配置拷貝到你的項目配置：
//請將以下配置拷貝到 ./Config/dbs.php 文件對應的位置中
//10張表，可根據需要，自行調整表前綴、主鍵名和路由
‘usersession‘ => array(
‘prefix‘ => ‘phalapi‘,
‘key‘ => ‘id‘,
‘map‘ => array(
array(‘db‘ => ‘db_demo‘),
array(‘start‘ => 0, ‘end‘ => 9, ‘db‘ => ‘db_demo‘),
),
),
###(4)入口註冊
//必須顯式註冊，以便可以讓服務自行初始化
DI()->userLite = new User_Lite();
###(5)其他可選配置
為了體現高效緩存的好處，建議先註冊DI()->cache
為了接口更明朗的參數規則說明，建議將下而規則追加到配置文件./Config/app.php中：
return array(
/**

• 應用接口層的統一參數
  */
  ‘apiCommonRules‘ => array(
  //其他原來的參數配置
  ...
  //登錄信息
  ‘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這個擴展類庫完成自我的必要初始化：
  //裝載你的接口
  DI()->loader->addDirs(array(‘Demo‘, ‘Library‘));
  DI()->userLite = new User_Lite();
  否則會導致service不存在。
  ##3.8.3 入門使用 ###(1)對於客戶端 ####(1-1)微信登錄 #####1、功能說明 實現通過微信登錄，並且首次登錄時，自動創建用戶並綁定。
  #####2、接口URL /?service=User_User_Login.weixin + 公共參數(免登錄態)
  #####3、接口參數
  參數 必須 默認值 說明
  wx_openid 1 微信OPENID
  wx_token 1 微信TOKEN
  wx_expires_in 1 微信失效時間
  #####4、返回結果
  #####返回字段 參數|類型|說明 ---|---|--- info|object|登錄成功後的相關信息 user_id|int|用戶ID token|string|用戶TOKEN is_new|int|是否為首次登錄，0不是，1是
  #####結果示例
  {
  "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、功能說明 實現通過QQ登錄，並且首次登錄時，自動創建用戶並綁定。
  #####2、接口URL /?service=User_User_Login.qq + 公共參數(免登錄態)
  #####3、接口參數
  參數 必須 默認值 說明
  qq_openid 1 QQ的OPENID
  qq_token 1 QQ的TOKEN
  qq_expires_in 1 QQ的失效時間
  #####4、返回結果
  #####返回字段
  參數 類型 說明
  info object 登錄成功後的相關信息
  user_id int 用戶ID
  token string 用戶TOKEN
  is_new int 是否為首次登錄，0不是，1是
  #####結果示例
  {
  "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 + 公共參數
  #####3、接口參數
  參數 必須 默認值 說明
  other_user_id 1 用戶id
  #####4、返回結果
  #####返回字段
  參數 類型 說明
  info object 登錄成功後的相關信息
  user_id int 用戶ID
  username string 用戶名
  nickname string 用戶昵稱
  avatar string 用戶頭像url
  #####結果示例
  {
  "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)對於服務端 ####(1)溫柔式檢測登錄態
  $isLogin = DI()->userLite->check();
  ####(2)強制式檢測登錄態
  DI()->userLite->check(true);
  ####(3)更多操作 當需要對用戶進行退出登錄時，可以在接口中執行：
  DI()->userLite->logout();
  當需要為用戶新建一個會話時，可以在接口中執行：
  DI()->userLite->generateSession(1); //假設用戶ID為1
  當需要為用戶延長登錄態有效時間時（默認為一個月），可以在接口進行心跳操作，從而再延長一個月有效時間：
  DI()->userLite->heartbeat();
  ##3.8.4 示例 ###(1)假設在我們的應用的接口中：
  <?php
  class Api_Test extends PhalApi_Api {
  public function go() {
  Di()->userLite->check(true);
  return ‘ok‘;
  }
  }
  ###(2)先調用微信的登錄：
  /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)再調用我們應用 的接口：
  /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"}
  以上就是直播APP開發中擴展類庫用戶、會話和第三方登錄集成，詳細的實例說明。

直播APP開發，擴展類庫用戶、會話和第三方登錄集成