UCenter接口

==接口函数==


===用户接口===
:此部分接口负责用户的注册、登录，可实现用户表的统一管理。

:*[[uc_user_register]]
:::用于新用户的注册
:*[[uc_user_login]]
:::用于用户的登录验证
:*[[uc_get_user]]
:::用于获取用户在 UCenter 的基本数据
:*[[uc_user_edit]]
:::用于更新用户资料
:*[[uc_user_delete]]
:::用于删除用户
:*[[uc_user_deleteavatar]]
:::用于删除用户头像
:*[[uc_user_synlogin]]
:::用于用户同步登录
:*[[uc_user_synlogout]]
:::用于用户同步退出
:*[[uc_user_checkemail]]
:::用于检查用户输入的 Email 的合法性
:*[[uc_user_checkname]]
:::用于检查用户输入的用户名的合法性
:*[[uc_user_addprotected]]
:::用于添加被保护的用户
:*[[uc_user_deleteprotected]]
:::用于删除被保护的用户
:*[[uc_user_getprotected]]
:::用于获得被保护的用户列表
:*[[uc_user_merge]]
:::用于把重名的用户合并到 UCenter
:*[[uc_user_merge_remove]]
:::用于移除重名用户记录中的指定记录
:*[[uc_user_getcredit]]
:::用于获取指定应用的指定用户积分


===短消息接口===
:此部分接口负责用户间的短消息传输，可以跨应用间互相发送短消息。“短消息中心”的界面接口可以让应用只需一个函数接口即拥有短消息功能，对于高级用户 UCenter 也提供了丰富的收发接口函数供用户自己开发短消息系统。

:*[[uc_pm_location]]
:::本接口函数运行后会发送一个 header 的 location 请求，使当前页面跳转到短消息中心。
:*[[uc_pm_checknew]]
:::本接口函数会检查指定用户是否有新的短消息。
:*[[uc_pm_send]]
:::本接口函数用于发送短消息。
:*[[uc_pm_delete]]
:::本接口函数将删除指定文件夹中的指定消息 ID 的短消息。
:*[[uc_pm_deleteuser]]
:::本接口函数将删除和 uid 对话的 touids 中的所有短消息。
:*[[uc_pm_deletechat]]
:::本接口函数用于群聊短消息的退出和删除。
:*[[uc_pm_readstatus]]
:::本接口函数用于标记短消息的已读/未读状态。
:*[[uc_pm_list]]
:::本接口函数用于获取指定文件夹的短消息列表。
:*[[uc_pm_ignore]]
:::本接口函数用于直接忽略未读短消息的提示状态。
:*[[uc_pm_view]]
:::本接口函数用于返回指定用户的指定消息 ID 的消息。
:*[[uc_pm_view_num]]
:::本接口函数用于返回指定会话的消息数量。
:*[[uc_pm_viewnode]]
:::本接口函数用于查询单条短消息内容。
:*[[uc_pm_chatpmmemberlist]]
:::本接口函数用于返回群聊成员列表。
:*[[uc_pm_kickchatpm]]
:::本接口函数用于将指定用户踢出群聊会话。
:*[[uc_pm_appendchatpm]]
:::本接口函数用于添加群聊成员。
:*[[uc_pm_blackls_get]]
:::本接口函数返回用户的黑名单设置的内容。
:*[[uc_pm_blackls_set]]
:::本接口函数用于更新用户的黑名单列表数据。
:*[[uc_pm_blackls_add]]
:::本接口函数用于添加用户的黑名单项目。
:*[[uc_pm_blackls_delete]]
:::本接口函数用于删除用户的黑名单项目。


===好友接口===
:此部分接口负责用户好友信息的共享。一个应用更新的好友资料其他应用都能够看到。

:*[[uc_friend_add]]
:::本函数接口用于把 friendid 添加为 uid 的好友。
:*[[uc_friend_delete]]
:::本函数接口用于删除指定用户的好友。
:*[[uc_friend_totalnum]]
:::本接口函数用于返回指定用户的好友数。
:*[[uc_friend_ls]]
:::本接口函数用于返回好友列表数据。


