Yii2主題(Theme)用法詳解
本文實(shí)例講述了Yii2主題(Theme)用法。分享給大家供大家參考,具體如下:
首先看看主要的配置方式:
'components' => [ 'view' => [ 'theme' => [ 'pathMap' => ['@app/views' => '@app/themes/basic'], 'baseUrl' => '@web/themes/basic', ], ], ],
Yii中的主題功能主要由yii\base\Theme類來實(shí)現(xiàn),它的主要思想是:先定義好一個(gè)一一對(duì)應(yīng)的字符串映射數(shù)組,然后對(duì)給定的字符串按照數(shù)組中的映射關(guān)系進(jìn)行字符串替換。
有如下映射:
$pathMap=[ '@app/a' => '@app/aaa', '@app/b' => '@app/bbb', '@app/c' => [ '@app/ccc/xxx', '@app/ccc/yyy', ], ];
對(duì)字符串 @app/a/site/index.php,由上面的映射關(guān)系可知會(huì)把@app/a替換為@app/aaa,生成結(jié)果為@app/aaa/site/index.php。
但要注意,這個(gè)還不是最終的結(jié)果。由于在Yii中是對(duì)文件路徑的操作,所以如果@app/aaa/site/index.php這個(gè)文件存在的話,則會(huì)返回這個(gè)路徑,否則返回原路徑即:@app/a/site/index.php
如果有字符串@app/c/site/index.php,由于上面的映射知道@app/c對(duì)應(yīng)2個(gè)替換項(xiàng),Yii會(huì)從前開始依次替換,先生成@app/ccc/xxx/site/index.php,如果這個(gè)文件存在,則返回這個(gè)路徑,否則繼續(xù)替換。
如果所有的替換結(jié)果都不存在對(duì)應(yīng)的文件,那么最后返回原路徑。
同時(shí)寫多個(gè)替換的目標(biāo)值有這么一個(gè)好處:實(shí)現(xiàn)主題的繼承。
現(xiàn)在有一套默認(rèn)的主題default,如果現(xiàn)在要增加一套黑色的主題,有兩個(gè)辦法可以實(shí)現(xiàn)。
第一種:把所有的default中的視圖全部復(fù)制一份到blank目錄中。
第二種:只復(fù)制一份layout布局文件到blank目錄中,然后在布局文件中修改整體顏色。然后設(shè)置為
$pathMap=[ '@app/c' => [ '@app/ccc/blank', '@app/ccc/default', ], ];
好處看到了吧,如果在blank中沒有找到文件,會(huì)從default中來查找,也就是說blank中的文件會(huì)覆蓋default中存在的文件,從而實(shí)現(xiàn)了主題的繼承。
主題中的屬性:
$pathMap:這個(gè)就是用來設(shè)置替換映射關(guān)系的。
'pathMap' =>[ '@app/views' => [ '@app/themes/blank', '@app/themes/default', ], '@app/modules' => '@app/themes/default/modules', '@app/widgets' => '@app/themes/default/widgets' ],
這三個(gè)分別對(duì)views、modules和widgets應(yīng)用主題。
$baseUrl:這個(gè)用來設(shè)置要訪問的資源的url(結(jié)尾不加“/”)
$basePath:設(shè)置資源所在的文件目錄
主題中的方法:
public function init()
public function init() { parent::init(); //如果沒有設(shè)置$pathMap映射,則使用$basePath, if (empty($this->pathMap)) { /* * 如果$basePath也沒有設(shè)置,則出異常。 * 也就是說 $pathMap和$basePath至少要設(shè)置一個(gè),如果兩個(gè)都設(shè)置了,優(yōu)先使用$pathMap */ if (($basePath = $this->getBasePath()) === null) { throw new InvalidConfigException('The "basePath" property must be set.'); } //設(shè)置當(dāng)前模塊的路徑和$basePath的映射關(guān)系 $this->pathMap = [Yii::$app->getBasePath() => [$basePath]]; } }
public function applyTo($path)
//這個(gè)就是按照 $pathMap中的定義的映射關(guān)系來對(duì)$path進(jìn)行替換字符串的 public function applyTo($path) { //對(duì)路徑中的"/"、“\”進(jìn)行統(tǒng)一替換 $path = FileHelper::normalizePath($path); foreach ($this->pathMap as $from => $tos) { //映射數(shù)組中的來源(舊值) $from = FileHelper::normalizePath(Yii::getAlias($from)) . DIRECTORY_SEPARATOR; //如果在$path中有可替換的舊值 if (strpos($path, $from) === 0) { $n = strlen($from); //對(duì)目標(biāo)值循環(huán), foreach ((array) $tos as $to) { $to = FileHelper::normalizePath(Yii::getAlias($to)) . DIRECTORY_SEPARATOR; //把$path中的$from替換為$to $file = $to . substr($path, $n); //如果是文件,直接返回 if (is_file($file)) { return $file; } } } } return $path; }
更多關(guān)于Yii相關(guān)內(nèi)容感興趣的讀者可查看本站專題:《Yii框架入門及常用技巧總結(jié)》、《php優(yōu)秀開發(fā)框架總結(jié)》、《smarty模板入門基礎(chǔ)教程》、《php面向?qū)ο蟪绦蛟O(shè)計(jì)入門教程》、《php字符串(string)用法總結(jié)》、《php+mysql數(shù)據(jù)庫(kù)操作入門教程》及《php常見數(shù)據(jù)庫(kù)操作技巧匯總》
希望本文所述對(duì)大家基于Yii框架的PHP程序設(shè)計(jì)有所幫助。
- Yii2創(chuàng)建控制器(createController)方法詳解
- Yii2創(chuàng)建表單(ActiveForm)方法詳解
- yii2.0實(shí)現(xiàn)創(chuàng)建簡(jiǎn)單widgets示例
- yii2.0數(shù)據(jù)庫(kù)遷移教程【多個(gè)數(shù)據(jù)庫(kù)同時(shí)同步數(shù)據(jù)】
- yii2高級(jí)應(yīng)用之自定義組件實(shí)現(xiàn)全局使用圖片上傳功能的方法
- Yii2針對(duì)游客、用戶防范規(guī)則和限制的解決方法分析
- Yii2框架實(shí)現(xiàn)注冊(cè)和登錄教程
- yii2.0之GridView自定義按鈕和鏈接用法
- Yii2搭建后臺(tái)并實(shí)現(xiàn)rbac權(quán)限控制完整實(shí)例教程
- Yii2.0高級(jí)框架數(shù)據(jù)庫(kù)增刪改查的一些操作
- Yii2創(chuàng)建多界面主題(Theme)的方法
相關(guān)文章
laravel5.4利用163郵箱發(fā)送郵件的步驟詳解
發(fā)送郵件是我們?nèi)粘T陂_發(fā)中必不可少會(huì)遇到的一個(gè)需求,下面這篇文章主要給大家介紹了關(guān)于laravel5.4利用163郵箱發(fā)送郵件的步驟,文中通過示例代碼和圖片介紹的非常詳細(xì),需要的朋友可以參考下。2017-09-09Laravel認(rèn)證原理以及完全自定義認(rèn)證詳解
最近在學(xué)習(xí)laravel框架,所以下面這篇文章主要給大家介紹了關(guān)于Laravel認(rèn)證原理以及完全自定義認(rèn)證的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),需要的朋友可以參考借鑒,下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2018-07-07PHP遞歸獲取目錄內(nèi)所有文件的實(shí)現(xiàn)方法
下面小編就為大家?guī)硪黄狿HP遞歸獲取目錄內(nèi)所有文件的實(shí)現(xiàn)方法。小編覺得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2016-11-11

PHP獲取當(dāng)前日期和時(shí)間及格式化方法參數(shù)

php while循環(huán)控制的簡(jiǎn)單實(shí)例