Translate

适配器

在Casbin中，策略存储作为adapter(Casbin的中间件) 实现。 Casbin用户可以使用adapter从存储中加载策略规则 (aka LoadPolicy()) 或者将策略规则保存到其中 (aka SavePolicy())。 为了保持代码轻量级，我们没有把adapter代码放在主库中。

目前支持的适配器列表

Casbin的适配器完整列表如下。 我们欢迎任何第三方对adapter进行新的贡献，如果有请通知我们，我们将把它放在这个列表中:)

Go

Java

Node.js

PHP

Python

.NET

Rust

Ruby

Swift

适配器	类型	作者	自动保存	描述
File Adapter (内置)	File	Casbin	❌	For .CSV (Comma-Separated Values) files
Filtered File Adapter (内置)	File	@faceless-saint	❌	对于 CSV (逗号分隔的值) 个带策略子集加载支持的文件
SQL Adapter	SQL	@Blank-Xu	✅	MySQL，PostgreSQL，SQL Server和SQLite3在 master分支中受到database/sql的支持，Oacle在 oracle分支中也受到database/sql的支持
Xorm Adapter	ORM	Casbin	✅	通过 Xorm实现，支持MySQL, PostgreSQL, Sqlite3, SQL Server等多种存储引擎的adapter
Gorm Adapter	ORM	Casbin	✅	通过 Gorm实现，支持MySQL, PostgreSQL, Sqlite3, SQL Server等多种存储引擎的adapter
Ent Adapter	ORM	Casbin	✅	MySQL, MariaDB, PostgreSQL, SQLite, 基于Gremlin的图数据库由 [ent ORM](https://entgo. io/) 支持。
Beego ORM Adapter	ORM	Casbin	✅	MySQL, PostgreSQL, Sqlite3 由 Beego ORM 支持
SQLX Adapter	ORM	@memwey	✅	MySQL, PostgreSQL, SQLite, Oracle 由 SQLX 支持
Sqlx Adapter	SQL	@Blank-Xu	✅	MySQL, PostgreSQL, SQL Server, SQLite3 由 master 分支支持，Oracle由oracle 分支受到sqlx的支持
GF ORM Adapter	ORM	@vance-liu	✅	MySQL, SQLite, PostgreSQL, Oracle, SQL Server 受到 GoFrame ORM 的支持
GoFrame ORM Adapter	ORM	@kotlin2018	✅	MySQL, SQLite, PostgreSQL, Oracle, SQL Server由GoFrame ORM支持
Filtered PostgreSQL Adapter	SQL	Casbin	✅	针对 PostgreSQL
PostgreSQL Adapter	SQL	@cychiuae	✅	用于PostgreSQL
RQLite Adapter	SQL	EDOMO Systems	✅	用于RQLite
MongoDB Adapter	NoSQL	Casbin	✅	基于 MongoDB Go Driver 用于 MongoDB
RethinkDB Adapter	NoSQL	@adityapandey9	✅	用于RethinkDB
Cassandra Adapter	NoSQL	Casbin	❌	用于Apache Cassandra DB
DynamoDB Adapter	NoSQL	HOOQ	❌	用于Amazon DynamoDB
Dynacasbin	NoSQL	NewbMiao	✅	用于Amazon DynamoDB
ArangoDB Adapter	NoSQL	@adamwasila	✅	用于ArangoDB
Amazon S3 Adapter	Cloud	Soluto	❌	用于Minio和Amazon S3
Azure Cosmos DB Adapter	Cloud	@spacycoder	✅	用于Microsoft Azure Cosmos DB
GCP Firestore Adapter	Cloud	@reedom	❌	用于Google Cloud Platform Firestore
GCP Cloud Storage Adapter	Cloud	qurami	❌	用于Google Cloud Platform Cloud Storage
GCP Cloud Storage Adapter	云	@flowerinthenight	✅	用于Google Cloud Platform Cloud Spanner
Consul Adapter	KV store	@ankitm123	❌	用于HashiCorp Consul
Redis 适配器 (Redigo)	KV store	Casbin	✅	用于Redis
Redis Adapter (go-redis)	KV store	@mlsen	✅	用于Redis
Etcd 适配器	KV store	@sebastianliu	❌	用于etcd
BoltDB Adapter	KV store	@speza	✅	用于Bolt
Bolt Adapter	KV store	@wirepair	❌	用于Bolt
BadgerDB Adapter	KV store	@inits	✅	用于BadgerDB
Protobuf Adapter	Stream	Casbin	❌	用于 Google Protocol Buffers
JSON Adapter	String	Casbin	❌	用于JSON
String Adapter	String	@qiangmzsx	❌	用于字符串
HTTP File Adapter	HTTP	@h4ckedneko	❌	用于http.FileSystem

适配器	类型	作者	自动保存	描述
File Adapter (内置)	File	Casbin	❌	对于 CSV (逗号分隔的值) 文件
JDBC Adapter	JDBC	Casbin	✅	MySQL, Oracle, PostgreSQL, DB2, Sybase, SQL 服务器由 JDBC 支持
Hibernate Adapter	ORM	Casbin	✅	Oracle, DB2, SQL Server, Sybase, MySQL, PostgreSQL 由 Hibernate支持
MyBatis Adapter	ORM	Casbin	✅	MySQL, Oracle, PostgreSQL, DB2, Sybase, SQL Server (与 JDBC 相同) 由 MyBatis 3 支持
Hutool Adapter	ORM	@mapleafgo	✅	MySQL, Oracle, PostgreSQL, SQLite 由 Hutool 支持
MongoDB Adapter	NoSQL	Casbin	✅	MongoDB 由 Mongodb-driver-sync 支持
DynamoDB Adapter	NoSQL	Casbin	❌	对于 Amazon DynamoDB
Redis Adapter	KV store	Casbin	✅	用于 Redis

适配器	类型	作者	自动保存	描述
File Adapter (内置)	File	Casbin	❌	对于 CSV (逗号分隔的值) 文件
Filtered File Adapter (内置)	File	Casbin	❌	对于带策略子集 .CSV (逗号分隔值) 文件加载支持
String Adapter (内置)	String	@calebfaruki	❌	用于 String
Basic Adapter	Native ORM	Casbin	✅	pg, mysql, mysql2, sqlite3, oracedb, mssql 是适配器本身支持的
Sequelize Adapter	ORM	Casbin	✅	MySQL、 PostgreSQL、 SQLite、 Microsoft SQL Server 由 Sequelize 支持
TypeORM Adapter	ORM	Casbin	✅	MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server, Oracle, WebSQL, MongoDB 由 TypeORM 支持
Prisma Adapter	ORM	Casbin	✅	MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server, AWS Aurora, Azure SQL 由 Prisma支持
Knex Adapter	ORM	@sarneeh and knex	✅	MSSQL, MySQL, PostgreSQL, SQLite3, Oracle 由 Knex.js支持
Objection.js Adapter	ORM	@willsoto	✅	MSSQL, MySQL, PostgreSQL, SQLite3, Oracle 由 Objection.js 支持
Node PostgreSQL Native Adapter	SQL	@touchifyapp	✅	PostgreSQL 适配器，拥有高级策略子集加载支持以及由 [node-postgres](https://node-postgres. com/) 构建的更好的性能。
MongoDB Adapter	NoSQL	elastic.io 和 Casbin	✅	MongoDB 由 Mongoose 支持
Mongoose 适配器 (无交易)	NoSQL	minhducck	✅	MongoDB 由 Mongoose 支持
Node MongoDB 原生 Adapter	NoSQL	@juicycleff	✅	用于 Node MongoDB Native
DynamoDB Adapter	NoSQL	@fospitia	✅	用于Amazon DynamoDB
Couchbase Adapter	NoSQL	@MarkMYoung	✅	用于 Couchbase
Redis Adapter	KV store	Casbin	❌	用于 Redis
Redis Adapter	KV store	@NandaKishorJeripothula	❌	用于 Redis

适配器	类型	作者	自动保存	描述
文件适配器 (内置)	File	Casbin	❌	用于 .CSV (Comma-Separated Values) 文件
数据库适配器	ORM	Casbin	✅	MySQL, PostgreSQL, SQLite, Microsoft SQL Server 由 techone/database 支持
Zend Db 适配器	ORM	Casbin	✅	MySQL, PostgreSQL, SQLite, Oracle, IBM DB2, Microsoft SQL Server, 其他 PDO Driver 由 zend-db 支持
Doctrine DBAL 适配器(建议)	ORM	Casbin	✅	强大的 PHP 数据库抽象层(DBAL)，具有数据库架构内省和管理的许多功能。
Medoo 适配器	ORM	Casbin	✅	Medoo 是一个用来加速开发的轻量PHP 数据库框架。 支持所有 SQL 数据库，包括 MySQL, MSSQL, SQLite, MariaDB, PostgreSQL, Sybase, Oracle 以及更多。
Laminas-db 适配器	ORM	Casbin	✅	MySQL, PostgreSQL, Oracle, IBM DB2, Microsoft Sql Server, PDO等。 由 laminas-db 支持
Zend-db 适配器	ORM	Casbin	✅	MySQL, PostgreSQL, Oracle, IBM DB2, Microsoft Sql Server, PDO等。 由 zend-db 支持
Redis 适配器	KV store	@nsnake	❌	用于 Redis

适配器	类型	作者	自动保存	描述
文件适配器(内置)	File	Casbin	❌	对于 CSV 文件
SQLAlchemy 适配器	ORM	Casbin	✅	PostgreSQL、MySQLite、Oracle、Microsoft SQL Server、Firebird、Sybase 由 SQLAlchemy 支持
异步数据库适配器	ORM	sampingantech	✅	PostgreSQL、MySQLite、Oracle、Microsoft SQL Server、Firebird、Sybase 由 Databases 支持。
Peewee 适配器	ORM	@shblhy	✅	PostgreSQL、 MySQL、 SQLite 由 Peewee 支持
MongoEngine 适配器	ORM	@zhangbailong945	❌	MongoDB 由 MongoEngine 支持
Pony ORM Adapter	ORM	@drorvinkler	✅	MySQL, PostgreSQL, SQLite, Oracle, CockroachDB由Pony ORM支持
Tortoise ORM Adapter	ORM	@thearchitector	✅	PostgreSQL (>=9.4), MySQL, MariaDB, 和 SQLite 都由 Tortoise ORM 支持
Couchbase Adapter	NoSQL	ScienceLogic	✅ (没有 remove_filtered_policy())	用于 Couchbase
DynamoDB Adapter	NoSQL	@abqadeer	✅	用于 DynamoDB
Pymongo 适配器	NoSQL	Casbin	❌	MongoDB 由 [Pymongo 支持](https://pypi. org/project/pymongo/)

适配器	类型	作者	自动保存机制	说明
文件适配器 (内置)	File	Casbin	❌	用于 .CSV 文件
EF 适配器	ORM	Casbin	❌	MySQL, PostgreSQL, SQLite, Microsoft SQL Server, Oracle, DB2, 等等 由 [Entity Framework 6](https://docs. microsoft. com/en-us/ef/ef6/) 支持
EFCore 适配器	ORM	Casbin	✅	MySQL, PostgreSQL, SQLite, Microsoft SQL Server, Oracle, DB2, 等等. 由 Entity Framework Core 支持
EFCore 适配器 (.NET Core 5)	ORM	@g4dvali	✅	MySQL, PostgreSQL, SQLite, Microsoft SQL Server, Oracle, DB2, 等等 由 Entity Framework Core 支持

适配器	类型	作者	自动保存机制	说明
文件适配器 (内置)	File	Casbin	❌	用于 .CSV 文件
Diesel 适配器	ORM	Casbin	✅	SQLite, PostgreSQL, MySQL 由 Diesel 支持
Sqlx 适配器	ORM	Casbin	✅	PostgreSQL, MySQL 由 Sqlx 支持，可实现完全异步操作
JSON Adapter	String	Casbin	✅	用于JSON
YAML Adapter	字符串	Casbin	✅	用于 YAML

Adapter	类型	作者	自动保存	描述
File Adapter (内置)	文件	Casbin	❌	用于 .CSV (Comma-Separated Values) 文件
Sequelize Adapter	ORM	CasbinRuby	✅	ADO, Amalgalite, IBM_DB, JDBC, MySQL, Mysql2, ODBC, Oracle, PostgreSQL, SQLAnywhere SQLite3, 和 TinyTDS 都由 Sequel 支持

Adapter	类型	作者	自动保存	描述
File Adapter (内置)	File	Casbin	❌	用于 .CSV (Comma-Separated Values) 文件
Memory Adapter (内置)	内存	Casbin	❌	用于内存
Fluent Adapter	ORM	Casbin	✅	PostgreSQL、SQLite、MySQL、MongoDB 由 Fluent 支持

note

1. 如果使用显式或隐式adapter调用casbin.NewEnforcer()，策略将自动加载。
2. 可以调用e.LoadPolicy() 来从存储中重新加载策略规则。
3. 如果adapter不支持Auto-Save特性，则在添加或删除策略时不能将策略规则自动保存回存储器。 你必须手动调用 SavePolicy() 来保存所有的策略规则

例子

我们为您提供以下示例作为参考：

文件适配器 (内置)

下面展示如何从内置的文件adapter初始化enforce:

Go

PHP

Rust

import "github.com/casbin/casbin"

e := casbin.NewEnforcer("examples/basic_model.conf", "examples/basic_policy.csv")

use Casbin\Enforcer;

$e = new Enforcer('examples/basic_model.conf', 'examples/basic_policy.csv');

use casbin::prelude::*;

let mut e = Enforcer::new("examples/basic_model.conf", "examples/basic_policy.csv").await?;

它等同于如下代码：

Go

PHP

Rust

import (
    "github.com/casbin/casbin"
    "github.com/casbin/casbin/file-adapter"
)

a := fileadapter.NewAdapter("examples/basic_policy.csv")
e := casbin.NewEnforcer("examples/basic_model.conf", a)

use Casbin\Enforcer;
use Casbin\Persist\Adapters\FileAdapter;

$a = new FileAdapter('examples/basic_policy.csv');
$e = new Enforcer('examples/basic_model.conf', $a);

use casbin::prelude::*;

let a = FileAdapter::new("examples/basic_policy.csv");
let e = Enforcer::new("examples/basic_model.conf", a).await?;

MySQL 适配器

下面展示了如何从MySQL数据库初始化一个enforcer。 此处样例中的MySQL数据库运行在127.0.0.1:3306上，用户为root，密码为空。

Go

Rust

PHP

import (
    "github.com/casbin/casbin"
    "github.com/casbin/mysql-adapter"
)

a := mysqladapter.NewAdapter("mysql", "root:@tcp(127.0.0.1:3306)/")
e := casbin.NewEnforcer("examples/basic_model.conf", a)

// https://github.com/casbin-rs/diesel-adapter
// 请确保您激活了 `mysql` 特性

use casbin::prelude::*;
use diesel_adapter::{ConnOptions, DieselAdapter};

let mut conn_opts = ConnOptions::default();
conn_opts
    .set_hostname("127.0.0.1")
    .set_port(3306)
    .set_host("127.0.0.1:3306") // overwrite hostname, port config
    .set_database("casbin")
    .set_auth("casbin_rs", "casbin_rs");

let a = DieselAdapter::new(conn_opts)?;
let mut e = Enforcer::new("examples/basic_model.conf", a).await?;

// https://github.com/php-casbin/dbal-adapter

use Casbin\Enforcer;
use CasbinAdapter\DBAL\Adapter as DatabaseAdapter;

$config = [
    // Either 'driver' with one of the following values:
    // pdo_mysql,pdo_sqlite,pdo_pgsql,pdo_oci (unstable),pdo_sqlsrv,pdo_sqlsrv,
    // mysqli,sqlanywhere,sqlsrv,ibm_db2 (unstable),drizzle_pdo_mysql
    'driver'     => 'pdo_mysql', 
    'host' => '127.0.0.1',
    'dbname' => 'test',
    'user' => 'root',
    'password' => '',
    'port' => '3306',
];

$a = DatabaseAdapter::newAdapter($config);
$e = new Enforcer('examples/basic_model.conf', $a);

使用自建的adapter

您可以参考如下代码来使用自建的adapter

import (
    "github.com/casbin/casbin"
    "github.com/your-username/your-repo"
)

a := yourpackage.NewAdapter(params)
e := casbin.NewEnforcer("examples/basic_model.conf", a)

在运行时进行加载或保存配置信息

您可能还想重新加载模型，重新加载策略或在初始化后保存策略:

// 从模型CONF文件重新加载模型。
e.LoadModel()

// 从文件或数据库中重新加载策略。
e.LoadPolicy()

// 保存当前策略 (通常使用 Casbin API更改后) 返回文件或数据库。
e.SavePolicy()

自动保存

自动保存机制是adapter的特性之一。 当adapter支持Auto-Save时，意味着它可以支持向存储中添加一个策略规则，或者从存储中删除一个策略规则。 这与SavePolicy()不同，因为后者将删除存储中的所有策略规则，并将所有策略规则从Casbin enforcer保存到存储中。 因此，当内存中的policy规则过多时，会引起一些性能问题。

当adapter支持 Auto-Save时，可以通过Enforcer.EnableAutoSave() 函数切换此选项。 默认启用此选项(如果适配器支持它)。

note

1. Auto-Save 特性是可选的。 Adapter可以选择是否实现它。
2. Auto-Save 只在Casbin enforcer使用的adapter支持它时才有效。
3. 请参阅上面适配器列表中的自动保存 列，以查看自动保存是否有适配器支持。

以下示例演示了 自动保存机制的使用方法：

import (
    "github.com/casbin/casbin"
    "github.com/casbin/xorm-adapter"
    _ "github.com/go-sql-driver/mysql"
)

// enforcer会默认开启AutoSave机制.
a := xormadapter.NewAdapter("mysql", "mysql_username:mysql_password@tcp(127.0.0.1:3306)/")
e := casbin.NewEnforcer("examples/basic_model.conf", a)

// 禁用AutoSave机制
e.EnableAutoSave(false)

// 因为禁用了AutoSave，当前策略的改变只在内存中生效
// 这些策略在持久层中仍是不变的
e.AddPolicy(...)
e.RemovePolicy(...)

// 开启AutoSave机制
e.EnableAutoSave(true)

// 因为开启了AutoSave机制，现在内存中的改变会同步回写到持久层中
e.AddPolicy(...)
e.RemovePolicy(...)

更多示例参见: https://github.com/casbin/xorm-adapter/blob/master/adapter_test.go

如何编写 Adapter

所有适配器都应该通过提供至少两个强制方法实现 Adapter 接口：LoadPolicy(model model.Model) error 和 SavePolicy(model model.Model) error.

其他三个函数是可选的。 如果adapter支持Auto-Save特性，则应该实现它们。

方法	类型	描述
LoadPolicy()	强制的	从存储中加载所有策略规则
SavePolicy()	强制的	将所有策略规则保存到存储中
AddPolicy()	可选择的	向存储中添加策略规则
RemovePolicy()	可选择的	从存储中删除策略规则
RemoveFilteredPolicy()	可选择的	从存储中删除匹配筛选器的策略规则

note

如果适配器不支持 自动保存, 它应该为三个可选函数提供一个空的实现。 下面是Golang示例：

/ AddPolicy 向存储器添加了一条策略规则。
func (a *Adapter) AddPolicy(sec string, ptype string, rule []string) error {
    return errors.New("not implemented")
}

// RemovePolicy 从存储器中移除一条策略规则。
func (a *Adapter) RemovePolicy(sec string, ptype string, rule []string) error {
    return errors.New("not implemented")
}

// RemoveFilteredPolicy 从存储器中移除可匹配过滤器的策略规则。
func (a *Adapter) RemoveFilteredPolicy(sec string, ptype string, fieldIndex int, fieldValues ...string) error {
    return errors.New("not implemented")
}

Casbin enforcer在调用这三个可选实现的接口时，会忽略返回的not implemented 异常。

关于如何写入适配器的详细信息。

• 数据结构 适配器应 最少 支持六列。
• 数据库名称: 默认数据库名称应该是 cassbin。
• 表格名称 默认表名应该是 casbin_rule。
• Ptype 栏。 此列的名称应该是 ptype 而不是 p_type 或 Ptype。
• 表定义应该是 (id int priorkey, ptype varchar, v0 varchar, v1 varchar, v2 varchar, v3 varchar, v4 varchar, v5 varchar)
• 唯一的密钥索引应该建立在列 ptype, v0, v1, v2, v3, v4, v5 上。
• LoadFilteredPolicy 需要 filter 作为参数。 Filter应该像这样。 json { "p":[ [ "alice" ], [ "bob" ] ], "g":[ [ "", "book_group" ], [ "", "pen_group" ] ], "g2":[ [ "alice" ] ] }

谁负责创建数据库？

我们通常约定，如果相应的数据库结构尚未建立，那么使用adapter作为policy的持久化工具时，它应具有自动创建一个名为 casbin 的数据库的能力。 请看Xorm adapter作为参考实现:https://github.com/casbin/xorm-adapter