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

file

我开发了一个 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

Practice makes perfect.

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

译文地址:https://laravel-china.org/topics/8016/ex...

本帖已被设为精华帖!
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 6

这篇翻译的不太好,如果有看得不太懂的地方可以看看原文的翻译哈,会更好理解

10个月前

@科大大 怎么看原文呢?是点击重译后,再自己看原文吗?

10个月前

@蜗牛 可以点纠错,看到译文和原文的,方便理解

10个月前

@Summer 我在 开源中国 上看到有些翻译就是分段翻译,保留原文和翻译文章,所以才没有去掉原文的。可以参考 这篇文章

10个月前
Summer

@蜗牛 翻译后的文章,理想情况下,应该是一篇完美的文章。可以将其想象为一个作品,不完善的地方,我们可以优化、打磨、改进,这样会变得越来越趋向完美。但是留着原文的话,有很强的违和感,在我看来就变成一份残次品了。

10个月前

@Summer 明白了

10个月前

  • 请注意单词拼写,以及中英文排版,参考此页
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`, 更多语法请见这里 Markdown 语法
  • 支持表情,使用方法请见 Emoji 自动补全来咯,可用的 Emoji 请见 :metal: :point_right: Emoji 列表 :star: :sparkles:
  • 上传图片, 支持拖拽和剪切板黏贴上传, 格式限制 - jpg, png, gif
  • 发布框支持本地存储功能,会在内容变更时保存,「提交」按钮点击时清空
  请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!