包简介

Blade template engine support

README 文档

README

This package provides Laravel Blade template engine support for the Yii3 framework.

Requirements

PHP 8.2+
Yii3
Composer 2.5+

Installation

composer require lee-to/yii-blade

Or install via local path repository:

"repositories": [
    {
        "type": "path",
        "url": "packages/yii-blade",
        "options": {
            "versions": {
                "lee-to/yii-blade": "1.x-dev"
            },
            "symlink": true
        }
    }
]

Configuration

Configure the package in your config/params.php:

return [
    'lee-to/yii-blade' => [
        'paths' => [
            'default' => '@views',
            'admin' => '@views/admin',
        ],
        'cachePath' => 'runtime/cache/blade/views',
        'componentNamespaces' => [
            'App\\View\\Components' => 'x',
        ],
        'anonymousComponentNamespaces' => [
            '@views/components' => 'x',
        ],
        'directives' => [
            // App\Blade\Directives\MyDirective::class,
        ],
    ],
];

Usage

Create a Blade template in your views directory:

{{-- views/hello.blade.php --}}
<h1>Hello, {{ $name }}!</h1>

@if($showGreeting)
    <p>Welcome to Yii3 with Blade!</p>
@endif

The package automatically registers as a renderer for .blade.php files.

Layout

Create a layout template:

{{-- views/layouts/main.blade.php --}}
<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>@yield('title', 'My application')</title>
</head>
<body>
    <header>
        <nav>
            <a href="/">Home</a>
        </nav>
    </header>

    <main>
        @yield('content')
    </main>
</body>
</html>

Use it from a page template:

{{-- views/site/index.blade.php --}}
@extends('layouts.main')

@section('title', 'Home')

@section('content')
    <h1>Hello, {{ $name }}!</h1>
@endsection

Custom Directives

Create a custom directive by implementing DirectiveInterface:

<?php

namespace App\Blade\Directives;

use Closure;
use Leeto\YiiBlade\DirectiveInterface;
use Leeto\YiiBlade\DirectiveType;

final class DateTimeDirective implements DirectiveInterface
{
    public function getType(): DirectiveType
    {
        return DirectiveType::DEFAULT;
    }

    public function getName(): string
    {
        return 'datetime';
    }

    public function handler(): Closure
    {
        return fn(?string $expression): string => "<?php echo date('Y-m-d H:i:s', $expression); ?>";
    }
}

Register it in params:

'directives' => [
    App\Blade\Directives\DateTimeDirective::class,
],

Use in templates:

@datetime(time())

Directive Types

DirectiveType::DEFAULT - Standard directive (@name($expression))
DirectiveType::IF - Conditional directive (@name($condition) ... @endname)
DirectiveType::STRINGABLE - Stringable handler for custom object rendering

Features

Full Blade syntax support
Components and slots
Custom directives
Anonymous components
Template inheritance (@extends, @section, @yield)
Includes (@include, @each)
Conditionals (@if, @unless, @isset, @empty)
Loops (@foreach, @for, @while, @forelse)
And more...

License

MIT

lee-to/yii-blade 适用场景与选型建议

lee-to/yii-blade 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 5 次下载、GitHub Stars 达 3，最近一次更新时间为 2026 年 01 月 26 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「yii」「blade」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 lee-to/yii-blade 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 lee-to/yii-blade 我们能提供哪些服务？

定制开发 / 二次开发

基于 lee-to/yii-blade 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 lee-to/yii-blade 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

slavkovrn/yii2-lightbox 1

Yii2 LightBox image galary widget uses Lightbox v2.10.0 by Lokesh Dhakar

skeeks/cms-user-personal-area 0

Priveate for SkeekS CMS

kongoon/yii2-c3js-chart 0

C3JS Chart for Yii Framework 2.0

rikcage/yii2-sceditor 0

SCEditor, a lightweight WYSIWYG BBCode & HTML editor extension for Yii 2.0 Framework

slavkovrn/yii2-prettyphoto 4

Yii2 prettyPhoto image galary widget uses Lightbox view control jquery.prettyphoto.js

slavkovrn/yii2-dynatreemenu 3

Yii2 DynaTree Menu widget uses Dynamic tree view control jquery.dynatree.js

lee-to/yii-blade

包简介

关键字：