# Entrust 权限管理 ## 说明 `Zizaco/Entrust` 是 Laravel 下 用户权限系统 的解决方案, 配合 用户身份认证 扩展包 `Zizaco/confide` 使用, 可以快速搭建出一套具备高扩展性的用户系统. `Confide`, `Entrust `和 `Sentry` 项目地址 > <https://github.com/Zizaco/entrust> > > #### 首先两个概念分清楚: - 用户身份认证 `Authentication` - 处理用户登录, 退出, 注册, 找回密码, 重置密码, 用户邮箱认证 etc.. - 权限管理 `Authorization` - 负责 用户 与 权限, 用户组 三者之间的对应, 以及管理. 下面是这几个 Package 的简单区别: - `Sentry` = 用户身份认证 + 权限管理; - `Zizaco/Entrust` = 权限管理; - `Zizaco/confide` = 用户身份认证; 用户身份认证 和 权限管理 分开来做有什么好处呢? 分开的话可以更灵活, 有些项目因为特殊的业务逻辑, 无法使用 `Confide `的 用户身份认证, 但是却需要用到 权限管理, 如: `PHPHub `. Laravel-blog 就是一个简单的应用, 使用了 `Confide` 做 用户身份认证, `Entrust` 做 权限管理, 可以作为参考. ## 安装 - composer.json ``` "zizaco/entrust": "1.2.*@dev" ``` - install ``` composer update ``` - provider 修改 `app/config/app.php` 文件, 在 `providers` 数组里面添加: ``` 'Zizaco\Entrust\EntrustServiceProvider', ``` - aliase 修改 app/config/app.php 文件, 在 aliases 数组里面添加: ``` 'Entrust' => 'Zizaco\Entrust\EntrustFacade', ``` - 系统配置 Entrust 会利用 config/auth.php 里面的值, 去决定使用那个 Model 和 用户表名. - 生成 Migration ``` ``` php artisan entrust:migration ``` 会生成 <timestamp>_entrust_setup_tables.php Migration 文件, 检查没问题后: ``` php artisan migrate ``` * Models 创建 app/models/Role.php 文件, 内容为以下: ``` <?php use Zizaco\\Entrust\\EntrustRole; class Role extends EntrustRole { } ``` 创建 app/models/Permission.php 文件, 内容为以下: ``` <?php use Zizaco\\Entrust\\EntrustPermission; class Permission extends EntrustPermission { } ``` 修改 app/models/User.php 文件, 添加 HasRole trait: ``` <?php use Zizaco\\Entrust\\HasRole; class User extends Eloquent / *or ConfideUser 'wink'* /{ ``` use HasRole; // Add this trait to your user model ``` ... ``` 最后, 生成自动加载: ``` composer dump-autoload ``` ## 基础概念 三个主要数据对象, 以及他们之间的关系: * User - 用户, 一个用户可以属于多个用户组, 不直接挂钩权限, 让用户组和权限绑定; * Roles - 用户组, 一个用户组可以拥有多个权限; * Permission - 权限; 四个数据库表说明: 安装的第 6 步会产生一个 Migration, 此文件定义了 4 张数据库表: * roles - 用户组信息表; * assigned_roles - 用户和用户组之间的对应关系; * permissions - 权限信息表; * permission_role - 权限和用户组之间的对应关系. ## 实例 接下来我们来创建用户组和权限, 并授权用户 创建用户组 ``` $admin = new Role; $admin->name = 'Admin'; $admin->save(); $owner = new Role; $owner->name = 'Owner'; $owner->save(); ``` #### 创建权限 ``` $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(); ``` #### 添加用户组权限 ``` $owner->perms()->sync(array($managePosts->id, $manageUsers->id)); $admin->perms()->sync(array($managePosts->id)); ``` #### 添加用户到用户组 ``` // 获取用户 $user = User::where('username','=','Zizaco')->first(); // 可以使用 Entrust 提供的便捷方法用户授权 // 注: 参数可以为 Role 对象, 数组, 或者 ID $user->attachRole( $admin ); // 或者使用 Eloquent 自带的对象关系赋值 $user->roles()->attach( $admin->id ); // id only ``` ## 使用 #### 基本权限判断 判断用户是否属于某个用户组: ``` $user->hasRole("Owner"); // false $user->hasRole("Admin"); // true ``` 判断用户是否拥有某个权限 (通过用户组): ``` $user->can("manage\_posts"); // true $user->can("manage\_users"); // false ``` 使用 ability 方法同时判断多个权限和用户组 ``` $user->ability(\['Admin','Owner'\], \['manage\_posts','manage\_users'\]); // 或者 $user->ability('Admin,Owner', 'manage\_posts,manage\_users'); ``` #### 路由过滤 Entrust 还提供帮助方法, 用来做路由过滤: ``` // 有 `manage_posts` 权限的用户, 才能访问 `admin/posts` 开头的链接 Entrust::routeNeedsPermission( 'admin/post\*', 'manage\_posts' ); // 属于 `Owner` 用户组的人, 才能访问 `admin/advanced*` 开头的链接 Entrust::routeNeedsRole( 'admin/advanced\*', 'Owner' ); // 可以在第二个选项传参数组, 当前用户需要符合所有传参的用户组或者权限, // 才能授权成功 Entrust::routeNeedsPermission( 'admin/post*', \['manage\_posts','manage\_comments'\] ); Entrust::routeNeedsRole( 'admin/advanced*', \['Owner','Writer'\] ); ``` ## 总结 一般我会在 `Migration` 里初始化基本的用户组, 见 Laravel Blog 项目里面的 `Entrust Migration` . ## 参考 > PHPHub 和 Laravel-Blog 都使用 Entrust 进行用户权限管理, 可以作为参考; * * * * * 原文地址：[https://phphub.org/index.php/topics/166](https://phphub.org/index.php/topics/166) ```