PHPackages                             strong/bitrix-blade - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. strong/bitrix-blade

ActiveLibrary[Templating & Views](/categories/templating)

strong/bitrix-blade
===================

0.8.2(3y ago)087MITPHPPHP >=8.1

Since Apr 12Pushed 3y agoCompare

[ Source](https://github.com/Strong/bitrix-blade)[ Packagist](https://packagist.org/packages/strong/bitrix-blade)[ Docs](https://github.com/Strong/bitrix-blade)[ RSS](/packages/strong-bitrix-blade/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/cbb15fbd71485bfce25d267e92ebae003dc905e029f5be7e6bc557664f2153c2/68747470733a2f2f706f7365722e707567782e6f72672f617272696c6f742f6269747269782d626c6164652f762f737461626c652e737667)](https://packagist.org/packages/arrilot/bitrix-blade/)[![Total Downloads](https://camo.githubusercontent.com/36a429d61038b839f24c3b96c153f8b1ed93842a9cdf6e7a8cfe53170d5f21af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617272696c6f742f6269747269782d626c6164652e7376673f7374796c653d666c6174)](https://packagist.org/packages/Arrilot/bitrix-blade)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/502a50294337c163927f7157d7451541c36e45e22b0280eda2a2048c1e5381c0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f617272696c6f742f6269747269782d626c6164652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/arrilot/bitrix-blade/)

Bitrix Blade - интеграция шаблонизатора Blade в Битрикс
=======================================================

[](#bitrix-blade---интеграция-шаблонизатора-blade-в-битрикс)

Установка
---------

[](#установка)

1)`composer require strong/bitrix-blade`

2. добавляем в init.php

```
use Arrilot\BitrixBlade\BladeProvider;

require $_SERVER['DOCUMENT_ROOT']."/vendor/autoload.php";

BladeProvider::register();
```

Использование
-------------

[](#использование)

Заменяем шаблон компонента с `template.php` на `template.blade` и можно писать на `Blade`

Директива `@include('path.to.view')` модифицирована следующим образом:

1. Сначала view ищется относительно директории текущего шаблона компонента (там где лежит template.blade)
2. Если не view там не нашёлся, то он ищется относительно базовой директории (по умолчанию `local/views`, но может быть указана другая при вызове `BladeProvider::register()`)

Пользовательские директивы (custom directives)
----------------------------------------------

[](#пользовательские-директивы-custom-directives)

Для того чтобы добавить свою директиву, необходимо зарегистрировать её в компиляторе:

```
$compiler = BladeProvider::getCompiler();
$compiler->directive('directiveName', function ($expression) {
    return '...';
});

```

При установке пакета `BladeProvider::register()` за вас уже автоматически зарегистрировано некоторое количество полезных директив:

1. `@bxComponent` - аналог `$APPLICATION->IncludeComponent()`
2. `@block('key')` и `@endblock` - всё что заключено между ними будет выведено в месте, где вызван метод `$APPLICATION->ShowViewContent('key')`
3. `@lang('key')` - равносильно `{!! Bitrix\Main\Localization\Loc::getMessage('key') !!} `
4. `@auth` и `@endauth` - сокращенная запись ` ... `
5. `@guest` и `@endguest` - аналогично, но проверка на неавторизованного юзера.
6. `@admin` и `@endadmin` - аналогично, но `$USER->IsAdmin()`
7. `@csrf` - сокращенная форма для ``
8. [Директивы по работе с эрмитажем](docs/hermitage.md)

Конфигурация
------------

[](#конфигурация)

При необходимости пути можно поменять в конфигурации. .settings\_extra.php

```
    'bitrix-blade' => [
        'value'    => [
            'baseViewPath' => '/absolute/path/or/path/from/document/root', // по умолчанию 'local/views'
            'cachePath' => '/absolute/path/or/path/from/document/root', // по умолчанию 'local/cache/blade'
        ],
        'readonly' => false,
    ],
```

Очистка кэша
------------

[](#очистка-кэша)

Для обеспечения высокой скорости работы Blade кэширует скомпилированные шаблоны в php файлы. В большинстве случаев чистить этот кэш самостоятельно потребности нет, потому что блейд сверяет время модификации файлов шаблонов и кэша и самостоятеьно инвалидирует этот кэш. Однако в некоторых случаях (например при добавлении новой пользовательской директивы), этот кэш всё-же надо сбросить. Делается это методом `BladeProvider::clearCache()`

Некоторые моменты
-----------------

[](#некоторые-моменты)

1. Битрикс позволяет использовать сторонние шаблонизаторы только в шаблонах компонентов. Шаблоны сайтов только на php.
2. По понятным причинам наследованием шаблонов в полную силу воспользоваться не получится.
3. Традиционное расширение `.blade.php` использовать нельзя. Битрикс видя `.php` включает php движок.
4. Вместо `$this` в шаблоне следует использовать `$template` - например `$template->setFrameMode(true);`
5. Проверку `` прописывать в blade-шаблоне не нужно, она добавляется в скомпилированные view автоматически. Также вместе с этим выполняется и `extract($arResult, EXTR_SKIP);`
6. Чтобы языковой файл из шаблона подключился, его (этот языковой файл) надо назвать как обычно - `template.php`

Дополнительно
-------------

[](#дополнительно)

PhpStorm

1. Чтобы включить подсветку синтаксиса в PhpStorm для .blade файлов нужно добавить это расширение в `Settings->Editor->File Types->Blade`
2. Чтобы PhpStorm понимал и подсвечивалл должным образом пользовательские директивы из этого пакета их можно добавить в него. Делается это в `Settings->Language & Frameworks->PHP->Blade->Directives`

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

2

Last Release

1129d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/af1fd7eda184275dd68973a215331857bdfce14cbca299dd47007ba5cf391712?d=identicon)[Evgeny Kovalev](/maintainers/Evgeny%20Kovalev)

---

Top Contributors

[![arrilot](https://avatars.githubusercontent.com/u/2826480?v=4)](https://github.com/arrilot "arrilot (25 commits)")[![Strong](https://avatars.githubusercontent.com/u/325767?v=4)](https://github.com/Strong "Strong (4 commits)")[![Ge1i0N](https://avatars.githubusercontent.com/u/6265043?v=4)](https://github.com/Ge1i0N "Ge1i0N (2 commits)")

---

Tags

bitrixblade

### Embed Badge

![Health badge](/badges/strong-bitrix-blade/health.svg)

```
[![Health](https://phpackages.com/badges/strong-bitrix-blade/health.svg)](https://phpackages.com/packages/strong-bitrix-blade)
```

###  Alternatives

[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.2k438.5k29](/packages/tightenco-jigsaw)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[philo/laravel-blade

Use the simple and yet powerful Laravel Blade templating engine as a standalone component.

354673.2k59](/packages/philo-laravel-blade)[spatie/laravel-blade-comments

Add debug comments to your rendered output

177325.5k](/packages/spatie-laravel-blade-comments)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)