Skip to content
This repository has been archived by the owner on Aug 22, 2023. It is now read-only.
/ think-casbin Public archive

专为ThinkPHP定制的Casbin的扩展包,Casbin是一个功能强大,高效的开源访问控制库。

License

Notifications You must be signed in to change notification settings

php-casbin/think-casbin

Folders and files

NameName
Last commit message
Last commit date
Aug 28, 2019
Aug 28, 2019
Mar 6, 2020
Aug 28, 2019
Aug 28, 2019
Aug 28, 2019
Oct 29, 2018
Sep 3, 2019
Aug 28, 2019
Sep 11, 2019
Aug 28, 2019
Sep 11, 2019

Repository files navigation

Think-Casbin

Build Status Coverage Status Latest Stable Version Total Downloads License

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

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

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

知识储备

  • 熟练使用Composer包管理工具
  • 掌握ThinkPHP框架各个功能,例如:门面(Facade)、模型、数据库迁移工具等
  • 熟悉PHP命令行、ThinkPHP命令行的使用
  • 了解Casbin工作原理及用法

安装

  1. 创建thinkphp项目(如果没有):
composer create-project topthink/think=5.1.* tp5
  1. ThinkPHP项目里,安装Think-Casbin扩展:
composer require casbin/think-adapter
  1. 发布资源:
php think casbin:publish

这将自动创建model配置文件config/casbin-basic-model.conf,和Casbin的配置文件config/casbin.php

  1. 数据迁移:

由于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配置信息

更多API参考

关于

Think-Casbin

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

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