Laravel 權限控制新選擇：使用 Laravel-authz 集成 PHP-Casbin 詳情 - php,lavarel JonLee 博客

在 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

性能優化建議

在生產環境中，可以考慮以下優化措施：

使用策略緩存中間件預加載策略
實現批量檢查優化減少數據庫查詢
監控緩存命中率和平均鑑權耗時
設置災備方案防止單點故障

總結

Laravel-authz 為 Laravel 項目提供了強大而靈活的權限控制解決方案。通過它可以輕鬆實現：

多種訪問控制模型：支持 ACL、RBAC、ABAC 等模型
無縫集成：與 Laravel 原生 Auth 系統深度整合
高性能：支持緩存和多種優化策略
易於使用：提供友好的 API 和 Artisan 命令

無論你是構建小型項目還是複雜企業應用，Laravel-authz 都能提供可靠的權限管理支持。嘗試一下這個強大的工具，讓你的 Laravel 應用更加安全可靠！

更多詳細信息和高級用法，可以參考 https://github.com/php-casbin/laravel-authz。

JonLee 博客

JonLee 博客

博客 / 詳情