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

翻译 Summer ⋅ 于 6个月前 ⋅ 最后回复由 蜗牛 1周前 ⋅ 1806 阅读 ⋅ 原文地址

站点的翻译文章创建时,您将第一时间收到通知。

这是一篇社区协同翻译的文章,已完成翻译,更多信息请点击 协同翻译介绍

file

我开发了一个 Blade 扩展包 ,它允许你在服务容器中注册自己的 Blade 扩展类,并自动向 Blade 编译器注册你的扩展类。你也可以使用提供的 Artisan 命令 php artisan make:blade 轻松的创建新的 Blade 扩展类(自动注册包命令 FTW)。

这个概念在任何方面都不是革命性的,不过我喜欢的是「它将我特定项目的 Blade 扩展 组织到服务容器类中的方式」。

蜗牛 翻译于 6个月前

查看其他 1 个版本

例如,假设您在使用购物车时有一些自定义指令。下面是一个关于如何使用我的 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 中可以调用罢了 --- 但是我喜欢这种做法 —— 将这些相关的扩展放到一个文件中,并且可以从注入服务中受益的专用类(例如:一个购物车服务)。

科大大 翻译于 6个月前

如果我需要为购物车添加额外的指令,我只需要修改 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);
    }
}
科大大 翻译于 6个月前

Blade 扩展包使在服务容器中创建和注册 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');
蜗牛 翻译于 6个月前

查看其他 1 个版本

更多

科大大 翻译于 6个月前

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

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

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

composer install bitpress/blade-extensions
科大大 翻译于 6个月前

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

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


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

本帖已被设为精华帖!
回复数量: 6
  • 这篇翻译的不太好,如果有看得不太懂的地方可以看看原文的翻译哈,会更好理解

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

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

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

    6个月前
  • Summer 站长 @ laravel-china.org

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

    6个月前 1
  • @Summer 明白了

    6个月前
您需要登陆以后才能留下评论!

Composer 中国全量镜像

Top 250 扩展包

Lumen 中文文档

Laravel 速查表

Laravel 中文文档

Laravel 项目开发规范

Laravel 开发环境部署

Composer 中文文档

Elasticsearch-PHP 中文文档

Lumen 中文文档

GraphQL PHP 中文文档

社区文档撰写指南

TDD 构建 Laravel 论坛笔记

PHP PSR 标准规范

PHP 设计模式全集

Dingo API 中文文档