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
验证一下权限。