使用 Casbin 作為 ThinkPHP 的許可權控制中間件

PHP-Casbin 是一個強大的、高效的開源訪問控制框架，它支持基於各種訪問控制模型的許可權管理。

Think-Casbin 是一個專為 ThinkPHP5.1 定製的 Casbin 的擴展包，使開發者更便捷的在 thinkphp 項目中使用 Casbin。

安裝

1. 創建 thinkphp 項目（如果沒有）：

composer create-project topthink/think=5.1.* tp5

2. 在 ThinkPHP 項目里，安裝 Think-Casbin 擴展：

composer require casbin/think-adapter

3. 發佈資源:

php think casbin:publish

這將自動創建 model 配置文件 config/casbin-basic-model.conf，和 Casbin 的配置文件 config/casbin.php。

4. 數據遷移:

由於 Think-Casbin 預設將 Casbin 的策略（Policy）存儲在資料庫中，所以需要初始化資料庫表信息。

執行前，請確保資料庫連接信息配置正確，如需單獨修改 Casbin 的資料庫連接信息或表名，可以修改 config/casbin.php 里的配置。

php think casbin:migrate

這將會自動創建 Casbin 的策略（Policy）表 casbin_rule。

中間件

ThinkPHP 從 5.1.6+ 版本開始，正式引入中間件的支持。

可以通過命令行指令快速生成中間件

php think make:middleware Authorization

這個指令會 application/http/middleware 目錄下麵生成一個 Authorization 中間件。

在中間件中，獲取當前用戶名、URI、請求方法，通過 Casbin 驗證許可權：

 1 <?php
 2 
 3 namespace app\http\middleware;
 4 
 5 use Casbin;
 6 use think\facade\Session;
 7 
 8 class Authorization
 9 {
10     public function handle($request, \Closure $next)
11     {
12         // 當前登錄用戶名，這裡以session為例
13         // $user = Session::get('user_name') ?: 'test_user';
14         $user = Session::get('user_name');
15 
16         $url = $request->url();
17         $action = $request->method();
18 
19         if (!$user){
20             return response()->data('Unauthenticated.')->code(401);
21         }
22 
23         if (!Casbin::enforce($user, $url, $action)) {
24             return response()->data('Unauthorized.')->code(403);
25         }
26 
27         return $next($request);
28     }
29 }

Casbin Model 配置

config\casbin-basic-model.conf 配置文件:

 1 [request_definition]
 2 r = sub, obj, act
 3 
 4 [policy_definition]
 5 p = sub, obj, act
 6 
 7 [policy_effect]
 8 e = some(where (p.eft == allow))
 9 
10 [matchers]
11 m = r.sub == p.sub && keyMatch2(r.obj, p.obj) && r.act == p.act

驗證

在執行授權之前，先在資料庫 casbin_rule 表中添加一些預設的策略:

添加路由及其中間件：

 1 Route::group('users', function () {
 2 
 3     Route::get('', function () {
 4         return 'Users data.';
 5     });
 6 
 7     Route::get('/:id', function ($id) {
 8         return 'User: '.$id;
 9     });
10 
11 })->middleware(\app\http\middleware\Authorization::class);

先登錄用戶保存用戶名到 SESSION ，可以訪問 /users、/users/1 驗證一下許可權。

更多 API 參考

• Management API
• RBAC API