以下关于文件的阐述以及代码的样例,均以 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 接口函数前请根据应用程序的需求定义以下相关常量:
使用 UCenter 接口函数库必须包含 uc_client/client.php 接口函数库文件,例如下面检查新短消息的代码:
详细的接口函数说明,请看“接口函数”章节。
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 |
include './uc_client/client.php'; $newpm = uc_pm_checknew($Example_uid);