UCenter 採用 服務端/客戶端 雙端架構:
upload/安裝時上傳此文件夾內容至服務器,訪問 https://domain/install/ 執行安裝。安裝完成後必須刪除 install/ 目錄。
| 目錄/文件 | 功能描述 |
|---|---|
control/ | MVC 控制器層,處理各模塊業務邏輯(用戶、應用、積分、短消息...) |
data/ | 緩存數據目錄(需可寫權限 777),含緩存文件、臨時數據 |
images/ | 界面圖片資源 |
install/ | 安裝程序目錄(安裝後刪除) |
js/ | JavaScript 腳本庫 |
lib/ | 核心函數庫(數據庫操作、加密、XML/RPC 通信...) |
module/ | 模塊業務邏輯(與 control 配合,處理具體功能) |
view/ | 模板視圖文件 |
index.php | 服務端 API 入口(客戶端調用端點) |
admin.php | 管理後台入口 |
avatar.php | 頭像顯示/生成接口 |
client/(應用中通常重命名為 uc_client/)每個接入 UCenter 的應用程序根目錄下必須包含此目錄(Comsenz 產品默認命名為 uc_client/)。
| 目錄/文件 | 功能描述 |
|---|---|
control/ | 應用端接收 UCenter 通知的控制器(如同步登錄、刪除用戶回調) |
data/ | 本地緩存目錄(需可寫權限 777),緩存用戶數據、配置、模板 |
lib/ | 客戶端核心函數庫(加密解密、XML 解析、HTTP 請求封裝) |
module/ | 應用端業務模塊(實現同步登錄、註冊、修改資料等具體邏輯) |
client.php | 核心接口文件,定義所有 uc_* 客戶端調用函數 |
data/、data/cache/、data/avatar/、data/backup/、data/logs/、data/tmp/data/、data/cache//www/wwwroot/
├── ucenter/ # 服務端獨立站點
│ ├── control/
│ ├── data/ ← 需可寫
│ ├── index.php
│ └── admin.php
├── bbs/ # Discuz! 應用
│ ├── uc_client/ # 客戶端(重命名自 client/)
│ │ ├── data/ ← 需可寫
│ │ └── client.php
│ └── config/config_global.php # 定義 UC_* 常量
├── mall/ # ECShop 應用
│ └── uc_client/ # 同一套客戶端代碼
└── blog/ # UCHome 應用
└── uc_client/
| 現象 | 可能原因 | 排查方向 |
|---|---|---|
| 通信失敗 | UC_API/UC_KEY/UC_IP 不一致 | 對比服務端 config.inc.php 與應用端 config_global.php |
| 頭像不顯示 | 服務端 data/avatar/ 不可寫 | chmod 777 data/avatar/ |
| 同步登錄無效 | 客戶端 control/ 缺失或不可讀 | 檢查 uc_client/control/ 完整性 |
| 緩存不更新 | 雙端 data/cache/ 不可寫 | 檢查權限、磁盤空間、inode 耗盡 |
清晰的「服務端 upload/ + 客戶端 client/」雙目錄架構,是 UCenter 支撐多應用高擴展性的基石。掌握目錄職責、權限要求、部署拓撲,是運行維護 UCenter 系統的必備基本功。