Yii2主題(Theme)用法詳解
來源:易賢網 閱讀:1487 次 日期:2016-08-11 14:11:07
溫馨提示:易賢網小編為您整理了“Yii2主題(Theme)用法詳解”,方便廣大網友查閱!

本文實例講述了Yii2主題(Theme)用法。分享給大家供大家參考,具體如下:

首先看看主要的配置方式:

'components' => [

  'view' => [

    'theme' => [

      'pathMap' => ['@app/views' => '@app/themes/basic'],

      'baseUrl' => '@web/themes/basic',

    ],

  ],

],

Yii中的主題功能主要由yii\base\Theme類來實現,它的主要思想是:先定義好一個一一對應的字符串映射數組,然后對給定的字符串按照數組中的映射關系進行字符串替換。

有如下映射:

$pathMap=[

    '@app/a' => '@app/aaa',

    '@app/b' => '@app/bbb',

    '@app/c' => [

        '@app/ccc/xxx',

        '@app/ccc/yyy',

      ],

];

對字符串 @app/a/site/index.php,由上面的映射關系可知會把@app/a替換為@app/aaa,生成結果為@app/aaa/site/index.php。

但要注意,這個還不是最終的結果。由于在Yii中是對文件路徑的操作,所以如果@app/aaa/site/index.php這個文件存在的話,則會返回這個路徑,否則返回原路徑即:@app/a/site/index.php

如果有字符串@app/c/site/index.php,由于上面的映射知道@app/c對應2個替換項,Yii會從前開始依次替換,先生成@app/ccc/xxx/site/index.php,如果這個文件存在,則返回這個路徑,否則繼續(xù)替換。

如果所有的替換結果都不存在對應的文件,那么最后返回原路徑。

同時寫多個替換的目標值有這么一個好處:實現主題的繼承。

現在有一套默認的主題default,如果現在要增加一套黑色的主題,有兩個辦法可以實現。

第一種:把所有的default中的視圖全部復制一份到blank目錄中。

第二種:只復制一份layout布局文件到blank目錄中,然后在布局文件中修改整體顏色。然后設置為:

$pathMap=[

    '@app/c' => [

        '@app/ccc/blank',

        '@app/ccc/default',

      ],

];

好處看到了吧,如果在blank中沒有找到文件,會從default中來查找,也就是說blank中的文件會覆蓋default中存在的文件,從而實現了主題的繼承。

主題中的屬性:

$pathMap:這個就是用來設置替換映射關系的。

'pathMap' =>[

    '@app/views' => [

        '@app/themes/blank',

        '@app/themes/default',

    ],

    '@app/modules' => '@app/themes/default/modules',

    '@app/widgets' => '@app/themes/default/widgets'

],

這三個分別對views、modules和widgets應用主題。

$baseUrl:這個用來設置要訪問的資源的url(結尾不加“/”)

$basePath:設置資源所在的文件目錄

主題中的方法:

public function init()

{

    parent::init();

    //如果沒有設置$pathMap映射,則使用$basePath,

    if (empty($this->pathMap)) {

        /*

         * 如果$basePath也沒有設置,則出異常。

         * 也就是說 $pathMap和$basePath至少要設置一個,如果兩個都設置了,優(yōu)先使用$pathMap

         */

      if (($basePath = $this->getBasePath()) === null) {

        throw new InvalidConfigException('The "basePath" property must be set.');

      }

      //設置當前模塊的路徑和$basePath的映射關系

      $this->pathMap = [Yii::$app->getBasePath() => [$basePath]];

    }

}

public function applyTo($path)

//這個就是按照 $pathMap中的定義的映射關系來對$path進行替換字符串的

public function applyTo($path)

{

    //對路徑中的"/"、“\”進行統(tǒng)一替換

    $path = FileHelper::normalizePath($path);

    foreach ($this->pathMap as $from => $tos) {

       //映射數組中的來源(舊值)

      $from = FileHelper::normalizePath(Yii::getAlias($from)) . DIRECTORY_SEPARATOR;

      //如果在$path中有可替換的舊值

      if (strpos($path, $from) === 0) {

        $n = strlen($from);

        //對目標值循環(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;

}

希望本文所述對大家基于Yii框架的PHP程序設計有所幫助。

更多信息請查看網絡編程
易賢網手機網站地址:Yii2主題(Theme)用法詳解

2025國考·省考課程試聽報名

  • 報班類型
  • 姓名
  • 手機號
  • 驗證碼
關于我們 | 聯(lián)系我們 | 人才招聘 | 網站聲明 | 網站幫助 | 非正式的簡要咨詢 | 簡要咨詢須知 | 新媒體/短視頻平臺 | 手機站點 | 投訴建議
工業(yè)和信息化部備案號:滇ICP備2023014141號-1 云南省教育廳備案號:云教ICP備0901021 滇公網安備53010202001879號 人力資源服務許可證:(云)人服證字(2023)第0102001523號
聯(lián)系電話:0871-65099533/13759567129 獲取招聘考試信息及咨詢關注公眾號:hfpxwx
咨詢QQ:1093837350(9:00—18:00)版權所有:易賢網