[扩展推荐] Eventy: 在 Laravel 应用添加类似 WordPress 的钩子机制
23

file

Eventy 是 Tor Morten Jensen 为 Laravel 开发的一个类 WordPress 钩子机制的扩展包。

这个扩展包有着轻量级的 API,能够帮助你快速的构建一个和 WordPress 一致的钩子机制。WordPress 钩子机制是一种不需要修改模板就能定制 WordPress 主题的强大方式。例如,你的用户可以轻松的修改 <title></title> 标签(使用 wp_title)的内容,而不需要修改模板。

操作

操作即在你所希望的地方可以执行的既定代码。

如下就是创建操作的一些基础 API:

Eventy::action('my.hook', 'awesome');

添加操作监听者的最佳位置就是服务提供者中的 boot() 方法:

public function boot()
{
    Eventy::addAction('my.hook', function($what) {
        echo 'You are '. $what;
    }, 20, 1);
}

Eventy::addAction()方法接收参数依次为,操作名称,回调函数,优先级,预期的变量数量。优先级数字越小,执行越早。

过滤器

就像 WordPress 的过滤器一样,Eventy 库提供了一个过滤器来修改传递的值。每当过滤器被调用时,它将在运行各种回调后返回它的值:

$value = Eventy::filter('my.hook', 'awesome');

第一个参数 是过滤器名称,第二个参数是值。如果过滤器没有附加监听,那么它将会返回 awesome 的值。

签名方法和动作一样,包含预期参数的优先级与数量:

Eventy::addFilter('my.hook', function($what) {
    $what = 'not '. $what;
    return $what;
}, 20, 1); // returns `not awesome`

你甚至可以将动作与过滤器结合在一起使用:

Eventy::addAction('my.hook', function($what) {
    $what = Eventy::filter('my.hook', 'awesome');
    echo 'You are '. $what;
});

模板

使用项目中 readme 相同的示例,以下是这个包的模板语法:

{{-- for example, `echo "awesome"` --}}
@action('my.hook', 'awesome')

You are @filter('my.hook', 'awesome')

了解更多

你可以从项目的 GitHub 仓库 了解更多关于 Eventy 的信息,并使用 composer require tormjens/eventy 命令来安装它。


Practice makes perfect.

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

译文地址:https://laravel-china.org/topics/15206/e...

本帖已被设为精华帖!
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 2
Summer

如果你在编写一款开源的 CMS 应用,并且想支持 Wordpress 一样的钩子机制,以允许开发者在你的 CMS 上开发插件,可以瞧一瞧此扩展。

4个月前

@Summer
The method siguature is the same as actions, including the priority and number of expected arguments:
这一段的 siguature 感觉是原文拼写错了,应该是 signature 才对

4个月前

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