Laravel扩展推荐:角色和权限管理工具“Bouncer”

Laravel扩展推荐:角色和权限管理工具“Bouncer”

经过多年开发,56 次发布,130 万下载,并且超过 2800 的主动关注 Bouncer 终于来到了 1.0 版本。 在相当长的一段时间里,它一直非常可靠和稳定,并被世界各地无数的 app 用于生产。

这是我个人的更新,包含了我多年来的一些思考 —— 从最初到最终发行。关于如何每天使用 Bouncer 的技术信息,请查看 the extensive documentation 或者在 The Laravel Podcast 听我和马特・斯托弗讨论。

什么是 Bouncer?#

在开始我的个人旅程之前,这里先简要介绍一下 Bouncer 是什么,以及它如何融入更大的 Laravel 生态系统。

Bouncer 是一个开源包,用于动态管理数据库中的角色和权限,与 Laravel 的 Gate 完全集成。

在不深入细节的情况下,以下是其一些主要功能的简短列表:

Simple abilities:

Bouncer::allow($user)->to('access-dashboard');

Model abilities:

Bouncer::allow($user)->to('view', Invoice::class);Bouncer::allow($user)->to('delete', $invoice);

Flexible roles:

Bouncer::allow('admin')->everything();Bouncer::assign('admin')->to($user);

Forbidding abilities:

Bouncer::allow($user)->to('view', Invoice::class);Bouncer::forbid($user)->to('view', $confidentialInvoice);

Powerful ownership:

Bouncer::allow($user)->toOwn(Post::class);

Straighforward multi-tenancy:

Bouncer::scope()->to($tenantId);

the extensive documentation0

Bouncer::cache();

… 还有更多。有关详细信息,请查看the extensive documentation1,或只需浏览the extensive documentation2.

Bouncer 最初的想法

早在 2015 年 8 月,the extensive documentation3 添加了一个 the extensive documentation4,称为 Gate。这提供了一个很好用的 API,用于应用程序中定义各种操作的权限检查,the extensive documentation5 和完整的 the extensive documentation6,以及根据您定义的内容在 the extensive documentation7。

当我开始使用它时,我就知道这将是所有 Laravel 应用程序的 the extensive documentation8 的未来。 真是太好了,Taylor 对清晰和直观的 API 有这种惊人的感觉,而「Gate」抽象真正地揭示了这一点。

然而,内置授权系统缺少一件事:动态权限,存储在数据库中。 构建 Gate 的方式,所有检查都由应用程序中定义的硬编码函数执行,因此无法让您的管理员在运行时通过某些仪表板 UI 控制其中任何一个。 正如泰勒的 the extensive documentation9 明确指出:

[内置 Gate] 为组织逻辑提供了一种结构,该逻辑授权对实体进行操作。 它没有对「用户角色」的定义做出任何决定。

当时,还有许多其他流行的 the extensive documentation8 操作系统支持在运行时调整权限,但它们有一个主要缺点:它们都是在 Laravel 的 定义 之前构建的。它们是完全分离的系统;如果您决定使用它们,你将放弃 Laravel 的 gate 提供的所有细节和漂亮的集成。

因此,我决定构建一个开源包,它可以让您两全其美:动态数据库驱动的权限,与 Laravel 的 gate 完全集成。The Laravel Podcast1,使其更加简化和可预测,从而更容易将这些功能存储在数据库中。

Bouncer 的名称和 logo

我很早就想到了「保镖」(Bouncer) 这个名字。 The Laravel Podcast2 的职责是在门口提供安全保障并检查人们的权限。 所以这是与 Laravel 中的「Gate」非常自然的配对。

有趣的是,当时与我合作的标志设计师(不是以英语为母语的人)没有得到参考。 以下是他设计的 The Laravel Podcast3:

2.png

右边的两个显然是受到弹跳动作的启发。

在快速阐明了保镖这个词的含义之后,我们开始迭代实际的保镖 logo。 我们尝试了友好的保镖、威胁的保镖、大胡子的保镖、方下巴的保镖,以及大量不同的变体。 这里仅仅是少数:

AI角色脑洞生成器 AI角色脑洞生成器

一键打造完整角色设定,轻松创造专属小说漫画游戏角色背景故事

AI角色脑洞生成器 176 查看详情 AI角色脑洞生成器

3.png

我非常喜欢我们最终得到的结果:

