[扩展推荐] 让增添 Laravel Blade 语法变得更简单

我开发了一个 Blade 扩展包 ，允许你轻松地在服务容器中注册 Laravel Blade 语法扩展类。并且自带了了 php artisan make:blade 命令来方便你创建新的 Blade 扩展类（自动注册包 ^_^）。

这个想法并不是很革命性的，但我喜欢的是它组织 Blade 扩展到服务容器类中的方法。

例如，假设您在使用购物车时有一些自定义指令。下面是一个关于如何使用我的 Blade 扩展包的简单示例：

<?php

namespace App\Blade;

use BitPress\BladeExtension\Contracts\BladeExtension;

class CartExtension implements BladeExtension
{
    public function getDirectives()
    {
        return [
            'cartcount' => [$this, 'getCartCount']
        ];
    }

    public function getConditionals()
    {
        return [
            'cartempty' => [$this, 'isCartEmpty']
        ];
    }

    public function getCartCount()
    {
        // 返回购物车计数的逻辑
    }

    public function isCartEmpty()
    {
        // 空购物车的逻辑
    }
}

上述的扩展将在 Blade 中提供以下指令：

{{-- 条件 --}}
@cartempty
  <p>购物车是空的</p>
@else
  <p>购物车不为空</p>
@endcartempty

{{-- 指令 --}}
<span class="count">@cartcount</span>

这并没有什么特别的 --- 它仅仅是在 PHP 中可以调用罢了 --- 但是我喜欢这种做法 —— 将这些相关的扩展放到一个文件中，并且可以从注入服务中受益的专用类（例如：一个购物车服务）。

如果我需要为购物车添加额外的指令，我只需要修改 getdirectives() 方法并定义相关的可调用的方法。

你可能会比较感兴趣：这个包的服务提供者是怎样挂载到 Blade 编译器中的？其实很简单：只需要在 boot() 方法中获取所有的有关  blade.extension 的服务标签在编译器中注册为指令即可。

// In the BladeExtensionServiceProvider::boot() method
foreach ($this->app->tagged('blade.extension') as $extension) {
    if (! $extension instanceof BladeExtension) {
        throw new InvalidBladeExtension($extension);
    }

    foreach ($extension->getDirectives() as $name => $callable) {
        $this->app['blade.compiler']->directive($name, $callable);
    }

    foreach ($extension->getConditionals() as $name => $callable) {
        $this->app['blade.compiler']->if($name, $callable);
    }
}

Blade Extensions 包可以很容易地创建并注册 Blade 扩展到服务容易中：

php artisan make:blade Cart

下面就是使用包提供的 BladeRegistrar 方法来注册扩展服务：

use App\Blade\CartExtension;
use BitPress\BladeExtension\Container\BladeRegistrar;

// ...

BladeRegistrar::register(CartExtension::class, function () {
    return new CartExtension();
});

如果你喜欢，你也可以使用提供的辅助方法：

blade_extension(CartExtension::class, function () {
    return new CartExtension();
});

基本上这就是 BladeRegistrar 为你做的：

$this->app->singleton(CartExtension::class);
$this->app->tag(CartExtension::class, 'blade.extension');

更多

这个包的灵感来源于 Twig extensions 创建和注册 Symfony 项目的方式。

如要开始，请到 GitHub 去查看在 Laravel 中创建 Blade 扩展的完整安装说明和工作流程。

你也可以通过下面命令安装 Blade 扩展包：

composer install bitpress/blade-extensions

本文中的所有译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们。

原文地址：https://laravel-news.com/laravel-blade-e...

译文地址：https://learnku.com/laravel/t/8016/exten...