最近應公司的要求,要開發(fā)一個有點像QQ空間那樣的會員管理中心網(wǎng)站,發(fā)現(xiàn)UCenter的很多功能酷似QQ空間,于是選擇了UCenter作為程序的會員管理中心。
前臺嘛就選擇我之前基于ThinkPHP3.1.2框架開發(fā)的WBlog好了。但是問題又來了:要求在WBlog前臺注冊的會員登錄時要與UCenter同步,這就是我這次要解決的問題--ThinkPHP與UCenter的整合。
我在網(wǎng)上搜索了一下,ThinkPHP與UCenter的整合并不少,但是似乎越看越覺得頭暈,不是少這就是少那,到頭來差之毫厘,謬以千里,真夠折騰的。
我仔細閱讀了UCenter的開發(fā)文檔后,經(jīng)過多次的調(diào)試,終于完成了ThinkPHP與UCenter的整合。感覺這個結(jié)果是從苦水里泡出來的一樣,呵呵。。。現(xiàn)在把整合的記錄分享給需要的童鞋。
溫馨提示:在thinphp與UCenter整合中,您需要的基本條件是,有一定的PHP基礎,對ThinkPHP框架有所了解,會布署目錄和配置數(shù)據(jù)。
好了,我們開始吧!
下載并安裝下面的程序
- WBlog3.1.2
- UCenter_Home_2.0_SC_UTF8
- UCenter 1.6.0
安裝WBlog博客程序
已發(fā)布的WBlog博客程序還沒有會員中心,本次測試的會員中心是后面才寫的。如果你能等的話要待我整理好WBlog的會員中心程序才發(fā)布,不能等的話也不會影響下面的程序整合,因為你可以找或者自己寫簡單的滿足以下兩個條件的thikphp程序:
- 1、可以注冊會員
- 2、可以登錄和退出。
這里我就使用WBlog3.1.2了。在服務器的根目錄新建目錄wblog1,把下載的WBlog3.1.2解壓得到的WBlog目錄里的所有文件復制到wblog1。在瀏覽器輸入http://127.0.0.1/wblog1/install/,安裝WBlog3.1.2。
溫馨提示:在整合時最容易搞錯的就是路徑問題,在接下來的整合操作的根目錄都是指wblog1目錄,所以要和服務器根目錄區(qū)別開來。
安裝UCenter 1.6.0(簡體UTF-8)
這個程序到官方去下載吧。在網(wǎng)站根目錄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(簡體中文版)
在網(wǎng)站根目錄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 文件夾復制到網(wǎng)站根目錄wblog1下,和ThinkPHP在同一目錄。
找到項目W3note的配置文件夾wblog1/ Conf/,在其新建一個UCenter的配置文件 config_ucenter.php ,然后在WBlog1\W3note\Lib\ORG目錄下新建一個UCenter的通訊處理類文件UcService.class.php,我們先不要管文件里面寫什么代碼,后面將會講到。
好了到這里已經(jīng)把后面要操作的目錄和文件都布局好了。為了理清目錄和文件之間的層次關系,我把目錄和文件制成目錄樹列出來:
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
這樣我們就可以一目了然了。
現(xiàn)在開始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,在打開左邊菜單“應用管理”這一項,然后添加一個新應用,這時我們發(fā)現(xiàn)好多東西要填!
照著下面操作就是了。先看應用類型,因為這是我們自己開發(fā)的程序,所以就選其它吧,再看應用名稱,隨便填,只要不超過20字節(jié)就行了,我這里填wblog。
接下來是應用的主URL,這里填網(wǎng)站的主頁http;//127.0.0.1/wblog1,注意了,后面沒有“/”。至于應用的其他URL還有應用IP這兩項就跳過,不用管它了。
接下來是通信密鑰,就按其旁邊的提示填就是了,我這里填abc123456。往下是應用的物路徑,提示說默認為空,那就留空吧,還有查看個人資料頁面地址也留空吧。
接下來是應用接口文件名稱,默認為uc.php,保持原狀吧。繼續(xù)往下看,標簽單條顯示模板還有標簽模板標記說明這兩項也不用理它,跳過。
是否開啟同步登錄,選是;是否接受通知也選是吧。終于填完了,那就點擊提交吧!
還記得前面在uc.php導入的文件config_ucenter.php嗎,里面可是一片空白啊,現(xiàn)在我們就來放些配置信息進去。
剛才我們填好的信息提交后,會在提交按鈕下面的“應用的UCenter配置信息”下面生成了一些配置信息,我們直接把它復制,然后粘帖到config_ucenter.php,保存。
網(wǎng)上很多教程到這里就表示通信成功了,在這里我非常驚訝!因為通信并未成功!我在這里折騰了一些時間,后來仔細檢了uc.php文件的代碼,發(fā)現(xiàn)59行:
require_once DISCUZ_ROOT.'./include/db_mysql.class.php';
我在布局的目錄中始終找不到db_mysql.class.php,后來發(fā)現(xiàn)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';
導入的數(shù)據(jù)庫類文件變了,那么我們也要對其所涉及的內(nèi)容作相應的修改,在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;//關鍵
上面數(shù)據(jù)庫的鏈接信息的靜態(tài)變量來自config_ucenter.php。
好了,我們回到后臺ucenter刷新一下頁面,發(fā)現(xiàn)什么---通信成功了!
那么接下來我們的目標:
在thinkphp中會員注冊成功時,UCenter Home也同時注冊成功。
首先在項目W3note入口文件index.php配置一個常量
define('WBLOG_ROOT_PATH', rtrim(dirname(__FILE__), '/\\') . DIRECTORY_SEPARATOR);//物理根目錄
常量WBLOG_ROOT_PATH是網(wǎng)站根目錄wblog1的物理根目錄,在我本地服務器打印輸出:
D:\phpsever\apache2\htdocs\wblog1
有必要在這里強調(diào)一下,理解WBLOG_ROOT_PATH很重要,因為在調(diào)試過程中路徑最容易出錯。
還記得前面我們建的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的開發(fā)文檔已經(jīng)為我們準備好了!
找到之前下載的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的注冊驗證函數(shù)
if($uid <= 0) {
if($uid == -1) {
return '用戶名不合法';
} elseif($uid == -2) {
return '包含不允許注冊的詞語';
} elseif($uid == -3) {
return '用戶名已經(jīng)存在';
} elseif($uid == -4) {
return 'Email 格式有誤';
} elseif($uid == -5) {
return 'Email 不允許注冊';
} elseif($uid == -6) {
return '該 Email 已經(jīng)被注冊';
} else {
return '未定義';
}
} else {
return intval($uid);//返回一個非負數(shù)
}
}
}
這個注冊方法register的作用是,在wblog1的會員注冊中成功注冊一個會員時,也會成功注冊UCenter Home的會員中心中。UCenter的注冊方法我們在上面已經(jīng)寫好了,現(xiàn)在回到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類型的數(shù)字
$M = D('Member');
if ($vo = $M->create()) {
if ($M->add()) {
$this->success('注冊成功!');
} else {
$this->error('注冊失敗!');
}
} else {
$this->error();
}
}else{
exit($uid);
}
}else{
$this->error('非法數(shù)據(jù)!');
}
}
我們在thinkphp會員注冊頁面注冊一個帳號,提交表單后,查看wblog1和UCenter的會員數(shù)據(jù)表,發(fā)現(xiàn)兩張表都存相同的帳號,說明同步注冊已經(jīng)成功了!
有了帳號我們就可以來做同步登錄了。
打開UcService.class.php文件,添加一個UC登錄和一個登出的方法,代碼到UCenter接口開發(fā)手冊的用戶接口那里找用戶登錄示例代碼,把它復制過來,然后稍微更改一下,使其帶有返回值,以便下一步的操作,代碼如下:
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 '未定義';
}
}
繼續(xù)在用戶接口那里找到同步登錄的代碼示例,找到“uc_user_synlogin($uid);”其作用是執(zhí)行同步登錄,然后寫成uc_synlogin方法如下:
public function uc_synlogin($uid){
return uc_user_synlogin($uid);
}
到這里UcService.class.php文件的登錄方法已經(jīng)寫好,接下來打開前臺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()方法的執(zhí)行過程。
在項目W3note注冊的一個帳號,然后在項目W3note提交登錄表單后,首先執(zhí)行UCenter的登錄,前面我們寫了兩個UCenter的登錄方法,在調(diào)用之前需要使用“import("@.ORG.UcService");”把UcService.class.php文件加載進來,實例化后得到$ucService,然后就可以使用用$ucService訪問UCenterr的登錄方法uc_login,返回一個$uidarray值,$uidarray包函什么數(shù)據(jù)?使用“dump($uidarray);”打印出來,以便下一步的操作,打印結(jié)果如下:
array(4) {
["uid"] => string(1) "1"
["username"] => string(5) "qqabc"
["password"] => string(6) "123456"
["email"] => string(9) "qq@qq.com"
}
下一步就是以此$uidarray作為參數(shù)傳給同步登錄方法uc_synlogin($uidarray),最后echo 一下uc_synlogin($uidarray)的返回值$loginurl,就可以實現(xiàn)帳號"qqabc"在UCenter登錄了。帳號"qqabc"在UCenter登錄成功后程序?qū)⒗^續(xù)往下執(zhí)行項目W3note的登錄,這里就不多說了。最后的結(jié)果是,帳號"qqabc"實現(xiàn)了在UCenter和項目W3note的同步登錄!
