В коде фреймверка Yii 2 захардкожено название шаблона (layout), который используется по-умолчанию при рендеринге страницы сайта. Шаблон по-умолчанию называется main, и он располагается в файле /views/layouts/main.php.

Чтобы изменить шаблон (имеется в виду чтобы задать другой файл шаблона), в конфигурации предусмотрена настроечная переменная layout. По-умолчанию она в конфигурации не прописана, но ее всегда можно добавить. Для этого нужно в переменную $config файла /config/web.php добавить строку:

$config = [

...

'layout'=>'bestTemplate',

...

];

После чего при рендеринге видов будет использоваться именно этот шаблон.

Вышеописанным способом задается шаблон по-умолчанию для всего сайта. А что делать, если для какого-то контроллера необходим отдельный шаблон? Для этого у класса контроллера есть специальное свойство $layout. Его нужно просто задать в спике инициализации контроллера или в конструкторе.

class PostController extends Controller

{

public $layout = 'post';

// ...

}

А если это необходимо, это свойство можно задать даже перед непосредственным вызовом рендеринга вида.

В общем случае, Yii определяет какой шаблон использовать для контроллера в два этапа.

На первом этапе определяется значение шаблона и контекстный модуль:

• Если $layout-свойство контроллера отлично от null, используется оно, и модуль контроллера как контекстный модуль.
• Если $layout не задано (т. е. равно null), происходит поиск среди родительских модулей контроллера, включая само приложение (которое по умолчанию является родительским модулем для контроллеров, не принадлежащих модулям) и находится первый модуль, свойство $layout которого не равно null. Тогда используется найденное значение $layout этого модуля и сам модуль в качестве контекста. Если такой модуль не найден, значит шаблон применен не будет.

На втором этапе определяется сам файл шаблона для рендеринга на основании значения $layout и контекстного модуля. Значением $layout может быть:

• Алиас пути (например, @app/views/layouts/main).
• Абсолютный путь (например /main): значение $layout начинается со слеша. Будет искаться шаблон из yii\base\Application::layoutPath приложения, по умолчанию это @app/views/layouts.
• Относительный путь (например, main): Будет искаться шаблон из yii\base\Module::layoutPath, по умолчанию это views/layouts в yii\base\Module::basePath.
• Булево значение false: шаблон не будет применен.

Если у значения $layout (а это, как уже понятно, просто строка с названием нужного шаблона) нет расширения, будет использовано расширение по умолчанию - .php.