PHP -Casbin: 支持 ACL、RBAC、ABAC 多种模型的 PHP 权限管理框架

PHP-Casbin 是一个用 PHP 语言打造的轻量级开源访问控制框架（ https://github.com/php-casbin... )，目前在 GitHub 开源。PHP-Casbin 采用了元模型的设计思想，支持多种经典的访问控制方案，如基于角色的访问控制 RBAC、基于属性的访问控制 ABAC 等。

PHP-Casbin 的主要特性包括

1.支持自定义请求的格式，默认的请求格式为{subject, object, action}；
2.具备访问控制模型 model 和策略 policy 两个核心概念；
3.支持 RBAC 中的多层角色继承，不止主体能够有角色，资源也能够具备角色；
4.支持超级用户，如 root 或 Administrator，超级用户能够不受受权策略的约束访问任意资源；
5.支持多种内置的操做符，如 keyMatch，方便对路径式的资源进行管理，如 /foo/bar 能够映射到 /foo*

PHP-Casbin 不作的事情：

1.身份认证 authentication （即验证用户的用户名、密码），PHP-Casbin 只负责访问控制。应该有其余专门的组件负责身份认证，而后由 PHP-Casbin 进行访问控制，两者是相互配合的关系；
2.管理用户列表或角色列表。PHP-Casbin 认为由项目自身来管理用户、角色列表更为合适，PHP-Casbin 假设全部策略和请求中出现的用户、角色、资源都是合法有效的。

安装

composer require casbin/casbin

HelloWorld 例子

1.初始化一个 enforcer，传入两个参数：模型文件路径和策略文件路径；

$e = new Enforcer(__DIR__ . '/examples/modelandpolicy/basic_model.conf', __DIR__ . "/examples/modelandpolicy/basic_policy.csv");

2.在你的代码须要进行访问控制的位置，加入以下钩子；

$sub = "alice"; // the user that wants to access a resource.
$obj = "data1"; // the resource that is going to be accessed.
$act = "read"; // the operation that the user performs on the resource.
if ($e->enforce($sub, $obj, $act) === true) {
    // permit alice to read data1
} else {
    // deny the request, show an error
}

3.采用管理 API 进行权限的管理，如获取一个用户全部的角色；

$roles = $e->getRoles('alice');

在框架中使用

• Laravel: The PHP framework for web artisans, via plugin: laravel-casbin
• Yii PHP Framework: A fast, secure, and efficient PHP framework, via plugin: yii-casbin
• ThinkPHP: The ThinkPHP framework, via plugin: think-casbin

社区进展

PHP-Casbin 目前正在积极向社区进行推送，目前经过插件的方式已经支持与 Laravel 等 Web 框架进行集成，未来会推广到更多 Web 框架以及社区。Casbin 已经有 Golang 版本、Java 版本、PHP 版本和 Node.js 版本。有跨语言需求的开发者能够只用 Casbin 这一套框架就实现多个不一样语言的项目的权限管理任务。

• Casbin (Go)： https://github.com/casbin/casbin
• jCasbin (Java)： https://github.com/casbin/jca...
• PHP-Casbin (PHP)： https://github.com/php-casbin...
• Node-Casbin (Node.js): https://github.com/casbin/nod...

协议

PHP-Casbin 采用 Apache 2.0 开源协议发布。

联系做者

有问题请提交 Issues: https://github.com/php-casbin...