目錄結構

下面是 Discuz! 的文件目錄及對應的描述。日常的開發中主要會涉及到 source 和 template 目錄。雖然目錄和文件都很多,但是實際上結構還是很清晰,大多數情況下通過文件名和目錄就能知道某個文件的作用。比如:

	source/class/discuz/discuz_censor.php  用來處理敏感詞過濾的類
	source/function/function_credit.php  處理積分操作的函數庫
	source/module/forum/forum_viewthread.php 處理帖子顯示頁面的模塊

另外,source 目錄下的 class 、 function 、 module 、 include 、 admincp 這幾個文件夾下的程序文件命名要遵守如下規則:文件名前綴為所在目錄的名字加上下劃線 (_)
目錄結構詳細:

/┬── api 外部接口
 │      ├── connect	騰訊互聯
 │      ├── db	UCenter 數據庫備份接口
 │      ├── google	Google 引擎使用
 │      ├── javascript	數據和廣告的 JS 調用
 │      ├── manyou	manyou 應用及搜索等相關服務
 │      └── trade	在線支付接口
 ├── archiver	論壇靜態化
 ├── config	站點配置文件
 ├── data	數據緩存及附件
 │      ├── attachment	上傳的文件目錄
 │      │      ├── album	相冊專用
 │      │      ├── block	DIY 專用
 │      │      ├── common	公共上傳
 │      │      ├── forum	論壇附件專用
 │      │      ├── group	羣組圖標和頭部圖片專用
 │      │      ├── portal	門户上傳文件專用
 │      │      ├── profile	個人資料專用
 │      │      └── temp	臨時文件
 │      ├── avatar	視頻認證專用
 │      ├── backup	站點數據備份
 │      ├── cache	數據緩存
 │      ├── diy	DIY 模塊緩存
 │      ├── ipdata	Discuz!IP 庫
 │      ├── log	站點日誌,前/後台管理日誌、錯誤日誌等
 │      ├── plugindata	插件緩存數據
 │      ├── template	模板緩存目錄
 │      └── threadcache	帖子緩存
 ├── install 安裝目錄
 ├── source 代碼主目錄
 │      ├── admincp	後台程序
 │      │      ├── cloud	Discuz! 雲平台
 │      │      ├── menu	菜單
 │      │      └── moderate	審核功能
 │      ├── archiver	論壇靜態化功能代碼
 │      ├── class	類文件目錄
 │      │      ├── adv	站點廣告功能
 │      │      ├── block	DIY 模塊功能文件
 │      │      ├── cache	緩存類
 │      │      ├── db	數據庫類
 │      │      ├── discuz	discuz 類
 │      │      ├── forum	論壇
 │      │      ├── helper	存放從 function_core 分離出來的一部分函數
 │      │      ├── lib	工具類的集合類
 │      │      ├── magic	道具
 │      │      ├── memory	內存類
 │      │      ├── secqaa	驗證問答
 │      │      ├── table	數據表操作類
 │      │      └── task	站點任務功能
 │      ├── function	函數文件
 │      │      └── cache	緩存功能拆分目錄
 │      ├── include	被包含的文件
 │      │      ├── collection	淘帖
 │      │      ├── cron	計劃任務
 │      │      ├── misc	雜項
 │      │      ├── modcp	前台論壇管理
 │      │      ├── portalcp	前台門户管理
 │      │      ├── post	帖子相關
 │      │      ├── search	搜索功能
 │      │      ├── space	家園和個人相關功能
 │      │      ├── spacecp	個人設置相關
 │      │      ├── table	編碼轉換數據
 │      │      ├── thread	查看主題相關
 │      │      └── topicadmin	前台主題管理
 │      ├── language	站點語言包
 │      │      ├── adv	廣告
 │      │      ├── block	DIY 模塊
 │      │      ├── forum	論壇
 │      │      ├── group	羣組
 │      │      ├── home	家園
 │      │      ├── magic	道具
 │      │      ├── member	登錄註冊頁面語言
 │      │      ├── mobile	手機訪問功能語言
 │      │      ├── portal	門户語言
 │      │      ├── ranklist	排行榜語言
 │      │      ├── search	搜索
 │      │      ├── secqaa	安全問答
 │      │      ├── tag	標籤
 │      │      ├── task	任務
 │      │      └── userapp	manyou 應用
 │      ├── module	功能模塊
 │      │      ├── connect	騰訊互聯
 │      │      ├── forum	論壇
 │      │      ├── group	羣組
 │      │      ├── home	家園
 │      │      ├── member	登錄註冊
 │      │      ├── misc	雜項
 │      │      ├── portal	門户
 │      │      ├── search	搜索
 │      │      └── userapp	應用
 │      └── plugin	插件目錄
 │              ├── cloudstat	Discuz! 雲平台
 │              ├── myapp	Manyou 應用
 │              ├── myrepeats	馬甲功能
 │              ├── qqconnect	騰訊互聯
 │              └── soso_smilies	騰訊搜搜表情
 ├── static	非 PHP 文件
 │      ├── image	界面圖片
 │      ├── js	站點 JS 腳本
 │      ├── space	空間皮膚
 │      └── topic	門户皮膚
 ├── template	模板目錄
 │      └── default	默認風格
 ├── uc_client	UCenter 客户端程序
 └── uc_server	UCenter 服務端程序

自動加載

Discuz! X2.5 要求 PHP 版本大於 5.1,拋棄了對 PHP4 的支持,因此支持更多的 PHP 新特性,自動加載類文件就是其中一個。在 class_core.php 中有這樣一段代碼:

if(function_exists('spl_autoload_register')) {
	spl_autoload_register(array('core', 'autoload'));
} else {
	function __autoload($class) {
		return core::autoload($class);
	}
}

當調用不存在的類的時候就會調用 core::autoload 方法來加載相應的類文件。所以我們在開發的過程中就要用到某個類的時候就不需要 include 或者 require 了。只要對應的類文件存在,並且命名符合規範,直接調用即可。
注意:產品中個別特殊類由於歷史原因無法實現自動加載,需手動處理 include 或 require

class_core.php 流程控制的説明

class_core.php 是入口啓動文件,主要實現了以下功能:

  • 註冊 autoload 方法和異常處理方法
  • C::t 方法的實現:通過 C::t 方法來調用數據層對應表的對象來實現對數據的操作
  • memory 的初始化:主要由 discuz_memory 類來實現
  • 創建 discuz_application 實例 ( discuz_application 是原來 Discuz! X2 的
    discuz_core):進行核心的初始化操作,主要有加載配置文件、加載環境變量、連接數據庫、加載 setting 信息、初始化用户數據、
    session 的初始、計劃任務等
  • 簡寫類的映射:將 class core 映射為 C,discuz_database 映射為 DB,僅為方便使用,代碼如下
class C extends core {}
class DB extends discuz_database {}