适配 Yii 3.0，php-casbin/yii-permission 3.0 正式发布

在现代 Web 开发和企业级系统构建中，灵活且高效的权限控制（Access Control）始终是保障系统安全的核心基石。Casbin 作为一款强大、高效的开源访问控制框架，支持 ACL、RBAC、ABAC 等多种访问控制模型，在多语言生态中被广泛应用。

作为 Casbin 在 PHP Yii 框架生态中的官方拓展，php-casbin/yii-permission 于 2026 年 7 月 30 日正式推出了 v3.0.0 重磅版本。

本次 3.0 版本的核心亮点在于全面拥抱 Yii 3.0 框架架构。随着 Yii 3.0 全面转向现代化、组件化和 PSR 标准规范，yii-permission 也完成了从底层设计到接口集成的整体重构。

全面提升最低环境要求：项目最低支持 PHP 8.2+，全面接入最新的类型系统与强类型属性，提升代码健壮性。
现代化 DI 容器配置 ：升级通过 yiisoft/config 进行依赖注入容器的配置管理，使得在 Yii 3.0 应用中声明和初始化权限决策引擎更加符合框架原生规范。

在过去的 Yii 2.0 时代，权限拦截大多依赖于控制器级别的 Behavior 或 Application 组件。

yii-permission 3.0 顺应现代 PHP Web 架构趋势，全面引入了基于 PSR-15 标准的 HTTP 中间件：

通过 PSR-15 中间件机制，权限校验逻辑可以极其方便地按路由组（Route Group）或全局管道进行挂载，提升了中间件复用率与执行效率。

为了给 Yii 开发者提供一致的开发体验，yii-permission 3.0 新增了实现 Yiisoft\Access\AccessCheckerInterface 接口的 AccessChecker 类。

这意味着开发者可以继续使用 Yii 框架原生的访问检查语义：

php 复制代码

// 借助统一接口，在控制器或服务层轻松完成权限检查
if ($user->can('article.update', ['article' => $article])) {
    // 允许执行更新操作
}

底层由 Casbin 高效决策引擎驱动，而在应用层保持了与 Yii 框架原生规范的一致性，极大降低了项目迁移与二次开发的门槛。

参照官方 GitHub Release 发布日志，本次 v3.0.0 的核心特性与破坏性变更总结如下：

适配 Yii 3.0 框架：完整支持 Yii 3.0 独立组件生态与依赖注入规范。
环境要求升级：要求运行环境为 PHP 8.2 及以上版本以及 Yii 3.0 框架包。
PSR-15 中间件架构 ：全面引入 EnforcerMiddleware 和 RequestMiddleware 替代旧版的传统控制器组件。
原生 AccessChecker 支持 ：新增 AccessChecker 类实现 Yiisoft\Access\AccessCheckerInterface，无缝对接 $user->can()。
配置整合与 CI 优化 ：使用 yiisoft/config 统一接管 DI 配置；同步更新了 GitHub Actions CI 工作流、PHP 版本测试矩阵与代码覆盖率配置。