PHP-CasbinPHP 權(quán)限管理框架
PHP-Casbin 是一個(gè)用 PHP 語(yǔ)言打造的輕量級(jí)開(kāi)源訪問(wèn)控制框架，支持 ACL、RBAC、ABAC 多種模型。目前在 GitHub 開(kāi)源。
PHP-Casbin 采用了元模型的設(shè)計(jì)思想，支持多種經(jīng)典的訪問(wèn)控制方案，如基于角色的訪問(wèn)控制 RBAC、基于屬性的訪問(wèn)控制 ABAC 等。
PHP-Casbin 的主要特性包括
1.支持自定義請(qǐng)求的格式，默認(rèn)的請(qǐng)求格式為{subject, object, action}；
2.具有訪問(wèn)控制模型 model 和策略 policy 兩個(gè)核心概念；
3.支持 RBAC 中的多層角色繼承，不止主體可以有角色，資源也可以具有角色；
4.支持超級(jí)用戶，如 root 或 Administrator，超級(jí)用戶可以不受授權(quán)策略的約束訪問(wèn)任意資源；
5.支持多種內(nèi)置的操作符，如 keyMatch，方便對(duì)路徑式的資源進(jìn)行管理，如 /foo/bar 可以映射到 /foo*
PHP-Casbin 不做的事情：
1.身份認(rèn)證 authentication （即驗(yàn)證用戶的用戶名、密碼），PHP-Casbin 只負(fù)責(zé)訪問(wèn)控制。應(yīng)該有其他專門(mén)的組件負(fù)責(zé)身份認(rèn)證，然后由 PHP-Casbin 進(jìn)行訪問(wèn)控制，二者是相互配合的關(guān)系；
2.管理用戶列表或角色列表。PHP-Casbin 認(rèn)為由項(xiàng)目自身來(lái)管理用戶、角色列表更為合適，PHP-Casbin 假設(shè)所有策略和請(qǐng)求中出現(xiàn)的用戶、角色、資源都是合法有效的。
安裝
composer require casbin/casbin
HelloWorld 例子
1.初始化一個(gè) enforcer，傳入兩個(gè)參數(shù)：模型文件路徑和策略文件路徑；
$e = new Enforcer(__DIR__ . '/examples/modelandpolicy/basic_model.conf', __DIR__ . "/examples/modelandpolicy/basic_policy.csv");
2.在你的代碼需要進(jìn)行訪問(wèn)控制的位置，加入如下鉤子；
$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 data1x
} else {
// deny the request, show an error
}
3.采用管理 API 進(jìn)行權(quán)限的管理，如獲取一個(gè)用戶所有的角色；
$roles = $e->getRoles('alice');
社區(qū)進(jìn)展
PHP-Casbin 目前正在積極向社區(qū)進(jìn)行推送，目前通過(guò)插件的方式已經(jīng)支持與 Laravel 等 Web 框架進(jìn)行集成，將來(lái)會(huì)推廣到更多 Web 框架以及社區(qū)。Casbin 已經(jīng)有 Golang 版本、Java 版本、PHP 版本和 Node.js 版本。有跨語(yǔ)言需求的開(kāi)發(fā)者可以只用 Casbin 這一套框架就實(shí)現(xiàn)多個(gè)不同語(yǔ)言的項(xiàng)目的權(quán)限管理任務(wù)。
-
Casbin (Go)： https://github.com/casbin/casbin
-
jCasbin (Java)： https://github.com/casbin/jcasbin
-
PHP-Casbin (PHP)： https://github.com/php-casbin/php-casbin
-
Node-Casbin (Node.js): https://github.com/casbin/node-casbin
協(xié)議
PHP-Casbin 采用 Apache 2.0 開(kāi)源協(xié)議發(fā)布。
聯(lián)系作者
有問(wèn)題請(qǐng)提交 Issues。