4.png

它散发出强烈的安全感,但它的圆润让人感觉更友好,威胁更小

技术基础

Bouncer’s 的存在理由是与 Laravel 的 gate 无缝集成的。为了实现这一点,我心中的只有一个目标:在为用户分配角色和能力时,您只需和 Gate 进行交互。对于实际的授权检查,整个系统中 Laravel 的钩子应该自动工作,而不需任何特殊的 Bouncer 语法。ically, without any special Bouncer syntax.

将 Bouncer 挂钩到 Laravel 的 gate 检查方式是相当简单的。Bouncer 让你定义 The Laravel Podcast4,它将会在任何您定义的检查之前被调用:如果您的 Gate 回调允许或不许与某个操作,则不会运行进一步检查。

虽然 before 回调最初是为 「允许管理员执行所有操作」之类的东西而设计的,但我立即意识到这将是连接动态检查的理想场所,允许我查询数据库以获得任何权限。这就是它最初的工作方式(我们后来将其切换为使用 The Laravel Podcast5 – 你可以阅读更多关于 The Laravel Podcast6)

文档

从一开始,文档对我来说就非常重要。 开源项目的生死取决于他们的文档,所以我希望 Bouncer 的文档尽可能做到最好。尤其是在 Laravel 生态系统中,Taylor 为细致的文档设定了极高的标准。

在某种程度上,清晰的文档有时甚至比代码本身更重要。如果不告诉你的用户如何使用你的工具,他们中很少有人会使用源代码来解决这个问题。他们只会继续做下一件事。

我将 Bouncer 的成功很大程度上归功于清晰的文档,但在这方面还有很多工作要做。作为创建者,对整个谜题有一个清晰的了解,很容易忘记刚接触该工具的人会遇到什么困难。

例如:如前所述,Bouncer 仅用于为用户分配角色和权限。实际的授权检查将像在任何标准 Laravel 应用程序中一样处理。所以我想我不必重复所有这些,因为 The Laravel Podcast7。尽管如此,我仍然看到人们为此苦苦挣扎。他们设置了自己的角色和权限,然后不知道从哪里开始。这是我仍然想在文档中充实的一个领域。

准备发布

将 1.0 版本推迟到现在对我的用户造成了伤害。 Bouncer 多年来一直很稳定,并在世界各地的生产中积极使用。 然而,我总是犹豫要不要发布它,因为我知道我想添加的东西太多了。 我在 The Laravel Podcast8 上与 Matt 详细讨论了这个问题:我掉进了想要在发布之前让它变得完美的陷阱,这显然是 不可能的。 正如伏尔泰 The Laravel Podcast9:「完美是良好的敌人」。

因此,当我发布 Bouncer 1.0 版时,我仍然希望在初始版本中包含 2 个出色的功能,但没有成功:

每个模型的角色。 很长一段时间以来,人们一直在吵着要一种方法,只为给定的模型(或模型类)分配角色给用户。 这是该代码的样子:

// 注意:这还没有实现Bouncer::allow('editor')->to(['view', 'edit'])->everything();Bouncer::assign('editor')->to($user)->for(Invoice:class);

这样,用户就可以查看和编辑所有发票,但不能做其他任何事情。 当然,这现在可以在没有角色的情况下直接完成,但通过角色来完成会提供另一层灵活性。

我已经尝试过多次解决这个问题,但结果非常棘手,因为缓存变成了一场真正的噩梦。 我仍然希望有一天能解决它。 走着瞧。

能力限制。 允许对给定能力进行任意限制将增加更精细的控制:

// 注意:这还没有实现Bouncer::allow($user)->to('view', Post::class)->where('is_confidential', false);

如果你探索过 Bouncer 的源码,你会发现一些 #0 和 #1 我开始实现这个的地方。 它远未完成,但请继续关注。

总的来说,Bouncer 处于一个非常好的位置。每个好的产品都有一个漫长的路线图,认为我可以在发布 1.0 之前走到这条路的尽头,这是愚蠢和不切实际的。

享受使用它!

好了,到此为止。我希望您尝试在您的应用程序中使用 Bouncer,并享受使用它。 Bouncer 的 API 被设计的像散文一样,每个方法调用读起来都像是一个合适的英文句子。试一试,如果您也有这种感觉,请告诉我!

【相关推荐:#3】

