Laravel 权限控制新选择：使用 Laravel-authz 集成 PHP-Casbin

JonLee 的个人博客 / 219 / 4 / 创建于 2周前 / 更新于 3天前

AI摘要

本文介绍Laravel-authz库，它基于Casbin为Laravel项目提供RBAC、ABAC等高级权限管理方案。支持无缝集成Laravel原生Auth系统，提供API、中间件和Artisan命令，实现灵活权限控制与性能优化。适用于各类规模项目。

在 Laravel 项目开发中，权限管理是保证应用安全的关键环节。虽然 Laravel 自带了 Gate 和 Policy 授权机制，但在面对复杂权限需求时往往力不从心。今天介绍的是基于 Casbin 的 Laravel-authz 库，它能帮助你在 Laravel 项目中实现 RBAC（基于角色的访问控制）、ABAC（基于属性的访问控制）等高级权限模型。

什么是Casbin和Laravel-authz？

PHP-Casbin 是一个强大的、支持多种访问控制模型的开源授权库，它支持ACL、RBAC、ABAC等多种访问控制模型。

Laravel-authz 是专门为 Laravel 框架定制的Casbin扩展包，提供了无缝集成体验。

通过 Laravel-authz，你可以轻松管理用户权限、角色和资源关系，实现灵活且精细化的权限控制。

安装与配置

1. 安装包

使用 Composer 安装 Laravel-authz：

composer require casbin/laravel-authz

包安装后，ServiceProvider 和 Facade 会自动注册。

2. 发布配置和迁移

运行以下命令发布配置文件和执行数据库迁移：

php artisan vendor:publish
php artisan migrate

这将创建配置文件（config/lauthz.php 和 config/lauthz-rbac-model.conf）以及数据库表。

基本使用

管理权限和角色

使用Enforcer门面可以轻松管理权限和角色：

use Enforcer;

// 给用户添加权限
Enforcer::addPermissionForUser('eve', 'articles', 'read');

// 给用户添加角色
Enforcer::addRoleForUser('eve', 'writer');

// 给角色添加权限
Enforcer::addPolicy('writer', 'articles', 'edit');

检查权限

在代码中检查用户权限很简单：

if (Enforcer::enforce("eve", "articles", "edit")) {
    // 允许编辑文章
} else {
    // 拒绝请求，显示错误
}

使用中间件保护路由

Laravel-authz 提供了中间件来保护路由：

// 在app/Http/Kernel.php中注册中间件
protected $routeMiddleware = [
    // ...
    'enforcer' => \Lauthz\Middlewares\EnforcerMiddleware::class,
    'http_request' => \Lauthz\Middlewares\RequestMiddleware::class,
];

保护路由：

Route::group(['middleware' => ['enforcer:articles,read']], function () {
    // 需要文章读取权限的路由
});

对于 RESTful 资源，可以使用 RequestMiddleware：

Route::group(['middleware' => ['http_request']], function () {
    Route::resource('photo', 'PhotoController');
});

深度集成Laravel原生Auth系统

为了更好融入Laravel生态，可以深度集成 Casbin 到原生 Auth 系统。

1. 扩展用户提供器

// 在AuthServiceProvider中
Auth::provider('casbin', function($app, array $config) {
    return new class($app['hash'], $config['model']) extends EloquentUserProvider {
        public function retrieveById($identifier) {
            $user = parent::retrieveById($identifier);
            // 注入Casbin角色
            $user->setAttribute('roles', Enforcer::getRolesForUser('user:'.$identifier));
            return $user;
        }
    };
});

2. 配置自定义驱动

在config/auth.php中：

'providers' => [
    'users' => [
        'driver' => 'casbin',
        'model' => App\Models\User::class,
    ],
]

3. 重写Gate行为

开发者可以使用 Laravel 的 Gates 检查一个用的权限：

$user->can('articles,read');
// For multiple enforcers
$user->can('articles,read', 'second');
// The methods cant, cannot, canAny, etc. also work

高级功能

多实例支持

Laravel-authz 支持配置多个权限控制实例：

// config/lauthz.php
return [
    'default' => 'basic',
    'basic' => [
        'model' => [/*...*/],
        'adapter' => Lauthz\Adapters\DatabaseAdapter::class,
    ],
    'second' => [
        'model' => [/*...*/],
    ],
];

// 使用特定实例
Enforcer::guard('second')->enforce("eve", "articles", "edit");

缓存优化

为了提高性能，可以启用策略缓存：

// config/lauthz.php
'cache' => [
    'enabled' => true,
    'store' => 'default',
    'key' => 'rules',
    'ttl' => 24 * 60,
]

Artisan命令

Laravel-authz 提供了方便的Artisan命令：

# 给用户添加策略
php artisan policy:add eve,articles,read

# 给角色添加策略
php artisan policy:add writer,articles,edit

# 给用户赋予角色
php artisan role:assign eve writer