ThinkPHP與UCenter整合詳解

最近應公司的要求,要開發一個有點像QQ空間那樣的會員管理中心網站,發現UCenter的很多功能酷似QQ空間,於是選擇了UCenter作爲程序的會員管理中心。前臺嘛就選擇我之前基於ThinkPHP3.1.2框架開發的WBlog好了。但是問題又來了:要求在WBlog前臺註冊的會員登錄時要與UCenter同步,這就是我這次要解決的問題--ThinkPHP與UCenter的整合。 我在網上搜索了一下,ThinkPHP與UCenter的整合並不少,但是似乎越看越覺得頭暈,不是少這就是少那,到頭來差之毫釐,謬以千里,真夠折騰的。我仔細閱讀了UCenter的開發文檔後,經過多次的調試,終於完成了ThinkPHP與UCenter的整合。感覺這個結果是從苦水裏泡出來的一樣,呵呵。。。現在把整合的記錄分享給需要的童鞋。 溫馨提示:在thinphp與UCenter整合中,您需要的基本條件是,有一定的PHP基礎,對ThinkPHP框架有所瞭解,會佈署目錄和配置數據。 好了,我們開始吧! 下載並安裝下面的程序 WBlog3.1.2 UCenter_Home_2.0_SC_UTF8 UCenter 1.6.0 安裝WBlog博客程序 已發佈的WBlog博客程序還沒有會員中心,本次測試的會員中心是後面才寫的。如果你能等的話要待我整理好WBlog的會員中心程序才發佈,不能等的話也不會影響下面的程序整合,因爲你可以找或者自己寫簡單的滿足以下兩個條件的thikphp程序: 1、可以註冊會員 2、可以登錄和退出。 這裏我就使用WBlog3.1.2了。在服務器的根目錄新建目錄wblog1,把下載的WBlog3.1.2解壓得到的WBlog目錄裏的所有文件複製到wblog1。在瀏覽器輸入http://127.0.0.1/wblog1/install/,安裝WBlog3.1.2。 溫馨提示:在整合時最容易搞錯的就是路徑問題,在接下來的整合操作的根目錄都是指wblog1目錄,所以要和服務器根目錄區別開來。 安裝UCenter 1.6.0(簡體UTF-8) 這個程序到官方去下載吧。在網站根目錄wblog1新建 ucenter 目錄,解壓UCenter 1.6.0,把解壓得到的upload目錄裏的所有文件複製到剛纔新建的ucenter目錄裏。在瀏覽器輸入http://127.0.0.1/wblog1/ucenter/install/,安裝UCenter 1.6.0。 安裝UCenter_Home_2.0_SC_UTF8(簡體中文版) 在網站根目錄wblog1新建 uh目錄並解壓UCenter_Home_2.0_SC_UTF8,把解壓得到的upload目錄裏的所有文件複製到剛纔新建的uh目錄裏。在瀏覽器輸入http://127.0.0.1/wblog1/uh/install/,安裝UCenter_Home_2.0_SC_UTF8。 需要注意的是,安裝UCenter 1.6.0和UCenter_Home_2.0_SC_UTF8時順序不能顛倒,否則無法安裝。 我們安裝完了WBlog3.1.2、UCenter_Home_2.0_SC_UTF8和UCenter 1.6.0三個程序後。接下來找到下載的UCenter 1.6.0,把 advanced 目錄裏面的uc_client 和 examples下面的api 文件夾複製到網站根目錄wblog1下,和ThinkPHP在同一目錄。找到項目W3note的配置文件夾wblog1/ Conf/,在其新建一個UCenter的配置文件 config_ucenter.php ,然後在WBlog1\W3note\Lib\ORG目錄下新建一個UCenter的通訊處理類文件UcService.class.php,我們先不要管文件裏面寫什麼代碼,後面將會講到。好了到這裏已經把後面要操作的目錄和文件都佈局好了。爲了理清目錄和文件之間的層次關係,我把目錄和文件製成目錄樹列出來: wblog1根目錄 | – index.php//前臺入口文件 | – admin.php | – W3note//前臺項目 | | – Lib | | | – ORG | | | | –UcService.class.php //UCenter的通訊處理類文件 | | – Conf//W3note項目的配置目錄 | | | –config_ucenter.php //UCenter的配置文件 | | | – Admin | – ThinkPHP //thinkphp3.1.2核心包和一些擴展 | – install | – api | | – uc.php | | – uc_client | – ucenter | – uh 這樣我們就可以一目瞭然了。 現在開始api目錄裏面的uc.php 配置了,首先打開這個文件,找到36行的位置這一行代碼

