PHP-Casbin 是一個強大的、高效的開源訪問控制框架,它支援基於各種訪問控制模型的許可權管理。
Think-Casbin 是一個專為ThinkPHP5.1定製的Casbin的擴充套件包,使開發者更便捷的在thinkphp專案中使用Casbin。
安裝
- 建立thinkphp專案(如果沒有):
composer create-project topthink/think=5.1.* tp5
- 在
ThinkPHP
專案裡,安裝Think-Casbin
擴充套件:
composer require casbin/think-adapter
- 釋出資源:
php think casbin:publish
這將自動建立model配置檔案config/casbin-basic-model.conf
,和Casbin的配置檔案config/casbin.php
。
- 資料遷移:
由於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
驗證許可權:
<?php
namespace app\http\middleware;
use Casbin;
use think\facade\Session;
class Authorization
{
public function handle($request, \Closure $next)
{
// 當前登入使用者名稱,這裡以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
驗證
在執行授權之前,先在資料庫 casbin_rule
表中新增一些預設的策略:
id | ptype | v0 | v1 | v2 |
---|---|---|---|---|
1 | p | test_user | /users | GET |
2 | p | test_user | /users/:id | GET |
新增路由及其中介軟體:
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
驗證一下許可權。