Yii 框架原始碼閱讀（一）：核心目錄結構深度解析

前言

Yii 作為高效能 PHP 框架，其原始碼結構清晰、模組化程度高。閱讀核心目錄結構是理解框架運作機制、擴展功能、排查疑難雜症的基礎。本文系統梳理 Yii 1.x 核心庫 framework/ 目錄架構。

頂層目錄總覽

framework/
├── base/           # 基礎核心類
├── caching/        # 快取組件
├── cli/            # 命令列工具
├── collections/    # 資料結構集合
├── console/        # 控制台應用
├── db/             # 資料庫存取層
├── gii/            # 代碼生成器
├── i18n/           # 國際化
├── logging/        # 日誌系統
├── messages/       # 多語言訊息
├── test/           # 測試基礎
├── utils/          # 工具類
├── validators/     # 驗證器
├── vendors/        # 第三方庫
├── views/          # 系統視圖
└── web/            # Web 應用核心

核心目錄深度解析

1. base/ — 框架基石

包含框架最核心的基礎類：

• CApplication：應用程式類，處理全域請求週期、管理應用組件集合
• CComponent：組件基類，實現屬性、事件、行為（Behavior）機制，支援混入式程式設計
• CBehavior：行為類，讓類在不繼承的情況下擴展功能
• CModel：模型基類，提供屬性驗證、安全賦值、場景等功能
• CModule：模組基類，支援巢狀模組架構

2. caching/ — 多樣化快取支援

• CCache 抽象基類
• CMemCache、CApcCache、CXCache、CEAcceleratorCache 等具體實現
• CDummyCache：空實現，開發/測試環境禁用快取用
• 支援快取依賴、鏈式快取、片段快取

3. db/ — 資料庫存取層 (DAO/ActiveRecord)

• CDbConnection：PDO 連線封裝、主從分離、查詢快取
• CDbCommand：SQL 執行、參數綁定、查詢建構器
• CActiveRecord：ORM 核心，支援關聯、命名範圍、行為掛載
• CDbMigration：資料庫版本控制遷移工具

4. web/ — Web 應用核心（最龐大模組）

web/
├── actions/        # 控制器動作類 (CAction, CInlineAction)
├── auth/           # 認證授權 (CAuthManager, CAccessControlFilter, CWebUser)
├── helpers/        # HTML、URL、表單等視圖輔助類
├── widgets/        # UI 元件 (CWidget, CBasePager, CListView, CGridView, CActiveForm)
├── services/       # Web 服務 (SOAP, REST)
└── ...

5. gii/ — 代碼生成器（腳手架）

Web 介面生成 Model、Controller、View、CRUD、Module、Extension 等代碼，極大提升開發效率。

6. i18n/ — 國際化支援

• 訊息翻譯：CPhpMessageSource、CGettextMessageSource
• 日期/時間/數字格式化：CDateTimeFormatter、CNumberFormatter
• 多語言資料檔案存放於 messages/

7. logging/ — 靈活日誌系統

• 多層級：trace, info, profile, warning, error
• 多路由：CFileLogRoute、CEmailLogRoute、CWebLogRoute（FirePHP）、CDbLogRoute
• 支援過濾器、分類、情境資訊

閱讀建議路徑

1. 從 base/CApplication.php 切入，理解應用啟動流程（init() → run() → processRequest()）
2. 研讀 base/CComponent.php 掌握屬性/事件/行為機制，這是 Yii 擴展性的核心
3. 深入 db/CActiveRecord.php 理解 ORM 實現細節（關聯載入、命名範圍、預載入）
4. 研究 web/widgets/ 學習可重用 UI 元件設計模式
5. 查看 gii/ 理解代碼生成模板與自定義擴展

總結

Yii 核心庫採用高內聚、低耦合的模組化設計。base/ 奠定基礎設施，db/ 與 web/ 構建業務開發主戰場，caching/、logging/、i18n/ 提供企業級支撐。系統閱讀原始碼不僅能精通框架用法，更能學習優秀的 PHP 架構設計模式。