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的同步登录!