===积分接口===
:此部分接口负责应用间的积分兑换。

:*[[uc_credit_exchange_request]]
:::本接口函数用于积分兑换处理。


===头像接口===
:此部分接口提供了一套用户头像的编辑、显示的平台，可以让应用拥有用头像的编辑功能。

:*[[uc_avatar]]
:::本接口函数用于返回设置用户头像的 HTML 代码。
:*[[uc_check_avatar]]
:::本接口函数用于检测指定用户的头像是否存在。


===标签接口===
:此部分接口负责应用间标签信息的聚合。

:*[[uc_tag_get]]
:::本接口会向用户中心发起一个请求，要求获取用户中心中所有应用的标签数据。


===事件接口===
:此部分接口负责应用间信息的聚合。

:*[[uc_feed_add]]
:::本接口函数用于向 UCenter Home 添加事件。如果正确则返回事件的 ID。
:*[[uc_feed_get]]
:::本接口函数用于提取事件。如果正确则返回事件列表数组。


===应用接口===
:此部分接口用于获取应用相关信息。

:*[[uc_app_ls]]
:::本接口获取 UCenter 中所有应用的列表数据。


===邮件接口===
:此部分接口用来将邮件加入到邮件队列，或者直接发送邮件（当level为0时）。

:*[[uc_mail_queue]]
:::本函数用来将邮件加入到邮件队列，或者直接发送邮件（当level为0时）。


==API接口==


UCenter 的 API 接口文件必须存放于应用程序根目录的“api/”目录中，且文件名可以自定义，默认为 uc.php，即“api/uc.php”。文件结构可分为 4 部分，包含 12 个接口项目。第 1 部分为常量定义、第 2 部分为通知方式判断以及初始化输入参数、第 3 部分为接口类代码段、第 4 部分为函数定义。


===常量定义===

<pre>
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');
</pre>
常量定义部分定义了接口所用到的 14 个接口项目的开关设置，“1”为开启“0”为关闭。如果开启，则代码段运行后返回 API_RETURN_SUCCEED，否则返回 API_RETURN_FORBIDDEN。接口运行失败则返回 API_RETURN_FAILED。

===通知方式判断以及初始化输入参数===

