最近應公司的要求,要開發一個有點像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行的位置這一行代碼
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行:
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文件。
解決這一問題的辦法就是把上面的代碼修改爲
require_once DISCUZ_ROOT.'./uc_client/lib/db.class.php';
導入的數據庫類文件變了,那麼我們也要對其所涉及的內容作相應的修改,在uc.php59行的下面如
$GLOBALS['db'] = new dbstuff; $GLOBALS['db']->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset); $GLOBALS['tablepre'] = $tablepre; 修改爲 $GLOBALS['db'] = new ucclient_db; $GLOBALS['db']->connect(UC_DBHOST, UC_DBUSER, UC_DBPW, UC_DBNAME, UC_DBCONNECT, true, UC_DBCHARSET); $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兩個文件。代碼:
class UcService{
public function __construct(){
include_once(WBLOG_ROOT_PATH . 'W3note/Conf/config_ucenter.php');
include_once(WBLOG_ROOT_PATH . 'uc_client/client.php');
}接下來我們寫一個會員註冊方法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),把其下的代碼複製過來。如下
/**
* 會員註冊
*/
public function register($username, $password, $email){
$uid = uc_user_register($username, $password, $email);//UCenter的註冊驗證函數
if($uid <= 0) {
if($uid == -1) {
return '用戶名不合法';
} elseif($uid == -2) {
return '包含不允許註冊的詞語';
} elseif($uid == -3) {
return '用戶名已經存在';
} elseif($uid == -4) {
return 'Email 格式有誤';
} elseif($uid == -5) {
return 'Email 不允許註冊';
} elseif($uid == -6) {
return '該 Email 已經被註冊';
} else {
return '未定義';
}
} else {
return intval($uid);//返回一個非負數
}
}
}這個註冊方法register的作用是,在wblog1的會員註冊中成功註冊一個會員時,也會成功註冊UCenter Home的會員中心中。UCenter的註冊方法我們在上面已經寫好了,現在回到thinkphp。我們在前臺W3note項目的控制器MemberAction寫一個註冊方法,代碼如下:
/*
用戶名:$username,
密碼:$password,
郵箱:$email
*/
public function addmember(){
if($this->isPost()){
$username = $_POST['username'];
$email = $_POST['email'];
$password = trim($_POST['password']);
import("@.ORG.UcService");//導入UcService.class.php類
$ucService = new UcService;//實例化UcService類
$uid = $ucService->register($username, $password, $email);//註冊到UCenter
if($uid){//如果上面註冊成功將返回一個int類型的數字
$M = D('Member');
if ($vo = $M->create()) {
if ($M->add()) {
$this->success('註冊成功!');
} else {
$this->error('註冊失敗!');
}
} else {
$this->error();
}
}else{
exit($uid);
}
}else{
$this->error('非法數據!');
}
}我們在thinkphp會員註冊頁面註冊一個帳號,提交表單後,查看wblog1和UCenter的會員數據表,發現兩張表都存相同的帳號,說明同步註冊已經成功了! 有了帳號我們就可以來做同步登錄了。 打開UcService.class.php文件,添加一個UC登錄和一個登出的方法,代碼到UCenter接口開發手冊的用戶接口那裏找用戶登錄示例代碼,把它複製過來,然後稍微更改一下,使其帶有返回值,以便下一步的操作,代碼如下:
public function uc_login($username, $password){
list($uid, $username, $password, $email) = uc_user_login($username, $password);
if($uid > 0) {
return array(
'uid' => $uid,
'username' => $username,
'password' => $password,
'email' => $email
);
} elseif($uid == -1) {
return '用戶不存在,或者被刪除';
} elseif($uid == -2) {
return '密碼錯誤';
} elseif($uid == -3) {
return '安全提問錯誤';
} else {
return '未定義';
}
}
繼續在用戶接口那裏找到同步登錄的代碼示例,找到“uc_user_synlogin($uid);”其作用是執行同步登錄,然後寫成uc_synlogin方法如下:
public function uc_synlogin($uid){
return uc_user_synlogin($uid);
}到這裏UcService.class.php文件的登錄方法已經寫好,接下來打開前臺W3note項目的控制器MemberAction.class.php文件寫一個同步登錄的方法,看代碼:
public function checkLogin() {
if(!$_POST['username']) $this->error('帳號錯誤!');
if(!$_POST['password']) $this->error('密碼錯誤!');
if(empty($_POST['verify'])) $this->error('驗證碼必須!');
import("@.ORG.UcService");//導入UcService.class.php類
$ucService = new UcService;
$uidarray = $ucService->uc_login($_POST['username'], $_POST['password']);
//dump($uidarray);
$loginurl=$ucService->uc_synlogin($uidarray);
echo $loginurl;//輸出同步登錄代碼,否則無法同步登錄
if(!is_string($uidarray)){
//生成認證條件
$map = array();
// 支持使用綁定帳號登錄
$map['username'] = $_POST['username'];
$map["status"] = array('gt',0);
if($_SESSION['verify'] != md5($_POST['verify'])) {
$this->error('驗證碼錯誤!');
}
$memberinfo=$this->Member->where($map)->find();
if(false === $memberinfo) {
$this->error('帳號不存在或已禁用!');
}elseif($memberinfo['status']==0){
$this->error('帳號已禁用!');
}else {
$password = pwdHash($_POST['password']);
if($memberinfo['password'] != $password) {
$this->error('密碼錯誤!');
}
session(C('USER_AUTH_KEY'), $memberinfo['id']);
session('email', $memberinfo['email'] );
session('loginUserName', $memberinfo['loginUserName']);
session('lastLoginTime', $memberinfo['lastLoginTime']);
session('loginnum', $memberinfo['loginnum']);
session('lastloginip', $memberinfo['lastloginip']);
//保存登錄信息(相當於更新信息)
$data = array();
$data['id'] = $memberinfo['id'];
$data['lastlogintime'] = time();
$data['loginnum'] = array('exp','loginnum+1');
$data['lastloginip'] = get_client_ip();
//$data['verify'] = $authInfo['verify'];
$this->Member->save($data);
$this->success('登錄成功!',U('Member/index'));
}
}
}我們來看一下checkLogin()方法的執行過程。
在項目W3note註冊的一個帳號,然後在項目W3note提交登錄表單後,首先執行UCenter的登錄,前面我們寫了兩個UCenter的登錄方法,在調用之前需要使用“import("@.ORG.UcService");”把UcService.class.php文件加載進來,實例化後得到$ucService,然後就可以使用用$ucService訪問UCenterr的登錄方法uc_login,返回一個$uidarray值,$uidarray包函什麼數據?使用“dump($uidarray);”打印出來,以便下一步的操作,打印結果如下:
array(4) {
["uid"] => string(1) "1"
["username"] => string(5) "qqabc"
["password"] => string(6) "123456"
["email"] => string(9) "[email protected]"
}下一步就是以此$uidarray作爲參數傳給同步登錄方法uc_synlogin($uidarray),最後echo 一下uc_synlogin($uidarray)的返回值$loginurl,就可以實現帳號"qqabc"在UCenter登錄了。帳號"qqabc"在UCenter登錄成功後程序將繼續往下執行項目W3note的登錄,這裏就不多說了。最後的結果是,帳號"qqabc"實現了在UCenter和項目W3note的同步登錄!