以上就是Laravel扩展推荐:角色和权限管理工具“Bouncer”的详细内容,更多请关注php中文网其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/340542.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月5日 18:03:11
下一篇 2025年11月5日 18:03:44

相关推荐

  • js如何判断属性是否可被原型访问

    判断javascript对象的属性是否通过原型链访问的核心方法是:1. 使用 object.hasown(obj, prop) 返回 false 且 prop in obj 返回 true,则属性来自原型链;2. 可通过 object.getprototypeof 递归遍历原型链以定位属性所在原型层…

    2025年12月20日 好文分享
    000
  • 什么是AST?抽象语法树的应用

    AST是代码语法的抽象树形表示,广泛应用于编译器、代码分析与转换。它通过节点描述语法结构,支持语法检查、优化(如常量折叠)、代码转换(如Babel转译)、风格检测(如ESLint)及安全分析(如漏洞扫描)。Python的ast模块可解析代码为AST,常用节点包括ast.Assign、ast.BinO…

    2025年12月20日
    000
  • 基于复选框实现HTML元素动态显示与隐藏的教程

    本文详细介绍了如何利用JavaScript(特别是jQuery库)和HTML,实现基于复选框状态动态显示或隐藏页面上的特定HTML元素。教程涵盖了基本的实现方法、代码示例,并探讨了如何优化代码结构、提升用户体验及考虑其他前端框架提供的解决方案,旨在帮助开发者构建更具交互性的Web界面。 1. 概述与…

    2025年12月20日
    000
  • 动态切换HTML内容:基于复选框状态的显示与隐藏技术

    本文旨在详细阐述如何利用HTML复选框的状态变化,通过JavaScript(尤其是jQuery)动态控制页面上不同HTML区域的显示与隐藏。文章将涵盖从单一元素的切换到多个互斥区域的显示逻辑,提供清晰的代码示例,并探讨相关注意事项与最佳实践,以帮助开发者提升用户界面的交互性和灵活性。 核心概念:基于…

    2025年12月20日 好文分享
    000
  • 基于复选框状态动态控制HTML字段显示与隐藏的教程

    本教程详细介绍了如何利用HTML、CSS和JavaScript(特别是jQuery)实现基于复选框选中状态动态显示或隐藏页面上的不同内容区域。通过一个视频上传与链接插入场景的实例,展示了如何配置初始状态,并使用事件监听器响应用户交互,从而优化用户界面体验。 在现代web开发中,根据用户的选择动态调整…

    2025年12月20日 好文分享
    000
  • js 如何用keyBy将对象数组转为键值对象

    核心答案是使用 reduce 方法将数组转换为键值对象,1. 默认后一个对象覆盖前一个处理 key 冲突;2. 可通过 merge 参数将冲突值存储为数组;3. 对于缺失 key 的情况可指定默认键存储;4. 支持通过 split 和循环访问嵌套属性作为 key。转换结果以指定属性值为键,原对象为值…

    2025年12月20日
    000
  • 动态创建与管理 FancyBox 模态框内容的高级技巧

    本文深入探讨如何在 FancyBox 5 中动态创建模态框并灵活设置其内容。文章将详细阐述通过内联元素引用和直接传入 DOM 元素两种方法,并提供实际代码示例,帮助开发者在 Laravel Blade 等环境中实现会话成功提示等高级交互功能,确保模态框内容的正确显示与管理,同时介绍运行时更新模态框内…

    2025年12月20日
    000
  • FancyBox v5 动态创建模态框与内容注入指南

    本教程详细阐述了如何使用 FancyBox v5 库动态创建模态框并注入自定义内容。文章将深入探讨 Fancybox.show() 方法的不同内容源配置,包括通过内联元素(type: ‘inline’)和直接HTML字符串(type: ‘html’)两…

    2025年12月20日
    000
  • 如何程序化创建和管理 FancyBox 5 模态框的内容

    本文详细介绍了如何使用 FancyBox 5 库以编程方式创建模态框并动态管理其内容。内容涵盖了通过引用现有 DOM 元素或直接传递 HTML/DOM 对象来初始化模态框,以及在模态框打开后更新其内容的常用方法,并提供了实用的代码示例和注意事项,帮助开发者有效利用 FancyBox 5 实现灵活的交…

    2025年12月20日
    000
  • javascript闭包怎么管理私有方法

    闭包通过函数作用域链实现私有性,使内部变量和方法无法被外部直接访问,从而提升封装性和安全性。1. 利用闭包可创建私有变量和方法,如createcounter中count和increment对外不可见,仅通过公有方法getcount和increase间接访问;2. 闭包与iife结合可防止全局污染,如…

    2025年12月20日 好文分享
    000
  • js如何检测原型上的不可枚举属性

    要检测javascript原型上的不可枚举属性,必须遍历原型链并使用object.getownpropertydescriptor检查属性描述符,因为for…in循环仅枚举可枚举属性;1. 使用object.getownpropertynames获取对象自身的所有字符串属性,包括不可枚举…

    2025年12月20日 好文分享
    000
  • javascript闭包怎样返回内部函数

    闭包本身不会必然导致内存泄漏,但若闭包不当持有外部变量引用则可能引发内存泄漏,可通过及时解除引用、避免循环引用、使用weakmap/weakset、减少全局变量引用及利用工具检测来避免;1. 及时解除引用:在闭包不再需要时将外部变量设为null;2. 避免循环引用:防止闭包与外部对象相互引用;3. …

    2025年12月20日 好文分享
    000
  • js 怎么用join将数组元素连接成字符串

    join() 方法能将数组元素拼接成字符串,默认以逗号分隔;2. 可自定义分隔符,如空格或短横线;3. 空数组返回空字符串,单元素数组返回该元素的字符串形式;4. null 和 undefined 被转为空字符串,可能导致连续分隔符;5. 数字和布尔值会自动转为字符串;6. 结合 map() 可处理…

    2025年12月20日
    000
  • js如何判断变量是否为函数

    判断javascript变量是否为函数,最简单的方法是使用typeof运算符,它对函数返回”function”;2. 更可靠的方法是使用object.prototype.tostring.call(),其返回值为”[object function]”时…

    2025年12月20日
    000
  • js如何防止原型属性被枚举

    防止javascript原型属性被枚举的核心方法是使用object.defineproperty()并将enumerable设置为false;1. 使用object.defineproperty()定义原型属性时,将enumerable设为false,可使其不被for…in或object…

    2025年12月20日 好文分享
    000
  • js如何判断对象的原型是否可扩展

    判断javascript对象原型是否可扩展,核心是检查其原型链上的每个对象是否都可扩展,即没有被冻结或阻止扩展。1. 使用object.getprototypeof()沿原型链向上遍历;2. 对每个原型使用object.isextensible()检查是否可扩展;3. 若遇到不可扩展的原型返回fal…

    2025年12月20日 好文分享
    000
  • jQuery表单数据处理:确保隐藏输入值正确提交到后端

    本文旨在解决使用jQuery时隐藏输入值无法正确提交到后端(如Laravel)的问题。我们将深入探讨隐藏输入字段的正确创建与管理方法,涵盖如何在DOM中插入、设置其名称和值,以及如何将其与自定义UI交互逻辑相结合,确保表单数据完整可靠地传输。 隐藏输入字段的作用与常见问题 在Web开发中,隐藏输入字…

    2025年12月20日
    000
  • js如何让原型链上的属性不可写

    要让原型链上的属性不可写,必须使用object.defineproperty方法并将writable设为false;2. 这样设置后,所有实例共享的原型属性无法被直接修改,确保了代码的健壮性和可预测性;3. 尽管原型属性不可写,实例仍可通过在自身创建同名属性来遮蔽原型属性,实现个性化覆盖而不影响其他…

    2025年12月20日 好文分享
    000
  • javascript闭包如何模拟类静态变量

    是的,javascript可以通过闭包模拟静态变量,其核心是利用函数作用域内的变量在外部被内部函数引用时形成闭包,从而实现私有且共享的数据。1. 使用闭包的原因在于javascript缺乏原生类静态变量的私有性,闭包可实现类实例间共享且外部无法直接访问的数据,如计数器或缓存。2. 具体实现方式是通过…

    2025年12月20日 好文分享
    000
  • js 如何用some检查数组是否有满足条件的项

    是的,javascript 中 some() 方法用于检查数组中是否存在至少一个满足条件的元素,返回布尔值。1. some() 遍历数组并执行回调函数,只要有一个元素使回调返回 true,即停止遍历并返回 true;否则返回 false。2. 空数组调用 some() 总是返回 false。3. s…

    2025年12月20日
    000

发表回复

登录后才能评论
关注微信