<pre>
if(!defined('IN_UC')) {

	error_reporting(0);
	set_magic_quotes_runtime(0);

	define('DISCUZ_ROOT', substr(dirname(__FILE__), 0, -3));
	defined('MAGIC_QUOTES_GPC') || define('MAGIC_QUOTES_GPC', get_magic_quotes_gpc());
	require_once DISCUZ_ROOT.'./config.inc.php';

	$_DCACHE = $get = $post = array();

	$code = @$_GET['code'];
	parse_str(_authcode($code, 'DECODE', UC_KEY), $get);
	if(MAGIC_QUOTES_GPC) {
		$get = _stripslashes($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_ROOT.'./include/db_'.$database.'.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);
	}

} else {

	define('DISCUZ_ROOT', $app['extra']['apppath']);
	require_once DISCUZ_ROOT.'./config.inc.php';
	require_once DISCUZ_ROOT.'./include/db_'.$database.'.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);
}
</pre>
通过常量 IN_UC 来判断接口文件是通过远程 HTTP 方式访问还是直接包含方式调用

===接口代码段===

接口类名称为 uc_note ，接口名称作为此类的一个方法，uc_note 代码结构大体如下：
<pre>
class uc_note {

	var $dbconfig = '';
	//var $db = '';
	var $appdir = '';

	function _serialize($arr, $htmlon = 0) {
		if(!function_exists('xml_serialize')) {
			include_once DISCUZ_ROOT.'./uc_client/lib/xml.class.php';
		}
		return xml_serialize($arr, $htmlon);
	}

	function uc_note() {
		$this->appdir = substr(dirname(__FILE__), 0, -3);
		$this->dbconfig = $this->appdir.'./config.inc.php';
	}

	function test($get, $post) {
		return API_RETURN_SUCCEED;
	}

	function deleteuser($get, $post) {
		/*代码省略*/
		return API_RETURN_SUCCEED;
	}
	
	/* 更多接口项目 */

}
</pre>
具体可以参考Discuz7.2代码中的/api/uc.php

*test
:此接口供仅测试连接。当 UCenter 发起 test 的接口请求时，如果成功获取到接口返回的 API_RETURN_SUCCEED 值，表示 UCenter 和应用通讯正常。
*deleteuser
:当 UCenter 删除一个用户时，会发起 deleteuser 的接口请求，通知所有应用程序删除相应的用户。
:输入的参数放在 $get['ids'] 中，值为用逗号分隔的用户 ID。如果删除成功则输出 API_RETURN_SUCCEED。
:deleteuser 接口示例 (PHP)
<pre>
$query = $db->query("DELETE FROM {$tablepre}members WHERE uid IN ($get[ids])");
exit(API_RETURN_SUCCEED);
</pre>
*renameuser
:当 UCenter 更改一个用户的用户名时，会发起 renameuser 的接口请求，通知所有应用程序改名。
:输入的参数 $get['uid'] 表示用户 ID，$get['oldusername'] 表示旧用户名，$get['newusername'] 表示新用户名。如果修改成功则输出 API_RETURN_SUCCEED。
:renameuser 接口示例 (PHP)
<pre>
$uid = $get['uid'];
$usernamenew = $get['newusername'];

$db->query("UPDATE {$tablepre}members SET username='$usernamenew' WHERE uid='$uid'");
exit(API_RETURN_SUCCEED);
</pre>
*updatepw
:当用户更改用户密码时，此接口负责接受 UCenter 发来的新密码。
:输入的参数 $get['username'] 表示用户名，$get['password'] 表示新密码。如果修改成功则输出 API_RETURN_SUCCEED。
:updatepw 接口示例 (PHP)
<pre>
$username = $get['username'];
$password = md5($get['password']);
$db->query("UPDATE members SET password='$password' WHERE username='$username'");
exit(API_RETURN_SUCCEED);
</pre>
*gettag
:如果应用程序存在标签功能，可以通过此接口把应用程序的标签数据传递给 UCenter。
:输入的参数放在 $get['id'] 中，值为标签名称。输出的数组需经过 uc_serialize 处理。
:{|
|-
| integer[0]
| 标签名称
|-
| array[1]
| 标签数据 mixed['xxx'] 自定义  <br>自定义多个数组项，索引名任意，一同返回给 UCenter。为了保证应用间数据的共享，您需要在“应用管理管理”的“标签单条显示模板”和“标签模板标记说明”设置模板和说明。模板中“{xxx}”表示标签数据的索引，代表相应的数据。如扩展数据模板中的“{image}”将显示“['image']”数组项的内容。
|}
:gettag 接口示例 (PHP)
<pre>
$query = $db->query("SELECT * FROM threadtags WHERE tagname='$get[id]' ORDER BY dateline DESC LIMIT 10");
$threadlist = array();
while($data = $db->fetch_array($query)) {
	$threadlist[] = array(
		'name' => $data['subject'],
		'uid' => $data['authorid'],
		'username' => $data['author'],
		'dateline' => $data['dateline'],
		'url' => 'http://www.yourwebsite.com/thread.php?id='.$data['id'],
		'image' => ''http://www.yourwebsite.com/threadimage.php?id='.$data['id'],
		);
	}
}

