簡要剖析PHP的Yii框架的組件化機制的基本知識
組件是 Yii 應(yīng)用的主要基石。是 yii\base\Component 類或其子類的實例。三個用以區(qū)分它和其它類的主要功能有:
- 屬性(Property)
- 事件(Event)
- 行為(Behavior)
或單獨使用,或彼此配合,這些功能的應(yīng)用讓 Yii 的類變得更加靈活和易用。以小部件 yii\jui\DatePicker 來舉例,這是個方便你在 視圖中生成一個交互式日期選擇器的 UI 組件:
use yii\jui\DatePicker;
echo DatePicker::widget([
'language' => 'zh-CN',
'name' => 'country',
'clientOptions' => [
'dateFormat' => 'yy-mm-dd',
],
]);
這個小部件繼承自 yii\base\Component,它的各項屬性改寫起來會很容易。
正是因為組件功能的強大,他們比常規(guī)的對象(Object)稍微重量級一點,因為他們要使用額外的內(nèi)存和 CPU 時間來處理 事件 和 行為 。如果你不需要這兩項功能,可以繼承 yii\base\Object 而不是 yii\base\Component。這樣組件可以像普通 PHP 對象一樣高效,同時還支持屬性(Property)功能。
當繼承 yii\base\Component 或 yii\base\Object 時,推薦你使用如下的編碼風格:
若你需要重寫構(gòu)造方法(Constructor),傳入 $config 作為構(gòu)造器方法最后一個參數(shù),然后把它傳遞給父類的構(gòu)造方法。
永遠在你重寫的構(gòu)造方法結(jié)尾處調(diào)用一下父類的構(gòu)造方法。
如果你重寫了 yii\base\Object::init() 方法,請確保你在 init 方法的開頭處調(diào)用了父類的 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();
// ... 配置生效后的初始化過程
}
}
另外,為了讓組件可以在創(chuàng)建實例時能被正確配置,請遵照以下操作流程:
$component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]); // 方法二: $component = \Yii::createObject([ 'class' => MyClass::className(), 'prop1' => 3, 'prop2' => 4, ], [1, 2]);
補充:盡管調(diào)用 Yii::createObject() 的方法看起來更加復(fù)雜,但這主要因為它更加靈活強大,它是基于依賴注入容器實現(xiàn)的。
yii\base\Object 類執(zhí)行時的生命周期如下:
構(gòu)造方法內(nèi)的預(yù)初始化過程。你可以在這兒給各屬性設(shè)置缺省值。
通過 $config 配置對象。配置的過程可能會覆蓋掉先前在構(gòu)造方法內(nèi)設(shè)置的默認值。
在 yii\base\Object::init() 方法內(nèi)進行初始化后的收尾工作。你可以通過重寫此方法,進行一些良品檢驗,屬性的初始化之類的工作。
對象方法調(diào)用。
前三步都是在對象的構(gòu)造方法內(nèi)發(fā)生的。這意味著一旦你獲得了一個對象實例,那么它就已經(jīng)初始化就緒可供使用。
應(yīng)用程序CWebApplication組件
在說明Yii中各個組件使用方法前,先了解最重要的一個組件CWebApplication。CWebApplication即應(yīng)用程序?qū)ο?,它的根類也是CComponent,故它也是一個組件,具有Yii組件的共同特征。
具體來說,CWebApplication組件的主要作用是根據(jù)配置文件,加載必要的輔助組件,并在這些組件的幫助下(如urlManager)創(chuàng)建并運行控制器。故也將其稱為前端控制器。
我們可以在配置文件中指定CWebApplication組件本身的配置參數(shù),這些參數(shù)被設(shè)置為其公共成員變量,或是自動調(diào)用setter方法設(shè)置屬性,這個特性可以在CWebApplication的構(gòu)造函數(shù)中發(fā)現(xiàn):$this->configure($config);
如在配置文件protected/config/main.php全局中指定:
'charset' => 'utf-8',
這實際是設(shè)置當前應(yīng)用程序的charset公共屬性(在CApplication中聲明)而如果在配置文件中指定'language' => 'zh_cn', 我們發(fā)現(xiàn)CWebApplication及其所有上級類均未聲明$language屬性,這時將使用setter模式方法即setlanuage(此方法定義在CApplication類中)。
OK,了解這個特性之后,我們就可以明白在配置文件中可以配置的屬性:
- CWebApplication及其所有上級類的公共成員變量
- CWebApplication及其所有上級類的setter方法指定的屬性當然我們也可以通過繼承CWebApplication構(gòu)造自己的應(yīng)用程序類。
CWebApplication的繼承層次為:CApplication -> CModule -> CComponent, 我們將默認的配置文件中常見的配置項及其生效位置予以說明:
- basePath : CApplication::setBasePath()
- name: CApplication::$name
- preload: CModule::$preload
- import: CModule::setImport()
- defaultController: CWebApplication::$defaultController
- components: CModule::setComponents()
類似地,再列出幾個默認配置文件中并未列出的配置項:timezone: CApplication::setTimeZone() #配置時區(qū)
再例如,如果我們繼承CWebApplication, 擴展自己的應(yīng)用程序類myApp, 并定義方法setError_reporting(不區(qū)分大小寫), 那么就可以直接在配置文件中指定error_reporting選項。
輔助組件可以將CWebApplication組件視為一部機器,那么輔助組件就可以視為組成這部機器的各個零件,沒有零件的正確組合,機器就無法正常工作,這在Yii中也是同樣的概念。而一些組件對整部機器的運轉(zhuǎn)是必須的,這就是核心組件。在應(yīng)用程序?qū)ο髽?gòu)造后,Yii會將輔助組件基本信息進行登記(組件名稱與類名,屬性配置的對照表),以供后續(xù)使用,對web應(yīng)用程序而言,存在以下核心組件(通過CWebApplication::registerCoreComponents,CApplication::registerCoreComponents注冊):
CWebApplication::registerCoreComponents中注冊的核心組件

