說明#

Zizaco/Entrust是 Laravel 下用戶權(quán)限系統(tǒng)的解決方案, 配合用戶身份認(rèn)證擴(kuò)展包Zizaco/confide使用, 可以快速搭建出一套具備高擴(kuò)展性的用戶系統(tǒng).

Confide, Entrust 和 Sentry#

首先兩個(gè)概念分清楚:

用戶身份認(rèn)證 Authentication - 處理用戶登錄, 退出, 注冊, 找回密碼, 重置密碼, 用戶郵箱認(rèn)證 etc..
權(quán)限管理 Authorization - 負(fù)責(zé)用戶與權(quán)限,用戶組三者之間的對應(yīng), 以及管理.

下面是這幾個(gè) Package 的簡單區(qū)別:

Sentry=用戶身份認(rèn)證+權(quán)限管理;
Zizaco/Entrust=權(quán)限管理;
Zizaco/confide=用戶身份認(rèn)證;

用戶身份認(rèn)證和權(quán)限管理分開來做有什么好處呢?#

分開的話可以更靈活, 有些項(xiàng)目因?yàn)樘厥獾臉I(yè)務(wù)邏輯, 無法使用 Confide 的用戶身份認(rèn)證, 但是卻需要用到權(quán)限管理, 如:PHPHub.

Laravel-blog就是一個(gè)簡單的應(yīng)用, 使用了 Confide 做用戶身份認(rèn)證, Entrust 做權(quán)限管理, 可以作為參考.

安裝#

1. composer.json#

"zizaco/entrust": "1.2.*@dev"

2. install#

composer update

3. provider#

修改 app/config/app.php 文件, 在 providers 數(shù)組里面添加:

'ZizacoEntrustEntrustServiceProvider',

4. aliase#

修改 app/config/app.php 文件, 在 aliases 數(shù)組里面添加:

'Entrust'    => 'ZizacoEntrustEntrustFacade',

5. 系統(tǒng)配置#

Entrust 會利用config/auth.php里面的值, 去決定使用那個(gè) Model 和 用戶表名.

6. 生成 Migration#

php artisan entrust:migration

會生成<timestamp>_entrust_setup_tables.phpMigration 文件, 檢查沒問題后:

php artisan migrate

7. Models#

創(chuàng)建app/models/Role.php文件, 內(nèi)容為以下:

<?php

use ZizacoEntrustEntrustRole;

class Role extends EntrustRole
{

}

創(chuàng)建app/models/Permission.php文件, 內(nèi)容為以下:

<?php

use ZizacoEntrustEntrustPermission;

class Permission extends EntrustPermission
{

}

修改app/models/User.php文件, 添加HasRoletrait:

<?php

use ZizacoEntrustHasRole;

class User extends Eloquent /* or ConfideUser 'wink' */{
    use HasRole; // Add this trait to your user model

...

最后, 生成自動加載:

composer dump-autoload

基礎(chǔ)概念#

三個(gè)主要數(shù)據(jù)對象, 以及他們之間的關(guān)系:#

User - 用戶, 一個(gè)用戶可以屬于多個(gè)用戶組, 不直接掛鉤權(quán)限, 讓用戶組和權(quán)限綁定;
Roles - 用戶組, 一個(gè)用戶組可以擁有多個(gè)權(quán)限;
Permission - 權(quán)限;

四個(gè)數(shù)據(jù)庫表說明:#

安裝的第 6 步會產(chǎn)生一個(gè) Migration, 此文件定義了 4 張數(shù)據(jù)庫表:

roles - 用戶組信息表;
assigned_roles - 用戶和用戶組之間的對應(yīng)關(guān)系;
permissions - 權(quán)限信息表;
permission_role - 權(quán)限和用戶組之間的對應(yīng)關(guān)系.

實(shí)例#

接下來我們來創(chuàng)建用戶組和權(quán)限, 并授權(quán)用戶

創(chuàng)建用戶組#

$admin = new Role;
$admin->name = 'Admin';
$admin->save();

$owner = new Role;
$owner->name = 'Owner';
$owner->save();

創(chuàng)建權(quán)限#

$manageUsers = new Permission;
$manageUsers->name = 'manage_users';
$manageUsers->display_name = 'Manage Users';
$manageUsers->save();

$managePosts = new Permission;
$managePosts->name = 'manage_posts';
$managePosts->display_name = 'Manage Posts';
$managePosts->save();

添加用戶組權(quán)限#

$owner->perms()->sync(array($managePosts->id, $manageUsers->id));
$admin->perms()->sync(array($managePosts->id));

添加用戶到用戶組#

// 獲取用戶
$user = User::where('username','=','Zizaco')->first();

// 可以使用 Entrust 提供的便捷方法用戶授權(quán)
// 注: 參數(shù)可以為 Role 對象, 數(shù)組, 或者 ID
$user->attachRole( $admin ); 

// 或者使用 Eloquent 自帶的對象關(guān)系賦值
$user->roles()->attach( $admin->id ); // id only

使用#

基本權(quán)限判斷#

判斷用戶是否屬于某個(gè)用戶組:

$user->hasRole("Owner");    // false
$user->hasRole("Admin");    // true

判斷用戶是否擁有某個(gè)權(quán)限 (通過用戶組):

$user->can("manage_posts"); // true
$user->can("manage_users"); // false

使用ability方法同時(shí)判斷多個(gè)權(quán)限和用戶組

$user->ability(['Admin','Owner'], ['manage_posts','manage_users']);
// 或者
$user->ability('Admin,Owner', 'manage_posts,manage_users');

路由過濾#

Entrust 還提供幫助方法, 用來做路由過濾:

// 有 `manage_posts` 權(quán)限的用戶, 才能訪問 `admin/posts` 開頭的鏈接
Entrust::routeNeedsPermission( 'admin/post*', 'manage_posts' );

// 屬于 `Owner` 用戶組的人, 才能訪問 `admin/advanced*` 開頭的鏈接
Entrust::routeNeedsRole( 'admin/advanced*', 'Owner' );

// 可以在第二個(gè)選項(xiàng)傳參數(shù)組, 當(dāng)前用戶需要符合所有傳參的用戶組或者權(quán)限, 
// 才能授權(quán)成功
Entrust::routeNeedsPermission( 'admin/post*', ['manage_posts','manage_comments'] );
Entrust::routeNeedsRole( 'admin/advanced*', ['Owner','Writer'] );

開啟緩存#

查閱https://laravel-china.org/topics/2589

總結(jié)#

一般我會在 Migration 里初始化基本的用戶組, 見Laravel Blog 項(xiàng)目里面的 Entrust Migration.

參考.#

PHPHub和Laravel-Blog都使用 Entrust 進(jìn)行用戶權(quán)限管理, 可以作為參考;
請熟讀官方文檔

---

我們正在招聘全職伙伴和Remote 工程師，歡迎加入

---

入門書籍推薦 ——《Laravel 入門教程》

總結(jié)

以上是生活随笔為你收集整理的Entrust的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。