以下關於檔案的闡述以及程式碼的樣例,均以 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);

詳細的介面函式說明,請看“介面函式”章節。