1. require_once DISCUZ_ROOT.'./config.inc.php';

複製代碼

把'./config.inc.php'這一部分替換成'./W3note/Conf/config_ucenter.php' 往下找還會看到幾處的'./config.inc.php',按照上面的操作全部替換掉。這樣做目的是把前面建的配置文件config_ucenter.php導進來。 接下來我登錄http://127.0.0.1/wblog1/ucenter,在打開左邊菜單“應用管理”這一項,然後添加一個新應用,這時我們發現好多東西要填! 照着下面操作就是了。先看應用類型,因爲這是我們自己開發的程序,所以就選其它吧,再看應用名稱,隨便填,只要不超過20字節就行了,我這裏填wblog。接下來是應用的主URL,這裏填網站的主頁http;//127.0.0.1/wblog1,注意了,後面沒有“/”。至於應用的其他URL還有應用IP這兩項就跳過,不用管它了。接下來是通信密鑰,就按其旁邊的提示填就是了,我這裏填abc123456。往下是應用的物路徑,提示說默認爲空,那就留空吧,還有查看個人資料頁面地址也留空吧。接下來是應用接口文件名稱,默認爲uc.php,保持原狀吧。繼續往下看,標籤單條顯示模板還有標籤模板標記說明這兩項也不用理它,跳過。是否開啓同步登錄,選是;是否接受通知也選是吧。終於填完了,那就點擊提交吧! 還記得前面在uc.php導入的文件config_ucenter.php嗎,裏面可是一片空白啊,現在我們就來放些配置信息進去。剛纔我們填好的信息提交後,會在提交按鈕下面的“應用的UCenter配置信息”下面生成了一些配置信息,我們直接把它複製,然後粘帖到config_ucenter.php,保存。 網上很多教程到這裏就表示通信成功了,在這裏我非常驚訝!因爲通信並未成功!我在這裏折騰了一些時間,後來仔細檢了uc.php文件的代碼,發現59行:

1. require_once DISCUZ_ROOT.'./include/db_mysql.class.php';

複製代碼

我在佈局的目錄中始終找不到db_mysql.class.php,後來發現db_mysql.class.php存UCenter_1.6.0_SC_UTF8\advanced\examples\include目錄中,這就是問題所在!因爲我們之前複製的只是UCenter_1.6.0_SC_UTF8\advanced\examples\中的api文件。 解決這一問題的辦法就是把上面的代碼修改爲

1. require_once DISCUZ_ROOT.'./uc_client/lib/db.class.php';

複製代碼

導入的數據庫類文件變了,那麼我們也要對其所涉及的內容作相應的修改,在uc.php59行的下面如

1. $GLOBALS['db'] = new dbstuff;
2. $GLOBALS['db']->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset);
3. $GLOBALS['tablepre'] = $tablepre;
4. 修改爲
5. $GLOBALS['db'] = new ucclient_db;
6. $GLOBALS['db']->connect(UC_DBHOST, UC_DBUSER, UC_DBPW, UC_DBNAME, UC_DBCONNECT, true, UC_DBCHARSET);
7. $GLOBALS['tablepre'] = UC_DBTABLEPRE;//關鍵

複製代碼

上面數據庫的鏈接信息的靜態變量來自config_ucenter.php。 好了,我們回到後臺ucenter刷新一下頁面,發現什麼---通信成功了! 那麼接下來我們的目標: 在thinkphp中會員註冊成功時,UCenter Home也同時註冊成功。 首先在項目W3note入口文件index.php配置一個常量 define('WBLOG_ROOT_PATH', rtrim(dirname(__FILE__), '/\\') . DIRECTORY_SEPARATOR);//物理根目錄 常量WBLOG_ROOT_PATH是網站根目錄wblog1的物理根目錄,在我本地服務器打印輸出: D:\phpsever\apache2\htdocs\wblog1\ 有必要在這裏強調一下,理解WBLOG_ROOT_PATH很重要,因爲在調試過程中路徑最容易出錯。 還記得前面我們建的UcService.class.php 文件嗎?如果忘記了請看一下前面的目錄樹。打開UcService.class.php文件,新建一個類UcService,然後寫一個構造方法導入W3note/Conf/config_ucenter.php和uc_client/client.php兩個文件。代碼:

1. class UcService{
2. public function __construct(){
3. include_once(WBLOG_ROOT_PATH . 'W3note/Conf/config_ucenter.php');
4. include_once(WBLOG_ROOT_PATH . 'uc_client/client.php');
5. }

複製代碼

接下來我們寫一個會員註冊方法register,如 public function register($username, $password, $email){} 方法體放什麼代碼呢?其實很簡單,因爲UCenter的開發文檔已經爲我們準備好了! 找到之前下載的UCenter_1.6.0_SC_UTF8,用瀏覽器打開UCenter_1.6.0_SC_UTF\advanced\document\index.htm,然後在左邊的菜單欄找到“用戶接口”,看到用戶註冊示例 (PHP),把其下的代碼複製過來。如下

1. /**
2. * 會員註冊
3. */
4. public function register($username, $password, $email){
5. $uid = uc_user_register($username, $password, $email);//UCenter的註冊驗證函數
6. if($uid <= 0) {
7. if($uid == -1) {
8. return '用戶名不合法';
9. } elseif($uid == -2) {
10. return '包含不允許註冊的詞語';
11. } elseif($uid == -3) {
12. return '用戶名已經存在';
13. } elseif($uid == -4) {
14. return 'Email 格式有誤';
15. } elseif($uid == -5) {
16. return 'Email 不允許註冊';
17. } elseif($uid == -6) {
18. return '該 Email 已經被註冊';
19. } else {
20. return '未定義';
21. }
22. } else {
23. return intval($uid);//返回一個非負數
24. }
25. }
26. }

複製代碼

這個註冊方法register的作用是,在wblog1的會員註冊中成功註冊一個會員時,也會成功註冊UCenter Home的會員中心中。UCenter的註冊方法我們在上面已經寫好了,現在回到thinkphp。我們在前臺W3note項目的控制器MemberAction寫一個註冊方法,代碼如下:

1. /*
2. 用戶名:$username,
3. 密碼:$password,
4. 郵箱:$email
5. */
6. public function addmember(){
7. if($this->isPost()){
8. $username = $_POST['username'];
9. $email = $_POST['email'];
10. $password = trim($_POST['password']);
11. import("@.ORG.UcService");//導入UcService.class.php類
12. $ucService = new UcService;//實例化UcService類
13. $uid = $ucService->register($username, $password, $email);//註冊到UCenter
14. if($uid){//如果上面註冊成功將返回一個int類型的數字
15. $M = D('Member');
16. if ($vo = $M->create()) {
17. if ($M->add()) {
18. $this->success('註冊成功!');
19. } else {
20. $this->error('註冊失敗!');
21. }
22. } else {
23. $this->error();
24. }
25. }else{
26. exit($uid);
27. }
28. }else{
29. $this->error('非法數據!');
30. }
31. }

複製代碼

我們在thinkphp會員註冊頁面註冊一個帳號,提交表單後,查看wblog1和UCenter的會員數據表,發現兩張表都存相同的帳號,說明同步註冊已經成功了! 有了帳號我們就可以來做同步登錄了。 打開UcService.class.php文件,添加一個UC登錄和一個登出的方法,代碼到UCenter接口開發手冊的用戶接口那裏找用戶登錄示例代碼,把它複製過來,然後稍微更改一下,使其帶有返回值,以便下一步的操作,代碼如下:

1. public function uc_login($username, $password){
2. list($uid, $username, $password, $email) = uc_user_login($username, $password);
3. if($uid > 0) {
4. return array(
5. 'uid' => $uid,
6. 'username' => $username,
7. 'password' => $password,
8. 'email' => $email
9. );
10. } elseif($uid == -1) {
11. return '用戶不存在,或者被刪除';
12. } elseif($uid == -2) {
13. return '密碼錯誤';
14. } elseif($uid == -3) {
15. return '安全提問錯誤';
16. } else {
17. return '未定義';
18. }
19. }

