Enums | laravel-permission | Spatie SPATIE Laravel Permission ===================== spatie.be/open-source [Docs](https://spatie.be/docs) [Laravel-permission](https://spatie.be/docs/laravel-permission/v7) Basic-usage Enums Version v7 v6 v5 v4 v3 Other versions for crawler [v7](https://spatie.be/docs/laravel-permission/v7) [v6](https://spatie.be/docs/laravel-permission/v6) [v5](https://spatie.be/docs/laravel-permission/v5) [v4](https://spatie.be/docs/laravel-permission/v4) [v3](https://spatie.be/docs/laravel-permission/v3) - [ Introduction ](https://spatie.be/docs/laravel-permission/v7/introduction) - [ Support us ](https://spatie.be/docs/laravel-permission/v7/support-us) - [ Prerequisites ](https://spatie.be/docs/laravel-permission/v7/prerequisites) - [ Installation in Laravel ](https://spatie.be/docs/laravel-permission/v7/installation-laravel) - [ Upgrading ](https://spatie.be/docs/laravel-permission/v7/upgrading) - [ Questions and issues ](https://spatie.be/docs/laravel-permission/v7/questions-issues) - [ Changelog ](https://spatie.be/docs/laravel-permission/v7/changelog) - [ About us ](https://spatie.be/docs/laravel-permission/v7/about-us) Basic Usage ----------- - [ Basic Usage ](https://spatie.be/docs/laravel-permission/v7/basic-usage/basic-usage) - [ Direct Permissions ](https://spatie.be/docs/laravel-permission/v7/basic-usage/direct-permissions) - [ Using Permissions via Roles ](https://spatie.be/docs/laravel-permission/v7/basic-usage/role-permissions) - [ Enums ](https://spatie.be/docs/laravel-permission/v7/basic-usage/enums) - [ Teams permissions ](https://spatie.be/docs/laravel-permission/v7/basic-usage/teams-permissions) - [ Wildcard permissions ](https://spatie.be/docs/laravel-permission/v7/basic-usage/wildcard-permissions) - [ Blade directives ](https://spatie.be/docs/laravel-permission/v7/basic-usage/blade-directives) - [ Defining a Super-Admin ](https://spatie.be/docs/laravel-permission/v7/basic-usage/super-admin) - [ Using multiple guards ](https://spatie.be/docs/laravel-permission/v7/basic-usage/multiple-guards) - [ Artisan Commands ](https://spatie.be/docs/laravel-permission/v7/basic-usage/artisan) - [ Middleware ](https://spatie.be/docs/laravel-permission/v7/basic-usage/middleware) - [ Passport Client Credentials Grant usage ](https://spatie.be/docs/laravel-permission/v7/basic-usage/passport) - [ Example App ](https://spatie.be/docs/laravel-permission/v7/basic-usage/new-app) Best Practices -------------- - [ Roles vs Permissions ](https://spatie.be/docs/laravel-permission/v7/best-practices/roles-vs-permissions) - [ Model Policies ](https://spatie.be/docs/laravel-permission/v7/best-practices/using-policies) - [ Performance Tips ](https://spatie.be/docs/laravel-permission/v7/best-practices/performance) Advanced usage -------------- - [ Testing ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/testing) - [ Database Seeding ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/seeding) - [ Exceptions ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/exceptions) - [ Extending ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/extending) - [ Cache ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/cache) - [ Events ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/events) - [ Custom Permission Check ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/custom-permission-check) - [ UUID/ULID ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/uuid) - [ PhpStorm Interaction ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/phpstorm) - [ Other ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/other) - [ Timestamps ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/timestamps) - [ UI Options ](https://spatie.be/docs/laravel-permission/v7/advanced-usage/ui-options) Enums ===== ### On this page 1. [ Enum Prerequisites ](#content-enum-prerequisites) 2. [ Code Requirements ](#content-code-requirements) 3. [ Creating Roles/Permissions using Enums ](#content-creating-rolespermissions-using-enums) 4. [ Package methods supporting BackedEnums: ](#content-package-methods-supporting-backedenums) Enum Prerequisites -------------------------------------------------------------------------------------------------------------- Internally, Enums implicitly implement `\BackedEnum`, which is how this package recognizes that you're passing an Enum. NOTE: Presently (versions 6, 7) this package does not support using `$casts` to specify enums on the `Permission` model. You can still use enums to reference things as shown below, just without declaring it in a `$casts` property. Code Requirements ----------------------------------------------------------------------------------------------------------- You can create your Enum object for use with Roles and/or Permissions. You will probably create separate Enums for Roles and for Permissions, although if your application needs are simple you might choose a single Enum for both. Usually the list of application Roles is much shorter than the list of Permissions, so having separate objects for them can make them easier to manage. Here is an example Enum for Roles. You would do similarly for Permissions. ``` namespace App\Enums; enum RolesEnum: string { // case NAMEINAPP = 'name-in-database'; case WRITER = 'writer'; case EDITOR = 'editor'; case USERMANAGER = 'user-manager'; // extra helper to allow for greater customization of displayed values, without disclosing the name/value data directly public function label(): string { return match ($this) { static::WRITER => 'Writers', static::EDITOR => 'Editors', static::USERMANAGER => 'User Managers', }; } } ``` Creating Roles/Permissions using Enums ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ When **creating** roles/permissions, you cannot pass an Enum name directly, because Eloquent expects a string for the name. Use Laravel's `enum_value()` function for simplicity: ``` $role = app(Role::class)->findOrCreate(enum_value(RolesEnum::WRITER), 'web'); ``` Same with creating Permissions. ### Authorizing using Enums In your application code, when checking for authorization using features of this package, you can use `MyEnum::NAME` directly in most cases, without passing `->value` to convert to a string. There may occasionally be times where you will need to manually fallback to adding `->value` (eg: `MyEnum::NAME->value`) when using features that aren't aware of Enum support, such as when you need to pass `string` values instead of an `Enum` to a function that doesn't recognize Enums. Again, wrap it with `enum_value()` as a simple workaround. Examples: ``` // the following are identical because `hasPermissionTo` is aware of `BackedEnum` support: $user->hasPermissionTo(PermissionsEnum::VIEWPOSTS); $user->hasPermissionTo(PermissionsEnum::VIEWPOSTS->value); $user->hasPermissionTo(enum_value(PermissionsEnum::VIEWPOSTS)); // Blade directives: @can(enum_value(PermissionsEnum::VIEWPOSTS)) ``` Package methods supporting BackedEnums: --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- The following methods of this package support passing `BackedEnum` parameters directly: ``` $user->assignRole(RolesEnum::WRITER); $user->removeRole(RolesEnum::EDITOR); $role->givePermissionTo(PermissionsEnum::EDITPOSTS); $role->revokePermissionTo(PermissionsEnum::EDITPOSTS); $user->givePermissionTo(PermissionsEnum::EDITPOSTS); $user->revokePermissionTo(PermissionsEnum::EDITPOSTS); $user->hasPermissionTo(PermissionsEnum::EDITPOSTS); $user->hasAnyPermission([PermissionsEnum::EDITPOSTS, PermissionsEnum::VIEWPOSTS]); $user->hasDirectPermission(PermissionsEnum::EDITPOSTS); $user->hasRole(RolesEnum::WRITER); $user->hasAllRoles([RolesEnum::WRITER, RolesEnum::EDITOR]); $user->hasExactRoles([RolesEnum::WRITER, RolesEnum::EDITOR, RolesEnum::MANAGER]); ```