$return = array($name, $threadlist);
echo uc_serialize($return, 1);
</pre>
*synlogin
:如果应用程序需要和其他应用程序进行同步登录，此部分代码负责标记指定用户的登录状态。
:输入的参数放在 $get['uid'] 中，值为用户 ID。此接口为通知接口，无输出内容。同步登录需使用 P3P 标准。
:synlogin 接口示例 (PHP)
<pre>
$query = $db->query("SELECT uid, username FROM members WHERE uid='$get[uid]'");
if($member = $db->fetch_array($query)) {
	header('P3P: CP="CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR"');
	dsetcookie('Example_auth', authcode($member['uid']."\t".$member['username'], 'ENCODE'), 86400 * 365);
}
</pre>
*synlogout
:如果应用程序需要和其他应用程序进行同步退出登录，此部分代码负责撤销用户的登录的状态。
:此接口为通知接口，无输入参数和输出内容。同步退出需使用 P3P 标准。
:synlogout 接口示例 (PHP)
<pre>
header('P3P: CP="CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR"');
dsetcookie('Example_auth', '', -86400 * 365);
</pre>
*updatebadwords
:当 UCenter 的词语过滤设置变更时，此接口负责通知所有应用程序更新后的词语过滤设置内容。
:设置内容用 POST 方式提交到接口。接口运行完毕输出 API_RETURN_SUCCEED。
:updatebadwords 接口示例 (PHP)
<pre>
$post = uc_unserialize(file_get_contents('php://input'));
$cachefile = DISCUZ_ROOT.'./uc_client/data/cache/badwords.php';
$fp = fopen($cachefile, 'w');
$s = "<?php\r\n";
$s .= '$_CACHE[\'badwords\'] = '.var_export($post, TRUE).";\r\n";
fwrite($fp, $s);
fclose($fp);
exit(API_RETURN_SUCCEED);
</pre>
*updatehosts
:当 UCenter 的域名解析设置变更时，此接口负责通知所有应用程序更新后的域名解析设置内容。
:设置内容用 POST 方式提交到接口。接口运行完毕输出 API_RETURN_SUCCEED。
:updatehosts 接口示例 (PHP)
<pre>
$post = uc_unserialize(file_get_contents('php://input'));
$cachefile = DISCUZ_ROOT.'./uc_client/data/cache/hosts.php';
$fp = fopen($cachefile, 'w');
$s = "<?php\r\n";
$s .= '$_CACHE[\'hosts\'] = '.var_export($post, TRUE).";\r\n";
fwrite($fp, $s);
fclose($fp);
exit(API_RETURN_SUCCEED);
</pre>
*updateapps
:当 UCenter 的应用程序列表变更时，此接口负责通知所有应用程序更新后的应用程序列表。
:设置内容用 POST 方式提交到接口。接口运行完毕输出 API_RETURN_SUCCEED。
:updateapps 接口示例 (PHP)
<pre>
$post = uc_unserialize(file_get_contents('php://input'));
$cachefile = DISCUZ_ROOT.'./uc_client/data/cache/apps.php';
$fp = fopen($cachefile, 'w');
$s = "<?php\r\n";
$s .= '$_CACHE[\'apps\'] = '.var_export($post, TRUE).";\r\n";
fwrite($fp, $s);
fclose($fp);
exit(API_RETURN_SUCCEED);
</pre>
*updateclient
:当 UCenter 的基本设置信息变更时，此接口负责通知所有应用程序更新后的基本设置内容。
:设置内容用 POST 方式提交到接口。接口运行完毕输出 API_RETURN_SUCCEED。
:updateclient 接口示例 (PHP)
<pre>
$post = uc_unserialize(file_get_contents('php://input'));
$cachefile = DISCUZ_ROOT.'./uc_client/data/cache/setting.php';
$fp = fopen($cachefile, 'w');
$s = "<?php\r\n";
$s .= '$_CACHE[\'setting\'] = '.var_export($post, TRUE).";\r\n";
fwrite($fp, $s);
fclose($fp);
exit(API_RETURN_SUCCEED);
</pre>
*updatecredit
:当某应用执行了积分兑换请求的接口函数 uc_credit_exchange_request() 后，此接口负责通知被兑换的目的应用程序所需修改的用户积分值。
:输入的参数 $get['credit'] 表示积分编号，$get['amount'] 表示积分的增减值，$get['uid'] 表示用户 ID。
:updatecredit 接口示例 (PHP)
<pre>
$credit = intval($get['credit']);
$amount = intval($get['amount']);
$uid = intval($get['uid']);

