Yii2 테마(테마) 사용법_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가 됨을 알 수 있습니다. /사이트/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, 이 파일이 존재하면 이 경로를 반환하고, 그렇지 않으면 계속해서 교체합니다.

모든 교체 결과에 해당 파일이 없으면 원래 경로가 반환됩니다.

여러 개의 교체 대상 값을 동시에 작성하면 테마 상속을 구현할 수 있다는 장점이 있습니다.

이제 기본 테마 세트가 있습니다. 지금 검은색 테마를 추가하려면 두 가지 방법이 있습니다.

첫 번째 방법: 기본적으로 모든 뷰를 빈 디렉터리에 복사합니다.

두 번째 옵션: 빈 디렉터리에 레이아웃 파일 하나만 복사한 후 레이아웃 파일의 전체 색상을 수정합니다. 그런 다음

으로 설정하세요.

$pathMap=[
    '@app/c' => [
        '@app/ccc/blank',
        '@app/ccc/default',
      ],
];

혜택이 보이시나요? 공백에 있는 파일이 없으면 기본적으로 검색됩니다. 즉, 공백에 있는 파일이 기본에 존재하는 파일을 덮어쓰게 되어 테마 상속이 실현됩니다.

테마 속성:

$pathMap: 대체 매핑 관계를 설정하는 데 사용됩니다.

'pathMap' =>[
    '@app/views' => [
        '@app/themes/blank',
        '@app/themes/default',
    ],
    '@app/modules' => '@app/themes/default/modules',
    '@app/widgets' => '@app/themes/default/widgets'
],

이 세 가지는 각각 뷰, 모듈, 위젯에 테마를 적용합니다.

$baseUrl: 액세스할 리소스의 URL을 설정하는 데 사용됩니다(끝에 "/" 없음).

$basePath: 리소스가 위치한 파일 디렉터리를 설정

테마 방식:

공용 함수 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]];
    }
}

공용 함수 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 개발 프레임워크 요약", "시작하기 위한 기본 튜토리얼"을 확인할 수 있습니다. with Smarty Templates", "php 객체지향 프로그래밍" 디자인 입문 튜토리얼", "php 문자열(문자열) 사용법 요약", "php mysql 데이터베이스 작업 입문 튜토리얼" 및 "php 공통 데이터베이스 작업 기술 요약"

이 기사가 Yii 프레임워크를 기반으로 하는 모든 사람의 PHP 프로그램 설계에 도움이 되기를 바랍니다.