ucenter开发手册下载地址:
http://dl.iteye.com/topics/download/5d0e6c09-1162-3193-8bde-41d728054040
UCenter 简介
UCenter 的中文意思就是“用户中心”,其中的 U 代表 User 也代表 You,取其中的含义就是“用户中心”,或者说“你(最终用户)的中心”。UCenter 是今后 Comsenz 旗下各个产品之间信息直接传递的一个桥梁,通过 UCenter 站长可以无缝整合 Comsenz 系列产品,甚至其它更多的第三方应用程序,实现用户的一站式登录,个人信息、积分等的统一管理。
本手册针对的是有一定网页程序开发制作经验的读者。其目的是提供最新最全的 UCenter 接口函数索引,方便开发基于 UCenter 的应用程序。
手册设计: Ning 'Monkey' Hou, Xiongfei 'Redstone' Zhao, Min 'Heyond' Huang,
界面设计: Defeng 'Dfox' Xu
手册版本: 2008-12-12, 请访问 http://www.discuz.net/thread-879237-1-1.html 获取最新版本
适用版本: UCenter 1.5.0 Release 20081031 及以上版本
官方论坛: http://www.discuz.net/forum-155-1.html
k686绿色软件:
http://www.k686.com
以下关于文件的阐述以及代码的样例,均以 PHP 程序为例。
UCenter 的目录结构
UCenter 分为服务端和客户端 2 个部分。服务端目录为“upload/”,客户端目录为“client/”。无论你的网站有多少个应用程序,服务端在一个网站中只需安装一次。而客户端则必须存在于每一个应用的根目录中。具体目录结构请见下表:
服务端:upload/UCenter 安装时上传此文件夹中的文件到您的服务器,在浏览器输入“http://网站地址/install/”安装 UCenter。安装后删除 install/ 目录。 control/ 应用程序 control 部分目录
data/ 缓存数据目录,此目录及其子目录需要有可写权限
images/ 图片目录
install/ 安装目录,安装后必须删除
js/ javascript 脚本目录
lib/ 应用程序函数库目录
module/ 应用程序 module 部分目录
view/ 模板目录
index.php 服务端接口函数库接口文件
admin.php 用户管理中心主文件
avatar.php 头像显示
客户端:client/UCenter 应用程序必备的目录,如果您的应用程序基于 UCenter,那么您的应用程序目录中必须包含此目录,目录名可自定义(所有 Comsenz 的产品对应的目录名为“uc_client/”)。 control/ 应用程序 control 部分目录
data/ 缓存数据目录,此目录及其子目录需要有可写权限
lib/ 应用程序函数库目录
module/ 应用程序 module 部分目录
client.php 接口函数库
UCenter 的接口函数
UCenter 分为 MySQL 和远程两种接口连接方式,MySQL 方式是直接连接数据库因此速度较快,但当 UCenter 的服务端和客户端不在同一主机中且没有远程 MySQL 帐号的情况下,则只能使用远程连接方式。使用 UCenter 接口函数前请根据应用程序的需求定义以下相关常量: UC_CONNECT 连接 UCenter 的方式
mysql:MySQL 方式
空:远程方式
UC_DBHOST UCenter 数据库主机
UC_DBUSER UCenter 数据库用户名
UC_DBPW UCenter 数据库密码
UC_DBNAME UCenter 数据库名称
UC_DBCHARSET UCenter 数据库字符集
UC_DBTABLEPRE UCenter 数据库表前缀
UC_DBCONNECT UCenter 数据库持久连接 0=关闭, 1=打开
UC_KEY 与 UCenter 的通信密钥, 要与 UCenter 保持一致
UC_API UCenter 服务端的 URL 地址
UC_IP UCenter 的 IP, 当 UC_CONNECT 为非 mysql 方式时, 并且当前应用服务器解析域名有问题时, 请设置此值
UC_CHARSET UCenter 的字符集
UC_APPID 当前应用的 ID
使用 UCenter 接口函数库必须包含 uc_client/client.php 接口函数库文件,例如下面检查新短消息的代码:
include './uc_client/client.php';
$newpm = uc_pm_checknew($Example_uid);
详细的接口函数说明,请看“接口函数”章节。