$db->query("UPDATE members SET extcredits$credit=extcredits$credit+'$amount' WHERE uid='$uid'");
exit(API_RETURN_SUCCEED);
</pre>
*getcreditsettings
:此接口负责把应用程序的积分设置传递给 UCenter，以供 UCenter 在积分兑换设置中使用。
:此接口无输入参数。输出的数组需经过 uc_serialize 处理。
:输出的数组单条结构:
:{|style="background-color:#feb; border-collapse: collapse; border-spacing: 3px; border:1px solid #fd8; margin: 0px; width: 100%" cellpadding="3"
|-
| '''key'''
| '''类型'''
| '''value'''
|-
| n键值为积分编号
| array
| string [0]	积分名称<br>string [1]	积分单位
|}
:如：
<pre>
array(
        '1' => array('威望', ''),
        '2' => array('金钱', '枚'),
)
</pre>
:getcreditsettings 接口示例 (PHP)
<pre>
$credits = array();
foreach($_DCACHE['settings']['extcredits'] as $id => $extcredits) {
	$credits[$id] = array($extcredits['title'], $extcredits['unit']);
}
echo uc_serialize($credits);
</pre>
*updatecreditsettings
:此接口负责接收 UCenter 积分兑换设置的参数。
:输入的参数放在 $get['credit'] 中，值为设置的参数数组。接口运行完毕输出 API_RETURN_SUCCEED。
:输入的数组单条结构：
:{|style="background-color:#feb; border-collapse: collapse; border-spacing: 3px; border:1px solid #fd8; margin: 0px; width: 100%" cellpadding="3"
|-
| '''key'''
| '''类型'''
| '''value'''
|-
| appid 应用程序 ID
| array
| integer ['appiddesc']	积分兑换的目标应用程序 ID<br>integer ['creditdesc']	积分兑换的目标积分编号<br>integer ['creditsrc']	积分兑换的源积分编号<br>string ['title']	积分名称<br>string ['unit']	积分单位<br>integer ['ratio']	积分兑换比率
|}
:如：
<pre>
array(
        '1' => array(
                'appiddesc' => 2,
                'creditdesc' => 1,
                'creditsrc' => 1,
                'title' => '金钱',
                'unit' => '枚',
                'ratio' => 2,
        ),
)
</pre>
:updatecreditsettings 接口示例 (PHP)
<pre>
$outextcredits = array();
foreach($get['credit'] as $appid => $credititems) {
	if($appid == UC_APPID) {
		foreach($credititems as $value) {
			$outextcredits[$value['appiddesc'].'|'.$value['creditdesc']] = array(
				'creditsrc' => $value['creditsrc'],
				'title' => $value['title'],
				'unit' => $value['unit'],
				'ratio' => $value['ratio']
			);
		}
	}
}

$db->query("REPLACE INTO cdb_settings (variable, value) VALUES ('outextcredits', '".addslashes(serialize($outextcredits))."');", 'UNBUFFERED');
exit(API_RETURN_SUCCEED);
</pre>
*getcredit
:此接口用于把应用程序中指定用户的积分传递给 UCenter。
:输入的参数 $get['uid'] 为用户 ID，$get['credit'] 为积分编号。接口运行完毕输出积分值。
:getcredit 接口示例 (PHP)
<pre>
$uid = intval($get['uid']);
$credit = intval($get['credit']);
echo $db->result_first("SELECT extcredits$credit FROM members WHERE uid='$uid'");
</pre>


===函数定义===

接口函数中必须包含以下函数，否则无法正确对 UCenter 传递过来的数据进行解码。

