PHP-Casbin 是一個(gè)強(qiáng)大的、高效的開源訪問控制框架，它支持基于各種訪問控制模型的權(quán)限管理。

Think-Casbin 是一個(gè)專為ThinkPHP5.1定制的Casbin的擴(kuò)展包，使開發(fā)者更便捷的在thinkphp項(xiàng)目中使用Casbin。

安裝

1. 創(chuàng)建thinkphp項(xiàng)目（如果沒有）：

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

2. 在ThinkPHP項(xiàng)目里，安裝Think-Casbin擴(kuò)展：

composer require casbin/think-adapter

3. 發(fā)布資源:

php think casbin:publish

這將自動(dòng)創(chuàng)建model配置文件config/casbin-basic-model.conf，和Casbin的配置文件config/casbin.php。

4. 數(shù)據(jù)遷移:

由于Think-Casbin默認(rèn)將Casbin的策略（Policy）存儲(chǔ)在數(shù)據(jù)庫中，所以需要初始化數(shù)據(jù)庫表信息。

執(zhí)行前，請(qǐng)確保數(shù)據(jù)庫連接信息配置正確，如需單獨(dú)修改Casbin的數(shù)據(jù)庫連接信息或表名，可以修改config/casbin.php里的配置。

php think casbin:migrate

這將會(huì)自動(dòng)創(chuàng)建Casbin的策略（Policy）表casbin_rule。

中間件

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

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

php think make:middleware Authorization

這個(gè)指令會(huì) application/http/middleware 目錄下面生成一個(gè) Authorization 中間件。

在中間件中，獲取當(dāng)前用戶名、URI、請(qǐng)求方法，通過 Casbin 驗(yàn)證權(quán)限：

<?php

namespace app\http\middleware;

use Casbin;
use think\facade\Session;

class Authorization
{
    public function handle($request, \Closure $next)
    {
        // 當(dāng)前登錄用戶名，這里以session為例
        // $user = Session::get('user_name') ?: 'test_user';
        $user = Session::get('user_name');

        $url = $request->url();
        $action = $request->method();

        if (!$user){
            return response()->data('Unauthenticated.')->code(401);
        }

        if (!Casbin::enforce($user, $url, $action)) {
            return response()->data('Unauthorized.')->code(403);
        }

        return $next($request);
    }
}

Casbin Model配置

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

[request_definition]
r = sub, obj, act

[policy_definition]
p = sub, obj, act

[policy_effect]
e = some(where (p.eft == allow))

[matchers]
m = r.sub == p.sub && keyMatch2(r.obj, p.obj) && r.act == p.act

驗(yàn)證

在執(zhí)行授權(quán)之前，先在數(shù)據(jù)庫 casbin_rule 表中添加一些默認(rèn)的策略:

添加路由及其中間件：

Route::group('users', function () {
    
    Route::get('', function () {
        return 'Users data.';
    });

    Route::get('/:id', function ($id) {
        return 'User: '.$id;
    });

})->middleware(\app\http\middleware\Authorization::class);

先登錄用戶保存用戶名到 SESSION ，可以訪問 /users、/users/1 驗(yàn)證一下權(quán)限。

更多API參考

• Management API
• RBAC API