複製代碼

繼續在用戶接口那裏找到同步登錄的代碼示例,找到“uc_user_synlogin($uid);”其作用是執行同步登錄,然後寫成uc_synlogin方法如下:

1. public function uc_synlogin($uid){
2. return uc_user_synlogin($uid);
3. }

複製代碼

到這裏UcService.class.php文件的登錄方法已經寫好,接下來打開前臺W3note項目的控制器MemberAction.class.php文件寫一個同步登錄的方法,看代碼:

1. public function checkLogin() {
2. if(!$_POST['username']) $this->error('帳號錯誤!');
3. if(!$_POST['password']) $this->error('密碼錯誤!');
4. if(empty($_POST['verify'])) $this->error('驗證碼必須!');
5. import("@.ORG.UcService");//導入UcService.class.php類
6. $ucService = new UcService;
7. $uidarray = $ucService->uc_login($_POST['username'], $_POST['password']);
8. //dump($uidarray);
9. $loginurl=$ucService->uc_synlogin($uidarray);
10. echo $loginurl;//輸出同步登錄代碼,否則無法同步登錄
11. if(!is_string($uidarray)){
12. //生成認證條件
13. $map = array();
14. // 支持使用綁定帳號登錄
15. $map['username'] = $_POST['username'];
16. $map["status"] = array('gt',0);
17. if($_SESSION['verify'] != md5($_POST['verify'])) {
18. $this->error('驗證碼錯誤!');
19. }
20. $memberinfo=$this->Member->where($map)->find();
21. if(false === $memberinfo) {
22. $this->error('帳號不存在或已禁用!');
23. }elseif($memberinfo['status']==0){
24. $this->error('帳號已禁用!');
25. }else {
26. $password = pwdHash($_POST['password']);
27. if($memberinfo['password'] != $password) {
28. $this->error('密碼錯誤!');
29. }
30. session(C('USER_AUTH_KEY'), $memberinfo['id']);
31. session('email', $memberinfo['email'] );
32. session('loginUserName', $memberinfo['loginUserName']);
33. session('lastLoginTime', $memberinfo['lastLoginTime']);
34. session('loginnum', $memberinfo['loginnum']);
35. session('lastloginip', $memberinfo['lastloginip']);
36. //保存登錄信息(相當於更新信息)
37. $data = array();
38. $data['id'] = $memberinfo['id'];
39. $data['lastlogintime'] = time();
40. $data['loginnum'] = array('exp','loginnum+1');
41. $data['lastloginip'] = get_client_ip();
42. //$data['verify'] = $authInfo['verify'];
43. $this->Member->save($data);
44. $this->success('登錄成功!',U('Member/index'));
45. }
46. }
47. }

複製代碼

我們來看一下checkLogin()方法的執行過程。 在項目W3note註冊的一個帳號,然後在項目W3note提交登錄表單後,首先執行UCenter的登錄,前面我們寫了兩個UCenter的登錄方法,在調用之前需要使用“import("@.ORG.UcService");”把UcService.class.php文件加載進來,實例化後得到$ucService,然後就可以使用用$ucService訪問UCenterr的登錄方法uc_login,返回一個$uidarray值,$uidarray包函什麼數據?使用“dump($uidarray);”打印出來,以便下一步的操作,打印結果如下:

1. array(4) {
2. ["uid"] => string(1) "1"
3. ["username"] => string(5) "qqabc"
4. ["password"] => string(6) "123456"
5. ["email"] => string(9) "[email protected]"
6. }

複製代碼

下一步就是以此$uidarray作爲參數傳給同步登錄方法uc_synlogin($uidarray),最後echo 一下uc_synlogin($uidarray)的返回值$loginurl,就可以實現帳號"qqabc"在UCenter登錄了。帳號"qqabc"在UCenter登錄成功後程序將繼續往下執行項目W3note的登錄,這裏就不多說了。最後的結果是,帳號"qqabc"實現了在UCenter和項目W3note的同步登錄!