<pre>
function authcode($string, $operation = 'DECODE', $key = '', $expiry = 0) {

	$ckey_length = 4;

	$key = md5($key ? $key : UC_KEY);
	$keya = md5(substr($key, 0, 16));
	$keyb = md5(substr($key, 16, 16));
	$keyc = $ckey_length ? ($operation == 'DECODE' ? substr($string, 0, $ckey_length): substr(md5(microtime()), -$ckey_length)) : '';

	$cryptkey = $keya.md5($keya.$keyc);
	$key_length = strlen($cryptkey);

	$string = $operation == 'DECODE' ? base64_decode(substr($string, $ckey_length)) : sprintf('%010d', $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') {
		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 {
		return $keyc.str_replace('=', '', base64_encode($result));
	}

}

function uc_serialize($arr, $htmlon = 0) {
	include_once UC_CLIENT_ROOT.'./lib/xml.class.php';
	return xml_serialize($arr, $htmlon);
}

function uc_unserialize($s) {
	include_once UC_CLIENT_ROOT.'./lib/xml.class.php';
	return xml_unserialize($s);
}
</pre>

==范例程序==

为了方便开发，我们把所有的 UCenter 接口函数组合在一起，制作了范例程序。要运行此范例程序，您需要做的准备工作如下：

#范例程序中默认不包含 client 目录，如果要运行此范例程序，请复制一份 UCenter 安装包中的 client 到范例程序根目录。
#在 UCenter 添加一个应用，设置范例程序运行的 URL 等信息，通信密钥可随意填写，如“123456”。
#打开范例程序的 config.inc.php 设置范例程序连接 UCenter 的方式，设置数据库连接等参数。“UC_KEY”填写在 UCenter 设置的通信密钥（上例的“12345”），“UC_APPID”填写刚才添加的应用 ID。


ucexample_1.php 为无用户表的范例程序主文件

ucexample_2.php 为有自己的用户表的范例程序主文件


具体目录结构请见下表：
{|border="0" cellspacing="0" cellpadding="0" style="border-collapse:collapse;"
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | client/
| style="border:1px solid #bbb;" | UCenter 客户端的文件目录，默认不包含此目录。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | api/
| style="border:1px solid #bbb;" | API 接口目录
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/
| style="border:1px solid #bbb;" | 范例代码程序段目录
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/login_nodb.php
| style="border:1px solid #bbb;" | ucexample_1.php 的用户登录范例代码，包含登录验证、同步登录的范例代码。让你了解到没有用户表也可以整合 UCenter。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/login_db.php
| style="border:1px solid #bbb;" | ucexample_2.php 的用户登录范例代码，包含登录验证、同步登录和用户激活的范例代码。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/register_nodb.php
| style="border:1px solid #bbb;" | ucexample_1.php 的用户注册范例代码，包含注册信息验证的范例代码。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/register_db.php
| style="border:1px solid #bbb;" | ucexample_2.php 的用户注册范例代码，包含注册信息验证、用户激活判断的范例代码。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/pmwin.php
| style="border:1px solid #bbb;" | 直接进入短消息中心的范例代码。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/pmlist.php
| style="border:1px solid #bbb;" | 自制短消息平台的范例代码，包含获取短消息的列表、内容以及发送短消息的范例代码。
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/friend.php
| style="border:1px solid #bbb;" | 管理好友列表的范例代码
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | code/avatar.php
| style="border:1px solid #bbb;" | 查看、编辑头像的范例代码
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | include/
| style="border:1px solid #bbb;" | 库文件文件
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | view/
| style="border:1px solid #bbb;" | 模板目录
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | config.inc.php
| style="border:1px solid #bbb;" | 配置文件
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | ucexample_1.php
| style="border:1px solid #bbb;" | 应用程序无用户表的范例程序主文件
|-
| style="background-color:#f3f3f3;border:1px solid #bbb;" | ucexample_2.php
| style="border:1px solid #bbb;" | 应用程序有自己的用户表的范例程序主文件
|}