Download the PHP package wuguofeng/webman-bouncer without Composer

wuguofeng/webman-bouncer

Silber\Bouncer（RBAC 角色与能力）的 webman 插件。 将 bouncer 适配到 webman 的长驻进程模型：每个请求独立的 Bouncer 实例（独立的剪贴板与缓存）， 避免进程级静态状态串号与权限缓存过期问题。

特性

• 100% 复用 silber/bouncer 原版 API：Bouncer::allow()/assign()/is()/can()/forbid()、模型 trait $user->can()/$user->isAn()。
• 每请求重建实例（request 缓存策略，ArrayStore），改权限即刻生效，无需手动 refresh()。
• 多租户 scope 支持：scope_resolver 每请求重置，防止租户串号。
• 自动初始化 Illuminate 容器 + Eloquent（优先复用 webman/database 的连接池）。
• 支持 MySQL / PostgreSQL；提供 php webman bouncer:install 按驱动方言一键建表。

安装

安装后插件配置自动拷贝到 config/plugin/wuguofeng/webman-bouncer/。

配置

编辑 config/plugin/wuguofeng/webman-bouncer/app.php：

缓存策略（cache）

使用跨请求缓存前先安装并配置 webman/cache：

跨请求缓存适合权限数据量大、校验频繁、变更低频的场景（首次校验少查库、后续全部命中缓存）。 代价是权限改动不即时生效，变更后需要手动失效：

用户模型：

建表：

使用

中间件

config/plugin/wuguofeng/webman-bouncer/middleware.php 默认注册了 BouncerMiddleware（作用于所有请求）， 保证请求处理器执行前已存在新鲜的 Bouncer 实例（trait 用法依赖它）。不需要可移除。

命令

数据库支持

运行时权限判定走 Eloquent（illuminate/database），因此只要配置的驱动正确，MySQL 与 PostgreSQL 均可正常使用 can()/allow()/assign()/forbid()。

PostgreSQL 的 config/database.php：

测试

前置：本地 MySQL（默认 127.0.0.1:3306，库 webman_bouncer_test，用户 bouncer / bouncer_pass）， 可用环境变量覆盖：

bootstrap 自动建库建表（每次运行先清空重建），并把数据库与插件配置替换为 tests/config/ 下的 fixture。测试用 support\Context 模拟请求边界（Context::destroy()），确保每请求实例、租户 scope、剪贴板等状态不在用例间串号。

工作原理

webman 是长驻进程，进程级静态状态会跨请求残留。本插件把 bouncer 的全部可变状态 （Clipboard、缓存、租户 Scope）放进每请求实例（存于 support\Context，协程安全）， 启动时只做进程级一次性配置（Illuminate 容器单例、Eloquent、用户模型映射、morph map）：

License

MIT