您现在的位置是：首页 > cms教程 > discuz教程discuz教程

项目整合Discuz论坛的实现方法

恨松2025-06-28discuz教程已有4人查阅

导读市场就是力量，discuz是国内人气较高，使用最广泛的论坛系统，发展到今天它已经整合了论坛、门户、博客、CMS等版块，内容丰富，深受用户的喜爱

市场就是力量，discuz是国内人气较高，使用最广泛的论坛系统，发展到今天它已经整合了论坛、门户、博客、CMS等版块，内容丰富，深受用户的喜爱，一直以来很多用户用它来整合自己的应用。由于discuz版块众多，系统相对封装，源代码缺少注释，api资料不够丰富，官方对discuz用户的咨询也并非卖力，而网上资料不是版本陈旧就是鱼龙混杂。对于想整合discuz论坛的朋友存在一定的难度。因此，如果你想美好整合discuz的话，不妨耐心看完以下提示。
一、准备工作
1、uc api说明书，通读全文。参考

http://faq.comsenz.com/library/UCenter/introduction/introduction_list.htm

（官方），了解同步登陆机制
2、uc 后台添加应用说明。
3、uc client客户端必要代码，这里下载
4、如果是x3后面的版本，请先更改bug
解决方案如下：
\source\class\discuz的discuz_application.php 查找

<?php private function _xss_check() {
static $check = array('"', '>', '<', '\'', '(', ')', 'CONTENT-TRANSFER-ENCODING');
if(isset($_GET['formhash']) && $_GET['formhash'] !== formhash()) {
system_error('request_tainting');
}
if($_SERVER['REQUEST_METHOD'] == 'GET' ) {
$temp = $_SERVER['REQUEST_URI'];
} elseif(empty ($_GET['formhash'])) {
$temp = $_SERVER['REQUEST_URI'].file_get_contents('php://input');
} else {
$temp = '';
}
if(!empty($temp)) {
$temp = strtoupper(urldecode(urldecode($temp)));
foreach ($check as $str) {
if(strpos($temp, $str) !== false) {
system_error('request_tainting');
}
}
}
return true;
}

二、示例
我们学习一门技术时，看看它的技术说明就足够了，但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:// .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下面的配置文件修改。

<?php
define('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);                    // 当前应用的 ID
define('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); //note 获取标签 API 接口开关
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(" .nowamagic.net", 'ENCODE');
// 解密
echo authcode(authcode(" .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，及在discuz root/uc_client/data/cache/apps.php下面分别贮存数据。

<?php
$_CACHE['apps'] = array (
1 =>
array (
'appid' => '1',
'type' => 'DISCUZX',
'name' => 'Discuz! Board',
'url' => 'http:// .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:// .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:// .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里面的数据。

本文标签：

很赞哦！ (2)

上一篇：Discuz XSS得webshell漏洞原因和修复方法

下一篇：discuz的.net版本安装方法

暂无内容