# 組件(Component)
組件是 Yii 應用的主要基石。是 yii\base\Component 類或其子類的實例。三個用以區分它和其它類的主要功能有:
* [屬性(Property)](http://www.yiichina.com/doc/guide/2.0/concept-properties)
* [事件(Event)](http://www.yiichina.com/doc/guide/2.0/concept-events)
* [行為(Behavior)](http://www.yiichina.com/doc/guide/2.0/concept-behaviors)
或單獨使用,或彼此配合,這些功能的應用讓 Yii 的類變得更加靈活和易用。以小部件 yii\jui\DatePicker 來舉例,這是個方便你在?[視圖](http://www.yiichina.com/doc/guide/2.0/structure-view)中生成一個交互式日期選擇器的 UI 組件:
~~~
use yii\jui\DatePicker;
echo DatePicker::widget([
'language' => 'zh-CN',
'name' => 'country',
'clientOptions' => [
'dateFormat' => 'yy-mm-dd',
],
]);
~~~
這個小部件繼承自 yii\base\Component,它的各項屬性改寫起來會很容易。
正是因為組件功能的強大,他們比常規的對象(Object)稍微重量級一點,因為他們要使用額外的內存和 CPU 時間來處理?[事件](http://www.yiichina.com/doc/guide/2.0/concept-events)?和?[行為](http://www.yiichina.com/doc/guide/2.0/concept-behaviors)?。如果你不需要這兩項功能,可以繼承 yii\base\Object 而不是 yii\base\Component。這樣組件可以像普通 PHP 對象一樣高效,同時還支持[屬性(Property)](http://www.yiichina.com/doc/guide/2.0/concept-properties)功能。
當繼承 yii\base\Component 或 yii\base\Object 時,推薦你使用如下的編碼風格:
* 若你需要重寫構造方法(Constructor),傳入?`$config`?作為構造器方法**最后一個**參數,然后把它傳遞給父類的構造方法。
* 永遠在你重寫的構造方法**結尾處**調用一下父類的構造方法。
* 如果你重寫了 yii\base\Object::init() 方法,請確保你在?`init`?方法的**開頭處**調用了父類的?`init`?方法。
例子如下:
~~~
namespace yii\components\MyClass;
use yii\base\Object;
class MyClass extends Object
{
public $prop1;
public $prop2;
public function __construct($param1, $param2, $config = [])
{
// ... 配置生效前的初始化過程
parent::__construct($config);
}
public function init()
{
parent::init();
// ... 配置生效后的初始化過程
}
}
~~~
另外,為了讓組件可以在創建實例時[能被正確配置](http://www.yiichina.com/doc/guide/2.0/concept-configurations),請遵照以下操作流程:
~~~
$component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]);
// 方法二:
$component = \Yii::createObject([
'class' => MyClass::className(),
'prop1' => 3,
'prop2' => 4,
], [1, 2]);
~~~
> 補充:盡管調用 Yii::createObject() 的方法看起來更加復雜,但這主要因為它更加靈活強大,它是基于[依賴注入容器](http://www.yiichina.com/doc/guide/2.0/concept-di-container)實現的。
yii\base\Object 類執行時的生命周期如下:
1. 構造方法內的預初始化過程。你可以在這兒給各屬性設置缺省值。
2. 通過?`$config`?配置對象。配置的過程可能會覆蓋掉先前在構造方法內設置的默認值。
3. 在 yii\base\Object::init() 方法內進行初始化后的收尾工作。你可以通過重寫此方法,進行一些良品檢驗,屬性的初始化之類的工作。
4. 對象方法調用。
前三步都是在對象的構造方法內發生的。這意味著一旦你獲得了一個對象實例,那么它就已經初始化就緒可供使用。
- 介紹(Introduction)
- 關于 Yii(About Yii)
- 從 Yii 1.1 升級(Upgrading from Version 1.1)
- 入門(Getting Started)
- 安裝 Yii(Installing Yii)
- 運行應用(Running Applications)
- 第一次問候(Saying Hello)
- 使用 Forms(Working with Forms)
- 玩轉 Databases(Working with Databases)
- 用 Gii 生成代碼(Generating Code with Gii)
- 更上一層樓(Looking Ahead)
- 應用結構(Application Structure)
- 結構概述(Overview)
- 入口腳本(Entry Scripts)
- 應用(Applications)
- 應用組件(Application Components)
- 控制器(Controllers)
- 模型(Models)
- 視圖(Views)
- 模塊(Modules)
- 過濾器(Filters)
- 小部件(Widgets)
- 前端資源(Assets)
- 擴展(Extensions)
- 請求處理(Handling Requests)
- 運行概述(Overview)
- 引導(Bootstrapping)
- 路由引導與創建 URL(Routing and URL Creation)
- 請求(Requests)
- 響應(Responses)
- Sessions and Cookies
- 錯誤處理(Handling Errors)
- 日志(Logging)
- 關鍵概念(Key Concepts)
- 組件(Components)
- 屬性(Properties)
- 事件(Events)
- 行為(Behaviors)
- 配置(Configurations)
- 別名(Aliases)
- 類自動加載(Class Autoloading)
- 服務定位器(Service Locator)
- 依賴注入容器(Dependency Injection Container)
- 配合數據庫工作(Working with Databases)
- 數據庫訪問(Data Access Objects): 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器(Query Builder): 使用簡單抽象層查詢數據庫
- 活動記錄(Active Record): 活動記錄對象關系映射(ORM),檢索和操作記錄、定義關聯關系
- 數據庫遷移(Migrations): 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據(Getting Data from Users)
- 創建表單(Creating Forms)
- 輸入驗證(Validating Input)
- 文件上傳(Uploading Files)
- 收集列表輸入(Collecting Tabular Input)
- 多模型同時輸入(Getting Data for Multiple Models)
- 顯示數據(Displaying Data)
- 格式化輸出數據(Data Formatting)
- 分頁(Pagination)
- 排序(Sorting)
- 數據提供器(Data Providers)
- 數據小部件(Data Widgets)
- 操作客戶端腳本(Working with Client Scripts)
- 主題(Theming)
- 安全(Security)
- 認證(Authentication)
- 授權(Authorization)
- 處理密碼(Working with Passwords)
- 客戶端認證(Auth Clients)
- 安全領域的最佳實踐(Best Practices)
- 緩存(Caching)
- 概述(Overview)
- 數據緩存(Data Caching)
- 片段緩存(Fragment Caching)
- 分頁緩存(Page Caching)
- HTTP 緩存(HTTP Caching)
- RESTful Web 服務
- 快速入門(Quick Start)
- 資源(Resources)
- 控制器(Controllers)
- 路由(Routing)
- 格式化響應(Response Formatting)
- 授權驗證(Authentication)
- 速率限制(Rate Limiting)
- 版本化(Versioning)
- 錯誤處理(Error Handling)
- 開發工具(Development Tools)
- 調試工具欄和調試器(Debug Toolbar and Debugger)
- 使用 Gii 生成代碼(Generating Code using Gii)
- TBD 生成 API 文檔(Generating API Documentation)
- 測試(Testing)
- 概述(Overview)
- 搭建測試環境(Testing environment setup)
- 單元測試(Unit Tests)
- 功能測試(Functional Tests)
- 驗收測試(Acceptance Tests)
- 測試夾具(Fixtures)
- 高級專題(Special Topics)
- 高級應用模版(Advanced Project Template)
- 從頭構建自定義模版(Building Application from Scratch)
- 控制臺命令(Console Commands)
- 核心驗證器(Core Validators)
- 國際化(Internationalization)
- 收發郵件(Mailing)
- 性能優化(Performance Tuning)
- 共享主機環境(Shared Hosting Environment)
- 模板引擎(Template Engines)
- 集成第三方代碼(Working with Third-Party Code)
- 小部件(Widgets)
- Bootstrap 小部件(Bootstrap Widgets)
- jQuery UI 小部件(jQuery UI Widgets)
- 助手類(Helpers)
- 助手一覽(Overview)
- Array 助手(ArrayHelper)
- Html 助手(Html)
- Url 助手(Url)