Download the PHP package strong/bitrix-blade without Composer
On this page you can find all versions of the php package strong/bitrix-blade. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package bitrix-blade
Bitrix Blade - интеграция шаблонизатора Blade в Битрикс
Установка
1)
2) добавляем в init.php
Использование
Заменяем шаблон компонента с template.php
на template.blade
и можно писать на Blade
Директива @include('path.to.view')
модифицирована следующим образом:
- Сначала view ищется относительно директории текущего шаблона компонента (там где лежит template.blade)
- Если не view там не нашёлся, то он ищется относительно базовой директории (по умолчанию
local/views
, но может быть указана другая при вызовеBladeProvider::register()
)
Пользовательские директивы (custom directives)
Для того чтобы добавить свою директиву, необходимо зарегистрировать её в компиляторе:
При установке пакета BladeProvider::register()
за вас уже автоматически зарегистрировано некоторое количество полезных директив:
-
- аналог
- и - всё что заключено между ними будет выведено в месте, где вызван метод
-
- равносильно
- и - сокращенная запись
...
- и - аналогично, но проверка на неавторизованного юзера.
- и - аналогично, но
$USER->IsAdmin()
-
- сокращенная форма для
- Директивы по работе с эрмитажем
Конфигурация
При необходимости пути можно поменять в конфигурации. .settings_extra.php
Очистка кэша
Для обеспечения высокой скорости работы Blade кэширует скомпилированные шаблоны в php файлы. В большинстве случаев чистить этот кэш самостоятельно потребности нет, потому что блейд сверяет время модификации файлов шаблонов и кэша и самостоятеьно инвалидирует этот кэш. Однако в некоторых случаях (например при добавлении новой пользовательской директивы), этот кэш всё-же надо сбросить. Делается это методом
Некоторые моменты
- Битрикс позволяет использовать сторонние шаблонизаторы только в шаблонах компонентов. Шаблоны сайтов только на php.
- По понятным причинам наследованием шаблонов в полную силу воспользоваться не получится.
- Традиционное расширение
.blade.php
использовать нельзя. Битрикс видя.php
включает php движок. - Вместо
$this
в шаблоне следует использовать$template
- например$template->setFrameMode(true);
- Проверку
<?if(!defined("B_PROLOG_INCLUDED")||B_PROLOG_INCLUDED!==true) die();?>
прописывать в blade-шаблоне не нужно, она добавляется в скомпилированные view автоматически. Также вместе с этим выполняется и - Чтобы языковой файл из шаблона подключился, его (этот языковой файл) надо назвать как обычно -
template.php
Дополнительно
PhpStorm
- Чтобы включить подсветку синтаксиса в PhpStorm для .blade файлов нужно добавить это расширение в
Settings->Editor->File Types->Blade
- Чтобы PhpStorm понимал и подсвечивалл должным образом пользовательские директивы из этого пакета их можно добавить в него. Делается это в
Settings->Language & Frameworks->PHP->Blade->Directives
All versions of bitrix-blade with dependencies
illuminate/container Version 8.*
illuminate/view Version 8.*
illuminate/events Version 8.*