freepeace13 / laravel-multiauth-permission
支持多认证的 Laravel 5.4 及以上版本的权限处理。
Requires
- php: >=7.0
- illuminate/auth: ~5.3.0|~5.4.0|~5.5.0|~5.6.0|~5.7.0
- illuminate/container: ~5.3.0|~5.4.0|~5.5.0|~5.6.0|~5.7.0
- illuminate/contracts: ~5.3.0|~5.4.0|~5.5.0|~5.6.0|~5.7.0
- illuminate/database: ~5.4.0|~5.5.0|~5.6.0|~5.7.0
Requires (Dev)
- orchestra/testbench: ~3.4.2|~3.5.0|~3.6.0|~3.7.0
- phpunit/phpunit: ^5.7|6.2|^7.0
- predis/predis: ^1.1
- dev-master
- v3.x-dev
- 2.29.0
- 2.28.2
- 2.28.1
- 2.28.0
- 2.27.0
- 2.26.2
- 2.26.1
- 2.26.0
- 2.25.0
- 2.24.0
- 2.23.0
- 2.22.1
- 2.22.0
- 2.21.0
- 2.20.0
- 2.19.2
- 2.19.1
- 2.19.0
- 2.18.0
- 2.17.1
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.2
- 2.12.1
- 2.12.0
- 2.11.0
- 2.10.0
- 2.9.2
- 2.9.1
- 2.9.0
- 2.8.2
- 2.8.1
- 2.8.0
- 2.7.9
- 2.7.8
- 2.7.7
- 2.7.6
- 2.7.5
- 2.7.4
- 2.7.3
- 2.7.2
- 2.7.1
- 2.7.0
- 2.6.0
- 2.5.4
- 2.5.3
- 2.5.2
- 2.5.1
- 2.5.0
- 2.4.2
- 2.4.1
- 2.4.0
- 2.3.2
- 2.3.1
- 2.3.0
- 2.2.0
- 2.1.6
- 2.1.5
- 2.1.4
- 2.1.3
- 2.0.2
- 2.0.1
- 2.0.0
- v1.x-dev
- 1.17.0
- 1.16.1
- 1.16.0
- 1.15.0
- 1.14.1
- 1.14.0
- 1.13.0
- 1.12.0
- 1.11.1
- 1.11.0
- 1.10.0
- 1.9.0
- 1.8.0
- 1.7.0
- 1.6.1
- 1.6.0
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.0
- 1.3.4
- 1.3.3
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.1
- 1.2.0
- 1.1.0
- 1.0.2
- 1.0.1
- 1.0.0
- 0.0.1
- dev-fix-guard-checks
This package is not auto-updated.
Last update: 2024-09-27 22:32:59 UTC
README
这是 spatie/laravel-permission 包的扩展版本,旨在处理多认证权限管理。
将用户与权限和角色关联
赞助商
此包允许您在数据库中管理用户权限和角色。
安装后,您可以进行如下操作
// Adding permissions to a user $user->givePermissionTo('edit articles'); // Adding permissions via a role $user->assignRole('writer'); $role->givePermissionTo('edit articles');
如果您使用多个守卫,我们也为您提供了支持。每个守卫都将有自己的权限和角色集,可以分配给守卫的用户。在 README 的使用多个守卫部分中了解相关信息。
由于所有权限都将注册在 Laravel 的 gate 上,因此您可以使用 Laravel 默认的 can
函数检查用户是否有权限
$user->can('edit articles');
Spatie 是一家位于比利时安特卫普的网页设计公司。您可以在我们的网站上找到所有开源项目的概述 在此处。
安装
Laravel
此包可用于 Laravel 5.4 或更高版本。如果您正在使用较旧的 Laravel 版本,请查看此包的 v1 分支。
您可以通过 composer 安装此包
composer require spatie/laravel-permission
在 Laravel 5.5 中,服务提供程序将自动注册。在框架的旧版本中,只需在 config/app.php
文件中添加服务提供程序即可
'providers' => [ // ... Spatie\Permission\PermissionServiceProvider::class, ];
您可以使用以下命令发布 迁移
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations"
如果您为 User
模型使用 UUID 或 GUID,则可以更新 create_permission_tables.php
迁移,并将 $table->unsignedBigInteger($columnNames['model_morph_key'])
替换为 $table->uuid($columnNames['model_morph_key'])
。为了保持一致性,您还可以更新包配置文件,将其改为使用 model_uuid
列名而不是默认的 model_id
列名。
发布迁移后,您可以通过运行迁移来创建角色和权限表
php artisan migrate
您可以使用以下命令发布配置文件
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="config"
发布后,config/permission.php 配置文件包含以下内容
return [ 'models' => [ /* * When using the "HasPermissions" trait from this package, we need to know which * Eloquent model should be used to retrieve your permissions. Of course, it * is often just the "Permission" model but you may use whatever you like. * * The model you want to use as a Permission model needs to implement the * `Spatie\Permission\Contracts\Permission` contract. */ 'permission' => Spatie\Permission\Models\Permission::class, /* * When using the "HasRoles" trait from this package, we need to know which * Eloquent model should be used to retrieve your roles. Of course, it * is often just the "Role" model but you may use whatever you like. * * The model you want to use as a Role model needs to implement the * `Spatie\Permission\Contracts\Role` contract. */ 'role' => Spatie\Permission\Models\Role::class, ], 'table_names' => [ /* * When using the "HasRoles" trait from this package, we need to know which * table should be used to retrieve your roles. We have chosen a basic * default value but you may easily change it to any table you like. */ 'roles' => 'roles', /* * When using the "HasPermissions" trait from this package, we need to know which * table should be used to retrieve your permissions. We have chosen a basic * default value but you may easily change it to any table you like. */ 'permissions' => 'permissions', /* * When using the "HasPermissions" trait from this package, we need to know which * table should be used to retrieve your models permissions. We have chosen a * basic default value but you may easily change it to any table you like. */ 'model_has_permissions' => 'model_has_permissions', /* * When using the "HasRoles" trait from this package, we need to know which * table should be used to retrieve your models roles. We have chosen a * basic default value but you may easily change it to any table you like. */ 'model_has_roles' => 'model_has_roles', /* * When using the "HasRoles" trait from this package, we need to know which * table should be used to retrieve your roles permissions. We have chosen a * basic default value but you may easily change it to any table you like. */ 'role_has_permissions' => 'role_has_permissions', ], 'column_names' => [ /* * Change this if you want to name the related model primary key other than * `model_id`. * * For example, this would be nice if your primary keys are all UUIDs. In * that case, name this `model_uuid`. */ 'model_morph_key' => 'model_id', ], /* * When set to true, the required permission/role names are added to the exception * message. This could be considered an information leak in some contexts, so * the default setting is false here for optimum safety. */ 'display_permission_in_exception' => false, 'cache' => [ /* * By default all permissions will be cached for 24 hours unless a permission or * role is updated. Then the cache will be flushed immediately. */ 'expiration_time' => 60 * 24, /* * The key to use when tagging and prefixing entries in the cache. */ 'key' => 'spatie.permission.cache', /* * When checking for a permission against a model by passing a Permission * instance to the check, this key determines what attribute on the * Permissions model is used to cache against. * * Ideally, this should match your preferred way of checking permissions, eg: * `$user->can('view-posts')` would be 'name'. */ 'model_key' => 'name', /* * You may optionally indicate a specific cache driver to use for permission and * role caching using any of the `store` drivers listed in the cache.php config * file. Using 'default' here means to use the `default` set in cache.php. */ 'store' => 'default', ], ];
Lumen
您可以通过 Composer 安装此包
composer require spatie/laravel-permission
复制所需的文件
mkdir -p config cp vendor/spatie/laravel-permission/config/permission.php config/permission.php cp vendor/spatie/laravel-permission/database/migrations/create_permission_tables.php.stub database/migrations/2018_01_01_000000_create_permission_tables.php
您还需要在 config/auth.php
中创建另一个配置文件。您可以在 Laravel 仓库中获取它,或者运行以下命令
curl -Ls https://raw.githubusercontent.com/laravel/lumen-framework/5.7/config/auth.php -o config/auth.php
然后,在 bootstrap/app.php
中注册中间件
$app->routeMiddleware([ 'auth' => App\Http\Middleware\Authenticate::class, 'permission' => Spatie\Permission\Middlewares\PermissionMiddleware::class, 'role' => Spatie\Permission\Middlewares\RoleMiddleware::class, ]);
以及配置文件、服务提供程序和缓存别名
$app->configure('permission'); $app->alias('cache', \Illuminate\Cache\CacheManager::class); // if you don't have this already $app->register(Spatie\Permission\PermissionServiceProvider::class);
现在,运行您的迁移
php artisan migrate
使用方法
首先,将 Spatie\Permission\Traits\HasRoles
特性添加到您的 User
模型(s)中
use Illuminate\Foundation\Auth\User as Authenticatable; use Spatie\Permission\Traits\HasRoles; class User extends Authenticatable { use HasRoles; // ... }
- 请注意,如果您需要将
HasRoles
特性与其他模型(如Page
)一起使用,您还需要将该模型的protected $guard_name = 'web';
也添加进去,否则您将收到错误。use Illuminate\Database\Eloquent\Model; use Spatie\Permission\Traits\HasRoles; class Page extends Model { use HasRoles; protected $guard_name = 'web'; // or whatever guard you want to use // ... }
此包允许用户关联权限和角色。每个角色都与多个权限相关联。一个 Role
和一个 Permission
都是常规的 Eloquent 模型。它们需要一个 name
,可以像这样创建:
use Spatie\Permission\Models\Role; use Spatie\Permission\Models\Permission; $role = Role::create(['name' => 'writer']); $permission = Permission::create(['name' => 'edit articles']);
可以使用以下其中一种方法将权限分配给角色:
$role->givePermissionTo($permission); $permission->assignRole($role);
可以使用以下其中一种方法将多个权限同步到角色:
$role->syncPermissions($permissions); $permission->syncRoles($roles);
可以使用以下其中一种方法从角色中删除权限:
$role->revokePermissionTo($permission); $permission->removeRole($role);
如果您使用多个守卫,还需要设置 guard_name
属性。在阅读说明中的 使用多个守卫 部分了解相关信息。
HasRoles
特性为您的模型添加了 Eloquent 关系,可以直接访问或用作基础查询。
// get a list of all permissions directly assigned to the user $permissions = $user->permissions; // get all permissions for the user, either directly, or from roles, or from both $permissions = $user->getDirectPermissions(); $permissions = $user->getPermissionsViaRoles(); $permissions = $user->getAllPermissions(); // get the names of the user's roles $roles = $user->getRoleNames(); // Returns a collection
HasRoles
特性还为您模型的模型添加了一个 role
范围,用于将查询范围到某些角色或权限。
$users = User::role('writer')->get(); // Returns only users with the role 'writer'
role
范围可以接受一个字符串、一个 \Spatie\Permission\Models\Role
对象或一个 \Illuminate\Support\Collection
对象。
相同的特性还添加了一个范围,仅获取具有特定权限的用户。
$users = User::permission('edit articles')->get(); // Returns only users with the permission 'edit articles' (inherited or directly)
该范围可以接受一个字符串、一个 \Spatie\Permission\Models\Permission
对象或一个 \Illuminate\Support\Collection
对象。
使用“直接”权限(下面将使用角色和权限两者)
可以将权限赋予任何用户
$user->givePermissionTo('edit articles'); // You can also give multiple permission at once $user->givePermissionTo('edit articles', 'delete articles'); // You may also pass an array $user->givePermissionTo(['edit articles', 'delete articles']);
可以从用户中撤销权限
$user->revokePermissionTo('edit articles');
或一次性撤销和添加新权限
$user->syncPermissions(['edit articles', 'delete articles']);
您可以使用以下方法检查用户是否具有权限
$user->hasPermissionTo('edit articles');
或者您也可以传递一个表示权限 ID 的整数
$user->hasPermissionTo('1'); $user->hasPermissionTo(Permission::find(1)->id); $user->hasPermissionTo($somePermission->id);
您还可以检查用户是否具有数组中任一权限
$user->hasAnyPermission(['edit articles', 'publish articles', 'unpublish articles']);
...或者检查用户是否具有数组中所有权限
$user->hasAllPermissions(['edit articles', 'publish articles', 'unpublish articles']);
您还可以通过权限 ID 传递整数来查找
$user->hasAnyPermission(['edit articles', 1, 5]);
保存的权限将注册到默认守卫的 Illuminate\Auth\Access\Gate
类。因此,您可以使用 Laravel 的默认 can
函数检查用户是否具有权限。
$user->can('edit articles');
通过角色使用权限
可以将角色分配给任何用户
$user->assignRole('writer'); // You can also assign multiple roles at once $user->assignRole('writer', 'admin'); // or as an array $user->assignRole(['writer', 'admin']);
可以从用户中移除角色
$user->removeRole('writer');
角色也可以同步
// All current roles will be removed from the user and replaced by the array given $user->syncRoles(['writer', 'admin']);
您可以确定用户是否具有特定角色
$user->hasRole('writer');
您也可以确定用户是否具有给定列表中的任一角色
$user->hasAnyRole(Role::all());
您也可以确定用户是否具有给定列表中的所有角色
$user->hasAllRoles(Role::all());
assignRole
、hasRole
、hasAnyRole
、hasAllRoles
和 removeRole
函数可以接受一个字符串、一个 \Spatie\Permission\Models\Role
对象或一个 \Illuminate\Support\Collection
对象。
可以将权限赋予角色
$role->givePermissionTo('edit articles');
您可以确定角色是否具有特定权限
$role->hasPermissionTo('edit articles');
可以从角色中撤销权限
$role->revokePermissionTo('edit articles');
givePermissionTo
和 revokePermissionTo
函数可以接受一个字符串或一个 Spatie\Permission\Models\Permission
对象。
权限会自动从角色继承。此外,还可以为用户分配单个权限。例如:
$role = Role::findByName('writer'); $role->givePermissionTo('edit articles'); $user->assignRole('writer'); $user->givePermissionTo('delete articles');
在上面的示例中,一个角色被赋予了编辑文章的权限,并且这个角色被分配给了用户。现在该用户可以编辑文章,并且还可以删除文章。'删除文章' 的权限是用户的直接权限,因为它是直接分配给他们的。当我们调用 $user->hasDirectPermission('delete articles')
时,它返回 true
,但 false
对 $user->hasDirectPermission('edit articles')
。
此方法适用于构建用于设置应用程序中角色和用户权限的表单,并希望限制或更改用户角色的继承权限,即仅允许更改用户的直接权限。
您可以列出所有这些权限
// Direct permissions $user->getDirectPermissions() // Or $user->permissions; // Permissions inherited from the user's roles $user->getPermissionsViaRoles(); // All permissions which apply on the user (inherited and direct) $user->getAllPermissions();
所有这些响应都是 Spatie\Permission\Models\Permission
对象的集合。
如果我们遵循前面的例子,第一个响应将包含“删除文章”权限的集合,第二个将包含“编辑文章”权限的集合,第三个将包含两者。
使用 Blade 指令
此包还添加了Blade指令以验证当前登录用户是否具有给定列表中的所有或任何角色。
可选地,您可以将检查将执行的 guard
作为第二个参数传递。
Blade和Roles
检查特定角色
@role('writer') I am a writer! @else I am not a writer... @endrole
等同于
@hasrole('writer') I am a writer! @else I am not a writer... @endhasrole
检查列表中的任何角色
@hasanyrole($collectionOfRoles) I have one or more of these roles! @else I have none of these roles... @endhasanyrole // or @hasanyrole('writer|admin') I am either a writer or an admin or both! @else I have none of these roles... @endhasanyrole
检查所有角色
@hasallroles($collectionOfRoles) I have all of these roles! @else I do not have all of these roles... @endhasallroles // or @hasallroles('writer|admin') I am both a writer and an admin! @else I do not have all of these roles... @endhasallroles
或者,使用 @unlessrole
来检查单个角色,如下所示
@unlessrole('does not have this role') I do not have the role @else I do have the role @endunlessrole
Blade和Permissions
此包不添加任何特定权限的Blade指令。相反,使用Laravel的本地 @can
指令来检查用户是否具有特定的权限。
@can('edit articles') // @endcan
或
@if(auth()->user()->can('edit articles') && $some_other_condition) // @endif
定义超级管理员
我们强烈建议通过设置全局 Gate::before
规则来处理超级管理员,该规则检查所需的角色。
然后,您可以在整个应用程序中主要使用基于权限的控制,而无需总是在每个地方检查“这是否是超级管理员”。
请参阅有关在您的应用程序中定义超级管理员门规则的维基文章:定义超级管理员门规则。
最佳实践 -- 角色与权限
通常,最好围绕 permissions
来编写应用程序的代码。这样,您可以在应用程序的任何地方始终使用本地的Laravel @can
和 can()
指令。
角色仍然可以用来分组权限以便于分配,如果确实需要,您仍然可以使用基于角色的辅助方法。但大多数应用程序相关的逻辑通常最好使用 can
方法来控制,这允许Laravel的Gate层做所有的繁重工作。
使用多个守卫
当使用默认的Laravel认证配置时,上述所有方法都将自动运行,无需额外配置。
但是,当使用多个守卫时,它们将像命名空间一样作用于您的权限和角色。这意味着每个守卫都有其自己的权限和角色集合,可以分配给其用户模型。
使用多个守卫的权限和角色
当创建新的权限和角色时,如果没有指定守卫,则将使用 auth.guards
配置数组中定义的第一个守卫。当为特定守卫创建权限和角色时,您必须在模型上指定其 guard_name
。
// Create a superadmin role for the admin users $role = Role::create(['guard_name' => 'admin', 'name' => 'superadmin']); // Define a `publish articles` permission for the admin users belonging to the admin guard $permission = Permission::create(['guard_name' => 'admin', 'name' => 'publish articles']); // Define a *different* `publish articles` permission for the regular users belonging to the web guard $permission = Permission::create(['guard_name' => 'web', 'name' => 'publish articles']);
检查用户是否有特定守卫的权限
$user->hasPermissionTo('publish articles', 'admin');
注意:在确定给定模型上的角色/权限是否有效时,它将按照以下顺序选择守卫:首先是模型的
$guard_name
属性;然后是配置中的守卫(通过提供者);然后是auth.guards
配置数组中定义的第一个守卫;然后是auth.defaults.guard
配置。
注意:当使用除默认的
web
守卫之外的其他守卫时,您需要通过在模型中设置$guard_name
属性来声明每个模型希望使用的guard_name
。每个模型一个最为简单。
注意:如果您的应用程序仅使用单个守卫,但不是
web
,则将您的守卫列表在config/app.php
中的顺序更改为主守卫作为默认值,并作为定义的守卫列表中的第一个。
将权限和角色分配给守卫用户
您可以使用上述描述的方法,通过角色分配权限和角色给用户,如使用角色通过权限中所述。只需确保权限或角色上的 guard_name
与用户的守卫匹配,否则会抛出 GuardDoesNotMatch
异常。
使用多个守卫的 blade 指令
您可以通过将希望使用的守卫作为指令的第二个参数传入来使用使用 blade 指令中列出的所有 blade 指令
@role('super-admin', 'admin') I am a super-admin! @else I am not a super-admin... @endrole
使用中间件
该软件包包含 RoleMiddleware
、PermissionMiddleware
和 RoleOrPermissionMiddleware
中间件。您可以在 app/Http/Kernel.php
文件中添加它们。
protected $routeMiddleware = [ // ... 'role' => \Spatie\Permission\Middlewares\RoleMiddleware::class, 'permission' => \Spatie\Permission\Middlewares\PermissionMiddleware::class, 'role_or_permission' => \Spatie\Permission\Middlewares\RoleOrPermissionMiddleware::class, ];
然后您可以使用中间件规则来保护您的路由
Route::group(['middleware' => ['role:super-admin']], function () { // }); Route::group(['middleware' => ['permission:publish articles']], function () { // }); Route::group(['middleware' => ['role:super-admin','permission:publish articles']], function () { // }); Route::group(['middleware' => ['role_or_permission:super-admin']], function () { // }); Route::group(['middleware' => ['role_or_permission:publish articles']], function () { // });
或者,您可以使用 |
(管道)字符分隔多个角色或权限
Route::group(['middleware' => ['role:super-admin|writer']], function () { // }); Route::group(['middleware' => ['permission:publish articles|edit articles']], function () { // }); Route::group(['middleware' => ['role_or_permission:super-admin|edit articles']], function () { // });
您也可以通过在构造函数中设置所需的中间件来类似地保护您的控制器
public function __construct() { $this->middleware(['role:super-admin','permission:publish articles|edit articles']); }
public function __construct() { $this->middleware(['role_or_permission:super-admin|edit articles']); }
捕获角色和权限失败
如果您想覆盖默认的 403
响应,您可以使用应用程序的异常处理器捕获 UnauthorizedException
public function render($request, Exception $exception) { if ($exception instanceof \Spatie\Permission\Exceptions\UnauthorizedException) { // Code here ... } return parent::render($request, $exception); }
使用 artisan 命令
您可以使用 artisan 命令从控制台创建角色或权限。
php artisan permission:create-role writer
php artisan permission:create-permission "edit articles"
当为特定守卫创建权限/角色时,您可以将守卫名称作为第二个参数指定
php artisan permission:create-role writer web
php artisan permission:create-permission "edit articles" web
在创建角色时,您还可以同时创建和链接权限
php artisan permission:create-role writer web "create articles|edit articles"
单元测试
在您的应用程序测试中,如果您不是将角色和权限作为测试 setUp()
部分的一部分进行播种,那么您可能会遇到一个“鸡生蛋”的情况,其中角色和权限没有与门(因为您的测试在门注册之后创建它们)注册。解决这个问题很简单:在您的测试中,只需添加一个 setUp()
指令来重新注册权限,如下所示
public function setUp() { // first include all the normal setUp operations parent::setUp(); // now re-register all the roles and permissions $this->app->make(\Spatie\Permission\PermissionRegistrar::class)->registerPermissions(); }
数据库种子
您可能会发现,在播种之前清除此软件包的缓存是最好的,以避免缓存冲突错误。这可以直接在播种器类中完成。以下是一个示例播种器,它首先清除缓存,然后创建权限,最后将权限分配给角色(这些步骤的顺序是有意的)
use Illuminate\Database\Seeder; use Spatie\Permission\Models\Role; use Spatie\Permission\Models\Permission; class RolesAndPermissionsSeeder extends Seeder { public function run() { // Reset cached roles and permissions app()[\Spatie\Permission\PermissionRegistrar::class]->forgetCachedPermissions(); // create permissions Permission::create(['name' => 'edit articles']); Permission::create(['name' => 'delete articles']); Permission::create(['name' => 'publish articles']); Permission::create(['name' => 'unpublish articles']); // create roles and assign created permissions // this can be done as separate statements $role = Role::create(['name' => 'writer']); $role->givePermissionTo('edit articles'); // or may be done by chaining $role = Role::create(['name' => 'moderator']) ->givePermissionTo(['publish articles', 'unpublish articles']); $role = Role::create(['name' => 'super-admin']); $role->givePermissionTo(Permission::all()); } }
扩展
如果您需要扩展现有的 Role
或 Permission
模型,请注意以下事项
- 您的
Role
模型需要扩展Spatie\Permission\Models\Role
模型 - 您的
Permission
模型需要扩展Spatie\Permission\Models\Permission
模型
如果您需要替换现有的 Role
或 Permission
模型,您需要记住以下事项
- 您的
Role
模型需要实现Spatie\Permission\Contracts\Role
接口 - 您的
Permission
模型需要实现Spatie\Permission\Contracts\Permission
接口
在这两种情况下,无论是扩展还是替换,您都需要在配置中指定您的新模型。为此,您必须在发布配置后更新配置文件中的 models.role
和 models.permission
值
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="config"
缓存
角色和权限数据被缓存以加快性能。
虽然我们建议不要更改缓存“键”名称,但如果您想更改过期时间,您可以在 config/permission.php
文件中的 cache
数组中这样做。请注意,从 v2.26.0 版本开始,这里的 cache
条目现在是一个数组,而 expiration_time
是一个子数组条目。
当您使用内置函数来操作角色和权限时,缓存会自动为您重置,并且当前模型记录的关系会自动重新加载
$user->assignRole('writer'); $user->removeRole('writer'); $user->syncRoles(params); $role->givePermissionTo('edit articles'); $role->revokePermissionTo('edit articles'); $role->syncPermissions(params); $permission->assignRole('writer'); $permission->removeRole('writer'); $permission->syncRoles(params);
但是,如果您直接在数据库中操作权限/角色数据而不是调用提供的函数,那么除非您手动重置缓存,否则您将看不到应用程序中反映出的更改。
手动缓存重置
要手动重置此软件包的缓存,您可以在应用程序代码中运行以下命令
$this->app->make(\Spatie\Permission\PermissionRegistrar::class)->forgetCachedPermissions();
或者,您可以使用 artisan 命令
php artisan permission:cache-reset
缓存标识符
提示:如果您正在使用缓存服务,例如redis
或memcached
,并且服务器上还运行着其他网站,您可能会遇到应用程序之间的缓存冲突。明智的做法是在Laravel的/config/cache.php
中为每个应用程序设置自己的缓存prefix
,这样就可以防止其他应用程序意外使用/更改您的缓存数据。
需要UI吗?
此包默认不包含任何界面,您应该自己构建。以下是一些启动选项
-
Caleb Oki提供的构建权限UI的详细教程
测试
composer test
升级
如果您从v1升级到v2,@fabricecw准备了一个gist,这可能有助于简化您的数据迁移。您还需要删除旧的laravel-permission.php
配置文件,发布新的permission.php
文件,并相应地进行编辑。
更新日志
有关最近更改的详细信息,请参阅更新日志。
贡献
有关详细信息,请参阅贡献指南。
安全
如果您发现任何与安全相关的问题,请通过电子邮件freek@spatie.be联系我们,而不是使用问题跟踪器。
明信片软件
您可以使用此包,但如果它进入了您的生产环境,我们非常感激您从家乡给我们寄来一张明信片,并说明您正在使用我们的哪些包。
我们的地址是:Spatie,Samberstraat 69D,2060 安特卫普,比利时。
我们将发布收到的所有明信片在我们的公司网站上。
致谢
此包主要基于Jeffrey Way关于权限和角色的出色Laracasts课程。他的原始代码可以在GitHub上的此存储库中找到。
特别感谢Alex Vanderbist在v2
中的大力帮助,以及Chris Brown长期的支持,帮助我们维护此包。
替代方案
- Povilas Korop在Laravel News的一篇文章中列出了替代方案。在同一篇文章中,他比较了laravel-permission与Joseph Silber的Bouncer,我们认为这也是一个出色的包。
- ultraware/roles采用了对其功能的不同方法。
支持我们
Spatie是一家位于比利时的安特卫普网络设计公司。您可以在我们的网站上找到我们所有开源项目的概述。
您的业务是否依赖于我们的贡献?请通过 Patreon 支持我们。所有承诺都将用于分配人力维护和开发新的精彩功能。
许可证
MIT 许可证(MIT)。有关更多信息,请参阅 许可证文件。