Yii2主題(Theme)用法詳解_php實例

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

先看看主要的設定方式：

'components' => [
  'view' => [
    'theme' => [
      'pathMap' => ['@app/views' => '@app/themes/basic'],
      'baseUrl' => '@web/themes/basic',
    ],
  ],
],

Yii中的主題功能主要由yiibaseTheme類別來實現，它的主要思想是：先定義好一個一一對應的字串映射數組，然後對給定的字串按照數組中的映射關係進行字串替換。

有如下映射：

$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，如果這個檔案存在，則返回這個路徑，否則繼續替換。

如果所有的替換結果都不存在對應的文件，那麼最後回到原路徑。

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

現在有一套預設的主題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()

public function init()
{
    parent::init();
    //如果没有设置$pathMap映射，则使用$basePath，
    if (empty($this->pathMap)) {
        /*
         * 如果$basePath也没有设置，则出异常。
         * 也就是说 $pathMap和$basePath至少要设置一个，如果两个都设置了，优先使用$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)
{
    //对路径中的"/"、“\”进行统一替换
    $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);
        //对目标值循环，
        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相關內容有興趣的讀者可查看本站專題：《Yii框架入門及常用技巧總結》、《php優秀開發框架總結》、《smarty模板入門基礎教程》、《php物件導向程式設計入門教程》、《php字串(string)用法總結》、《php+mysql資料庫操作入門教學》及《php常見資料庫操作技巧總表》

希望本文所述對大家以Yii架構為基礎的PHP程式設計有所幫助。