市场就是力量，discuz是国内人气最高，使用最广泛的论坛系统，发展到今天它已经整合了论坛、门户、博客、CMS等版块，内容丰富，深受用户的喜爱，一直以来很多用户用它来整合自己的应用。由于discuz版块众多，系统相对封装，源代码缺少注释，api资料不够丰富，官方对discuz用户的咨询也并非卖力，而网上资料不是版本陈旧就是鱼龙混杂。对于想整合discuz论坛的朋友存在一定的难度。因此，如果你想美好整合discuz的话，不妨耐心看完以下提示。
一、准备工作
1、uc api说明书，通读全文。参考http://faq.comsenz.com/library/UCenter/introduction/introduction_list.htm（官方），了解同步登陆机制
2、uc 后台添加应用说明。参考http://faq.comsenz.com/viewnews-506（官方） http://wenku.baidu.com/view/3790fdd7195f312b3169a588.html（草根）
3、uc client客户端必要代码，这里下载
二、示例
我们学习一门技术时，看看它的技术说明就足够了，但discuz远非如此。discuz不是zend frame、dedecms、ci这些白开水的东西，没有一点钻研精神和爱折腾的气质是无法理解它深奥的内涵，更不用说驾驭它。要达到成功，我们需要有详尽的说明文字，另外还需要配备必要的图片，虽然有了这些你也未必能够成功。
先看一下我的项目结构
tanahk 是真正的项目地址，x3.2是我的discuz论坛，打开它
可以看到这个discuz x3.2已经整合了Ucenter，其中uc_server是uc服务器，uc_client是客户端，uc_client这个文件夹在discuz x、discuz home、discuz xspace等产品中都是已经捆绑好的。需要记住的一点，在整个共用站点系统中，我们只需要一个uc_client，因为uc_server只会在它定义的uc_client路径中寻找data文件中的apps数组。
因此在多站点同步登陆登出的关键文件只有两个，一个是config.ini.php，另一个是uc.php。前者告诉uc_server我们这个应用的配置，后者供uc_server调用。
把examples/api/uc.php文件复制到我们的tanahk/api/uc.php，examples/config.inc.php和examples/include也添加进来。目录结构变为
code文件夹我用来查看一些源码。
好了，现在可以在UCenter后台添加我们的项目应用了。uc的后台一般为http://www.xxx.com/x3.2/uc_server/admin.php
选择“应用管理”–“添加新应用”
参考上面准备工作中2。
应用类型：其它应用名称：Tanahk，这里只能填写英文通信密钥：随意一串不多于64位的字母数字。应用的物理路径：可以为空，只要应用主url填写正确应用接口文件名称：保留，uc.php，不用填api/uc.php是否开启同步登陆：是，这是关键，以后多个项目共用一个uc就行了，不用自己新建一套用户系统。提交。
提交后一般是通信错误的。
我们先修改tanahk/api/config.inc.php 。这里的数据非常重要，如果安装了discuz x或其它discuz产品，最好对照discuz root/config下面的配置文件修改。
<?phpdefine('UC_CONNECT', null); // 连接 UCenter 的方式: mysql/NULL, 默认为空时为 fscoketopen() // mysql 是直接连接的数据库, 经实践，还是填写null好。mysql有时无法执行//数据库相关 (mysql 连接时, 并且没有设置 UC_DBLINK 时, 需要配置以下变量)define('UC_DBHOST', 'localhost'); // UCenter 数据库主机define('UC_DBUSER', 'root'); // UCenter 数据库用户名define('UC_DBPW', '111111'); // UCenter 数据库密码define('UC_DBNAME', 'ultrax'); // UCenter 数据库名称define('UC_DBCHARSET', 'utf8'); // UCenter 数据库字符集define('UC_DBTABLEPRE', '`ultrax`.pre_ucenter_'); // UCenter 数据库表前缀define('UC_DBCONNECT', 0); // 是否持久化链接//通信相关define('UC_KEY', '…'); // 与 UCenter 的通信密钥, 要与注册应用时填写的保持一致define('UC_API', 'http://www.xxx.com/x3.2/uc_server'); // UCenter 的 URL 地址, 在调用头像时依赖此常量define('UC_CHARSET', 'utf-8'); // UCenter 的字符集define('UC_IP', ''); // UCenter 的 IP, 当 UC_CONNECT 为非 mysql 方式时, 并且当前应用服务器解析域名有问题时, 请设置此值define('UC_APPID', 2); // 当前应用的 IDdefine('UC_PPP', 20);//ucexample_2.php 用到的应用程序数据库连接参数$dbhost = 'localhost'; // 数据库服务器$dbuser = 'root'; // 数据库用户名$dbpw = '111111'; // 数据库密码$dbname = 'ultrax'; // 数据库名$pconnect = 0; // 数据库持久连接 0=关闭, 1=打开$tablepre = '`ultrax`.pre_ucenter_'; // 表名前缀, 同一数据库安装多个论坛请修改此处$dbcharset = 'utf8'; // MySQL 字符集, 可选 'gbk', 'big5', 'utf8', 'latin1', 留空为按照论坛字符集设定//同步登录 Cookie 设置$cookiepre = 'jt_'; // cookie 前缀$cookiedomain = ''; // cookie 作用域$cookiepath = '/'; // cookie 作用路径
认真对照，特别是UC_KEY与UC_APPID，id一般为2以后的数字，查看uc后台，1被discuz x霸占了。 上面的配置不能遗漏。 UC_DBHOST，如果填写mysql，最好带port，可以包括端口号，例如 “hostname:port”，或者到本地套接字的路径，例如对于 localhost 的 “:/path/to/socket”。UC_PPP：默认值为 20，与 UCenter 日志显示的条数和通知管理显示的条数有关系。
在上述配置最后加上一句 ：
$cookiename = 'tanahk'; // 用户自定义的cookie名
它用来贮存用户登陆成功后的cookie值。
我们现在需要花大力气修改uc.php。首先是修改开头的常量定义
error_reporting(0);define('IN_DISCUZ', TRUE);define('UC_CLIENT_VERSION', '1.5.0'); //note UCenter 版本标识define('UC_CLIENT_RELEASE', '20081031');define('API_DELETEUSER', 1); //note 用户删除 API 接口开关define('API_RENAMEUSER', 1); //note 用户改名 API 接口开关define('API_GETTAG', 1); //define('API_SYNLOGIN', 1); //note 同步登录 API 接口开关define('API_SYNLOGOUT', 1); //note 同步登出 API 接口开关define('API_UPDATEPW', 1); //note 更改用户密码 开关define('API_UPDATEBADWORDS', 1); //note 更新关键字列表 开关define('API_UPDATEHOSTS', 1); //note 更新域名解析缓存 开关define('API_UPDATEAPPS', 1); //note 更新应用列表 开关define('API_UPDATECLIENT', 1); //note 更新客户端缓存 开关define('API_UPDATECREDIT', 1); //note 更新用户积分 开关define('API_GETCREDITSETTINGS', 1); //note 向 UCenter 提供积分设置 开关define('API_GETCREDIT', 1); //note 获取用户的某项积分 开关define('API_UPDATECREDITSETTINGS', 1); //note 更新应用积分设置 开关define('API_RETURN_SUCCEED', '1');define('API_RETURN_FAILED', '-1');define('API_RETURN_FORBIDDEN', '-2');// 改你真实的discuz地址define('DISCUZ_ROOT', realpath(dirname(__FILE__) . '/../../x3.2/'));// 本应用配置路径define('DISCUZ_UC_CONFIG', realpath(dirname(__FILE__)));
然后是修改下面的note通知方式。
//note 普通的 http 通知方式if(!defined('IN_UC')) { if (!defined('PHP_VERSION_ID')) { $version = explode('.', PHP_VERSION); define('PHP_VERSION_ID', ($version[0] * 10000 + $version[1] * 100 + $version[2])); } // set_magic_quotes_runtime 5.3.0版本不赞成使用，5.4.0废弃 if (PHP_VERSION_ID < 530) set_magic_quotes_runtime(0); // 修改常量MAGIC_QUOTES_GPC，与php5.4接地气，让它一直为false define('MAGIC_QUOTES_GPC', false); require_once DISCUZ_UC_CONFIG . '/config.inc.php'; $GLOBALS['cookiename'] = $cookiename; $_DCACHE = $get = $post = array(); $code = isset($_GET['code']) ? $_GET['code'] : ''; parse_str(_authcode($code, 'DECODE', UC_KEY), $get); $timestamp = time(); if($timestamp - $get['time'] > 3600) exit('Authracation has expiried'); if(empty($get)) exit('Invalid Request'); $action = $get['action']; require_once DISCUZ_ROOT . '/uc_client/lib/xml.class.php'; $post = xml_unserialize(file_get_contents('php://input')); if(in_array($get['action'], array('test', 'deleteuser', 'renameuser', 'gettag', 'synlogin', 'synlogout', 'updatepw', 'updatebadwords', 'updatehosts', 'updateapps', 'updateclient', 'updatecredit', 'getcreditsettings', 'updatecreditsettings'))) { require_once DISCUZ_UC_CONFIG . '/include/db_mysql.class.php'; $GLOBALS['db'] = new dbstuff; $GLOBALS['db']->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset); $GLOBALS['tablepre'] = $tablepre; unset($dbhost, $dbuser, $dbpw, $dbname, $pconnect); $uc_note = new uc_note(); exit($uc_note->$get['action']($get, $post)); } else { exit(API_RETURN_FAILED); }//note include 通知方式} else { require_once DISCUZ_UC_CONFIG . '/config.inc.php'; require_once DISCUZ_UC_CONFIG . '/include/db_mysql.class.php'; $GLOBALS['cookiename'] = $cookiename; $GLOBALS['db'] = new dbstuff; $GLOBALS['db']->connect($dbhost, $dbuser, $dbpw, $dbname, $pconnect, true, $dbcharset); $GLOBALS['tablepre'] = $tablepre; unset($dbhost, $dbuser, $dbpw, $dbname, $pconnect);}
上面把我们的$cookiename参数引进来，留给同步登陆函数使用。
$GLOBALS['cookiename'] = $cookiename;
修改function uc_note，它其实就是uc_note类的的构造函数。当ucenter有相关举动时通知我们的应用。
function uc_note() { $this->appdir = DISCUZ_ROOT; $this->dbconfig = DISCUZ_UC_CONFIG.'/config.inc.php'; $this->db = $GLOBALS['db']; $this->tablepre = $GLOBALS['tablepre']; }
把uc_client客户端指向discuz X3.2的路径，而配置文件指向我们api/目录。
然后修改synlogin/synlogout同步论坛的登入登出函数，把我们的$cookiename引进来
function synlogin($get, $post) {$uid = $get['uid']; $username = $get['username']; if(!API_SYNLOGIN) { return API_RETURN_FORBIDDEN; } header('P3P: CP="CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR"'); _setcookie($GLOBALS['cookiename'], _authcode($uid."\t".$username, 'ENCODE')); } function synlogout($get, $post) {if(!API_SYNLOGOUT) { return API_RETURN_FORBIDDEN; } //note 同步登出 API 接口 header('P3P: CP="CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR"'); _setcookie($GLOBALS['cookiename'], '', -86400 * 365); }
如上。当用户在论坛中登陆时，它会通知更新我们设定的名为$cookiename的cookie值，而当用户在其它地方退出时，会清除我们的cookie。
因为_setcookie函数要引用全局变量，discuz在uc.php默认把它屏蔽了，因此我们要加进来。
//note 使用该函数前需要 require_once $this->appdir.'/config.inc.php';function _setcookie($var, $value, $life = 0, $prefix = 1) { require_once DISCUZ_UC_CONFIG . '/config.inc.php'; global $cookiepre, $cookiedomain, $cookiepath, $timestamp, $_SERVER; setcookie(($prefix ? $cookiepre : '').$var, $value, $life ? $timestamp + $life : 0, $cookiepath, $cookiedomain, $_SERVER['SERVER_PORT'] == 443 ? 1 : 0);}
discuz在uc.php后面定义了三个函数，一个_setcookie，它贮存cookie，_authcode加密解密用户cookie或其它文本值，_stripslashes转义字符串。
_authcode是一个使用频率很高，用途广泛的明文加解密函数，在discuz产品或其它php产品中非常常见，我们有必要了解一下。下面是以其原版authcode为例
<?php// 参数解释// $string： 明文 或 密文// $operation：DECODE表示解密,其它表示加密// $key： 密匙// $expiry：密文有效期function authcode($string, $operation = 'DECODE', $key = '', $expiry = 0) { // 动态密匙长度，相同的明文会生成不同密文就是依靠动态密匙 // 加入随机密钥，可以令密文无任何规律，即便是原文和密钥完全相同，加密结果也会每次不同，增大破解难度。 // 取值越大，密文变动规律越大，密文变化 = 16 的 $ckey_length 次方 // 当此值为 0 时，则不产生随机密钥 $ckey_length = 4; // 密匙 $key = md5($key ? $key : $GLOBALS['discuz_auth_key']); // 密匙a会参与加解密 $keya = md5(substr($key, 0, 16)); // 密匙b会用来做数据完整性验证 $keyb = md5(substr($key, 16, 16)); // 密匙c用于变化生成的密文 $keyc = $ckey_length ? ($operation == 'DECODE' ? substr($string, 0, $ckey_length): substr(md5(microtime()), -$ckey_length)) : ''; // 参与运算的密匙 $cryptkey = $keya.md5($keya.$keyc); $key_length = strlen($cryptkey); // 明文，前10位用来保存时间戳，解密时验证数据有效性，10到26位用来保存$keyb(密匙b)，解密时会通过这个密匙验证数据完整性 // 如果是解码的话，会从第$ckey_length位开始，因为密文前$ckey_length位保存 动态密匙，以保证解密正确 $string = $operation == 'DECODE' ? base64_decode(substr($string, $ckey_length)) : sprintf('0d', $expiry ? $expiry + time() : 0).substr(md5($string.$keyb), 0, 16).$string; $string_length = strlen($string); $result = ''; $box = range(0, 255); $rndkey = array(); // 产生密匙簿 for($i = 0; $i <= 255; $i++) { $rndkey[$i] = ord($cryptkey[$i % $key_length]); } // 用固定的算法，打乱密匙簿，增加随机性，好像很复杂，实际上并不会增加密文的强度 for($j = $i = 0; $i < 256; $i++) { $j = ($j + $box[$i] + $rndkey[$i]) % 256; $tmp = $box[$i]; $box[$i] = $box[$j]; $box[$j] = $tmp; } // 核心加解密部分 for($a = $j = $i = 0; $i < $string_length; $i++) { $a = ($a + 1) % 256; $j = ($j + $box[$a]) % 256; $tmp = $box[$a]; $box[$a] = $box[$j]; $box[$j] = $tmp; // 从密匙簿得出密匙进行异或，再转成字符 $result .= chr(ord($string[$i]) ^ ($box[($box[$a] + $box[$j]) % 256])); } if($operation == 'DECODE') { // substr($result, 0, 10) == 0 验证数据有效性 // substr($result, 0, 10) - time() > 0 验证数据有效性 // substr($result, 10, 16) == substr(md5(substr($result, 26).$keyb), 0, 16) 验证数据完整性 // 验证数据有效性，请看未加密明文的格式 if((substr($result, 0, 10) == 0 || substr($result, 0, 10) - time() > 0) && substr($result, 10, 16) == substr(md5(substr($result, 26).$keyb), 0, 16)) { return substr($result, 26); } else { return ''; } } else { // 把动态密匙保存在密文里，这也是为什么同样的明文，生产不同密文后能解密的原因 // 因为加密后的密文可能是一些特殊字符，复制过程可能会丢失，所以用base64编码 return $keyc.str_replace('=', '', base64_encode($result)); }}// 加密echo authcode("www.nowamagic.net", 'ENCODE');// 解密echo authcode(authcode("www.nowamagic.net", 'ENCODE'));//echo authcode("55e5OxJ5zjgFuqTjFRPdt9ag+fC+GKP9Efq6yWeAAvdQFq+D");?>
如果配置全部正确，再回到uc后台，点击“应用管理”，应该能显示通信成功了。
到这步预防万一，我们再次点击应用2的编辑，进入，复制最下面的“应用的 UCenter 配置信息”，再次对照config.ini.php。这样写法更规范。
至此，所有配置都结束。
现在再来分析一下。discuz root/uc_client/client.php是我们第三方网站操纵discuz ucenter的入口，里面定义了很多全局api函数，通过这些函数我们可以实现用户的登陆、退出、获取用户信息等等功能。具体查看官方接口函数这一章节。而tanahk/api/uc.php文件则相反，它是ucenter与我们的网站交互的接口，ucenter的相关动作可以通知到我们的应用。比如用户在论坛的登陆、退出、修改用户密码、修改昵称等。那么它是怎样通知uc.php呢，打开discuz root/uc_server/control/user.php，查看30-52行。
// -1 未开启 function onsynlogin() { $this->init_input(); $uid = $this->input('uid'); if($this->app['synlogin']) { if($this->user = $_ENV['user']->get_user_by_uid($uid)) { $synstr = ''; foreach($this->cache['apps'] as $appid => $app) { if($app['synlogin']) { $synstr .= '<script type="text/javascript" src="'.$app['url'].'/api/'.$app['apifilename'].'?time='.$this->time.'&code='.urlencode($this->authcode('action=synlogin&username='.$this->user['username'].'&uid='.$this->user['uid'].'&password='.$this->user['password']."&time=".$this->time, 'ENCODE', $app['authkey'])).'" reload="1"></script>'; if(is_array($app['extra']['extraurl'])) foreach($app['extra']['extraurl'] as $extraurl) { $synstr .= '<script type="text/javascript" src="'.$extraurl.'/api/'.$app['apifilename'].'?time='.$this->time.'&code='.urlencode($this->authcode('action=synlogin&username='.$this->user['username'].'&uid='.$this->user['uid'].'&password='.$this->user['password']."&time=".$this->time, 'ENCODE', $app['authkey'])).'" reload="1"></script>'; } } } return $synstr; } } return ''; }
这个是同步登陆函数，注意
if($this->app['synlogin'])
是判断我们后台添加的discuz x、discuz home….甚至是我们的第三方应用是否开启了同步登陆。如果在uc后台编辑了“是”那么会在discuz root/uc_server/data/cache/apps.php贮存数据。
<?php$_CACHE['apps'] = array ( 1 => array ( 'appid' => '1', 'type' => 'DISCUZX', 'name' => 'Discuz! Board', 'url' => 'http://www.xxx.com/x3.2', 'ip' => '', 'viewprourl' => '', 'apifilename' => 'uc.php', 'charset' => '', 'dbcharset' => '', 'synlogin' => '1', 'recvnote' => '1', 'extra' => false, 'tagtemplates' => '', 'allowips' => '' ), 2 => array ( 'appid' => '2', 'type' => 'OTHER', 'name' => 'TANAHK', 'url' => 'http://www.xxx.com/tanahk', 'ip' => '', 'viewprourl' => '/space.php?uid=%s', 'apifilename' => 'uc.php', 'charset' => '', 'synlogin' => '1', 'extra' => array ( 'apppath' => '/…/tanahk/', 'extraurl' => '' ), 'recvnote' => '1' ), 'UC_API' => 'http://www.xxx.com/x3.2/uc_server');?>
如果在对应数组设置了’synlogin’=>1，那么它就是同步，它是在后台点击“应用管理”的时候自动添加进来的。但如果我们前面的设置有错，没有看到上面的$_CACHE[‘apps’][2]，那么，我们只能照上面的1，复制一份下来。不然在onsynlogin() 函数
foreach($this->cache['apps'] as $appid => $app) { ...}
循环时没有找到我们的应用，它就不会发送js通知。
对于使用mvc的应用来说，我们可能还需要把client.php的功能集成到我们的model层，规范我们的行为。以我自己的TinyMVC为例，model层完全是我们自己实现的。
/** * 本model是对discuz uc_client/client.php全局函数的再包装*/class Discuz_Uc_Model extends TinyMVC_Model { private static $cookie_name = null; protected static $_global_functions = array(); public function __construct() { // 下面两个常量在单入口定义 include TMVC_MY_UC_API_DIR . 'config.inc.php'; include TMVC_DISCUZDIR . 'uc_client' . DS . 'client.php'; // if uc cookie name is empty if (empty(self::$cookie_name)) self::$cookie_name = !empty($cookiepre) ? $cookiepre . $cookiename : $cookiename; // 收集自定义函数 $functions = get_defined_functions(); unset($functions['internal']); self::$_global_functions = & $functions['user']; } /** * 将discuz uc client 的api函数转为本类方法 * * @access public * @param $fun string discuz UCenter API function name * @param $args array the params that transmited to $fun */ public function __call($fun, $args) { if ( in_array($fun, self::$_global_functions) ) { return call_user_func_array($fun, $args); } else { throw new Exception("The discuz uc api function '{$fun}' had not found."); } } /** * 获取我们在uc api中设置的cookiename，解密，返回带用户id和用户名的数组 * * @access public * @return array if $cookie_name is empty return null * array(0=>uid, 1=>username) */ public function fetch_discuz_uc_by_cookie() { return !empty($_COOKIE[self::$cookie_name]) ? explode("\t", $this->uc_authcode($_COOKIE[self::$cookie_name], 'DECODE')) : array(); } }
这样，当在controller使用$this->model->uc_user_login()时，实际上是调用uc api的uc_user_login函数，比如上面代码最后的$this->authcode()方法就是调用uc_client/client.php里面的同名函数，使用方法参考官方api。至此，我们就可以随心所欲地在control里面读取ucenter里面的数据。
–完–
你所缺少的部分，也早已被我用想像的画笔填满。
