README

PHP-Casbin 是一个强大且高效的、开源的访问控制框架，支持基于各种访问控制模型的权限管理。

Think-Casbin 是一个专为ThinkPHP5.1定制的Casbin扩展包，使开发者更便捷地在ThinkPHP项目中使用Casbin。

针对ThinkPHP6.0，现在推出了更强大的扩展 ThinkPHP 6.0 Authorization。

知识储备

熟练使用Composer包管理工具
掌握ThinkPHP框架各个功能，例如：门面（Facade）、模型、数据库迁移工具等
熟悉PHP命令行、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。

用法

为用户分配权限

use Casbin;

// 给用户alice赋予对data1的read权限
Casbin::addPolicy('alice', 'data1', 'read');

判断权限策略是否存在

Casbin::hasPolicy('alice', 'data1', 'read'); // true

移除权限

Casbin::removePolicy('alice', 'data1', 'read');

使用决策器，验证权限

use Casbin;

$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 (true === Casbin::enforce($sub, $obj, $act)) {
    // permit alice to read data1
    echo 'permit alice to read data1';
} else {
    // deny the request, show an error
}

自定义配置

config/casbin-basic-model.conf为Casbin的model文件

config/casbin.php为Casbin的adapter和db配置信息

关于

Think-Casbin：

实现基于Think-ORM的Adapter存储（将Policy存储在数据库中）
实现Casbin的门面（think\Facade）调用，使用\Casbin::可以静态调用PHP-Casbin中的Enforcer的所有方法。
使用配置文件对Casbin的Model、Adapter的可配置化

通过Casbin官网 (https://casbin.org) 查看更多用法。

修改

增加casbin v3 的支持

codelips / casbin-think-adapter2

维护者

详细信息