casbin/webman-permission

webman casbin permission plugin

v2.0.2 2024-12-10 09:56 UTC

Requires

• php: >=8.0
• casbin/casbin: ~4.0
• doctrine/annotations: ^2.0
• php-di/php-di: ^7.0
• topthink/think-orm: ^3.0
• workerman/redis: ^2.0

Requires (Dev)

• illuminate/database: ^8.83
• illuminate/events: ^8.83
• illuminate/pagination: ^8.83
• php-coveralls/php-coveralls: ^2.7
• phpunit/phpunit: ^11.4
• psr/container: ^1.1.1
• webman/think-orm: ^1.0
• workerman/webman: ^1.5

MIT

• Tinywan

• authorization
• acl
• permission
• rbac
• access-control
• abac
• workerman
• casbin
• authz
• webman

README

🐇 An Authorization For Webman Plugin. 🐇

🐇 Webman Authorization Plugin Base Casbin. 🐇

An authorization library that supports access control models like ACL, RBAC, ABAC for webman plugin

Install

Composer Install

composer require -W casbin/webman-permission

Use

Dependency Injection configuration

Modify the config/container.php configuration to perform the following final contents:

$builder = new \DI\ContainerBuilder();
$builder->addDefinitions(config('dependence', []));
$builder->useAutowiring(true);
return $builder->build();

Database configuration

默认策略存储是使用的ThinkORM。

1、模型配置

默认使用ThinkORM。修改数据库 thinkorm.php 配置

如使用laravel数据库，配置参考如下

• 修改数据库 database.php 配置
• 修改数据库 permission.php 的adapter适配器为laravel适配器

2、创建 casbin_rule 数据表

CREATE TABLE `casbin_rule` (
	`id` BIGINT ( 20 ) UNSIGNED NOT NULL AUTO_INCREMENT,
	`ptype` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	`v0` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	`v1` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	`v2` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	`v3` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	`v4` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	`v5` VARCHAR ( 128 ) NOT NULL DEFAULT '',
	PRIMARY KEY ( `id` ) USING BTREE,
	KEY `idx_ptype` ( `ptype` ) USING BTREE,
	KEY `idx_v0` ( `v0` ) USING BTREE,
	KEY `idx_v1` ( `v1` ) USING BTREE,
	KEY `idx_v2` ( `v2` ) USING BTREE,
	KEY `idx_v3` ( `v3` ) USING BTREE,
	KEY `idx_v4` ( `v4` ) USING BTREE,
    KEY `idx_v5` ( `v5` ) USING BTREE 
) ENGINE = INNODB CHARSET = utf8mb4 COMMENT = '策略规则表';

3、配置 config/redis 配置

4、重启webman

php start.php restart

或者

php start.php restart -d

使用

安装成功后，可以这样使用:

use Casbin\WebmanPermission\Permission;

// adds permissions to a user
Permission::addPermissionForUser('eve', 'articles', 'read');
// adds a role for a user.
Permission::addRoleForUser('eve', 'writer');
// adds permissions to a rule
Permission::addPolicy('writer', 'articles','edit');

你可以检查一个用户是否拥有某个权限:

if (\Casbin\WebmanPermission\Permission::enforce('eve', 'articles', 'edit')) {
    echo '恭喜你！通过权限认证';
} else {
    echo '对不起，您没有该资源访问权限';
}

多套驱动配置

$permission = \Casbin\WebmanPermission\Permission::driver('restful_conf');
// adds permissions to a user
$permission->addPermissionForUser('eve', 'articles', 'read');
// adds a role for a user.
$permission->addRoleForUser('eve', 'writer');
// adds permissions to a rule
$permission->addPolicy('writer', 'articles','edit');

if ($permission->enforce('eve', 'articles', 'edit')) {
    echo '恭喜你！通过权限认证';
} else {
    echo '对不起，您没有该资源访问权限';
}

更多 API 参考 Casbin API 。

教程

• Casbin权限实战：入门分享(中文)
• Casbin权限实战：基于角色的RBAC授权
• Casbin权限实战：RESTful及中间件使用
• Casbin权限实战：如何使用自定义匹配函数
• Webman实战教程：如何使用casbin权限控制

感谢

Casbin，你可以查看全部文档在其 官网 上。

解除 https://github.com/PHP-DI/PHP-DI依赖的解决方案（不推荐）

1、卸载DI依赖包：composer remove php-di/php-di

2、修改：Casbin\WebmanPermission\Permission 文件

if (is_null(static::$_manager)) {
    static::$_manager = new Enforcer($model, Container::get($config['adapter']),false);
}

替换为

if (is_null(static::$_manager)) {
    if ($config['adapter'] == DatabaseAdapter::class) {
        $_model = new RuleModel();
    } elseif ($config['adapter'] == LaravelDatabaseAdapter::class) {
        $_model = new LaravelRuleModel();
    }
    static::$_manager = new Enforcer($model,  new $config['adapter']($_model), false);
}

耦合太高，不建议这么搞，更多了解：https://www.workerman.net/doc/webman/di.html