CApplication::registerCoreComponents中注冊的核心組件

配置文本中注冊的核心組件:log CLogRouter 日志路由管理器
以上標記為紅色的條目,是最重要的輔助組件,其它的核心組件我們未必會使用到。
如何定義輔助組件的屬性?通過在配置文件protected/config/main.php中設(shè)置components項的值,實現(xiàn)組件屬性定義。這里的定義主要是三個要素:指定組件的名稱(核心組件已經(jīng)預(yù)先設(shè)置)、指定組件使用的類(核心組件無須定義),組件的屬性(可選、視情況而定)
如以下配置:
'components' => array( 'db' => array( 'class' => 'myCDbConnection', 'connnectionString' => 'mysql:host=localhost;dbname=test;charset=utf8', 'user' => 'root', ), );
就設(shè)置了db組件使用的類為myCDbConnection, 并且在后面指定了連接串及賬號等信息。提示: myCDbConnection類可能就是通過繼承CDbConnection類定義。核心組件無須指定class參數(shù)(因為已經(jīng)預(yù)先定義好)
問題:如何得知某個組件可配置的屬性?這個問題至關(guān)重要,如果我們掌握了規(guī)律,就可以舉一反三,所有組件的配置均可以靈活設(shè)定。授之以魚不如授之以漁。在本節(jié)會說明通用的方法。要得知組件的所有可定義屬性,按以下步驟進行:
1. 組件所使用的類是什么?(無論是核心組件還是自定義組件)
2. 組件類的公共成員變量都有哪些?(注意從父類繼承而來的公共成員變量)
3. 組件類都有哪些settter方法?(注意從父類繼承而來的方法)
明白了以上三個要點,我們就可以按規(guī)律定義組件的屬性,比如對最重要的db組件,我們發(fā)現(xiàn)這是一個核心組件,使用的類為CDbConnection, 我們查閱這個類的定義文件,發(fā)現(xiàn)這個類的公共成員變量有:
$connectionString;
- $username='';
- $password='';
- $autoConnect=true;
- $charset;
- $emulatePrepare;
- $tablePrefix;
- $initSQLs;
- ... ...
setter方法定義的屬性:
- setActive($value)
- setAttributes($values)
- setAutoCommit($value)
- setColumnCase($value)
- setNullConversion($value)
- setPersistent($value)
提示:setter方法定義的屬性名稱不區(qū)分大小寫以上所列的屬性,均可以在配置文件中指定,具體每個屬性的作用,請參閱Yii類文件的詳細注釋(Yii代碼的注釋也是相當棒,通俗易懂,而又很詳細)
再來一個例子,定義urlManager組件的屬性這個組件使用的類為CUrlManager, 我們查閱它的屬性:
- $rules=array();
- $urlSuffix='';
- $showScriptName=true;
- $appendParams=true;
- $routeVar='r';
- $caseSensitive=true;
通過setter方法定義的屬性:
- setUrlFormat($value)
- setBaseUrl($value)
即urlManager組件的上述屬性可以在配置文件中定義(每項配置的作用請參閱其注釋)。其它組件的配置均可按上述方法處理。
如何使用組件應(yīng)用程序運行后,會將所有已經(jīng)定義過的組件注冊(并未實例化)到CWebApplication對象上,同時CWebApplication應(yīng)用程序?qū)ο髸蛔缘結(jié)ii::$_app,在程序的任何位置均可通過Yii::app()得到當前應(yīng)用程序?qū)ο笠?,再通過$app對象得到組件實例引用,如:Yii::app()->getComponent('urlManager'); #會查找組件配置并實例化之Yii::app()->urlManager; #通過CModule::__get()魔術(shù)方法實現(xiàn)
如何自定義組件?這是很常見的需求,比如我們可能希望db組件(數(shù)據(jù)庫連接)使用我們自定義的類,也或者我們希望使用多個數(shù)據(jù)庫連接,這種情況下就需要自定義組件,使用多數(shù)據(jù)庫的例子:
components=>array( 'db' => array( ... ... ), 'mydb'=>array( 'class' => 'myDbConnection', 'connectionString' => 'mysql:host=localhost;dbname=test;charset=utf8', 'tablePrefix' => 'cdb_', 'username' => 'root', ), ), 修改默認的db組件所使用的類: components=>array( 'db' => array( 'class' => 'myDbConnection', ... ... ), ),
經(jīng)過本文的分析,我是深切理解了Yii組件化機制給應(yīng)用程序帶來的極大的擴展性,哈哈哈哈~
相關(guān)文章
PHP自定義函數(shù)實現(xiàn)assign()數(shù)組分配到模板及extract()變量分配到模板功能示例
這篇文章主要介紹了PHP自定義函數(shù)實現(xiàn)assign()數(shù)組分配到模板及extract()變量分配到模板功能,可模擬tp框架中模板變量分配功能,涉及php基于面向?qū)ο蟮臄?shù)組賦值相關(guān)操作技巧,需要的朋友可以參考下2018-05-05
PHP中經(jīng)緯度坐標相關(guān)計算方法小結(jié)
這篇文章主要為大家詳細介紹了PHP中經(jīng)緯度坐標相關(guān)計算方法的相關(guān)知識,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學習一下2024-04-04
微信公眾平臺開發(fā)教程④ ThinkPHP框架下微信支付功能圖文詳解
這篇文章主要介紹了微信公眾平臺開發(fā)ThinkPHP框架下微信支付功能,結(jié)合圖文形式詳細分析了基于thinkPHP框架的微信支付功能實現(xiàn)步驟、操作技巧與相關(guān)注意事項,需要的朋友可以參考下2019-04-04
PHP在innodb引擎下快速代建全文搜索功能簡明教程【基于xunsearch】
這篇文章主要介紹了PHP在innodb引擎下快速代建全文搜索功能的方法,可基于開源搜索引擎xunsearch實現(xiàn),簡明扼要的講述了安裝與使用的步驟與相關(guān)操作技巧,需要的朋友可以參考下2016-10-10
PHP建立MySQL與MySQLi持久化連接(長連接)區(qū)別
MySQL是一種流行的關(guān)系型數(shù)據(jù)庫,而PHP為其提供了兩種不同的API,即MySQL和MySQLi,在使用這兩個API時,我們可以選擇使用持久連接或非持久連接,MySQL的持久連接需使用`mysql_pconnect`,而MySQLi持久連接默認啟用,使用持久連接時應(yīng)注意服務(wù)器連接限制和資源占用問題2025-02-02

