Direct Permissions | laravel-permission | Spatie SPATIE Laravel Permission ===================== spatie.be/open-source [Docs](https://spatie.be/docs) [Laravel-permission](https://spatie.be/docs/laravel-permission/v4) Basic-usage Direct Permissions 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) Direct Permissions - [ Introduction ](https://spatie.be/docs/laravel-permission/v4/introduction) - [ Support us ](https://spatie.be/docs/laravel-permission/v4/support-us) - [ Prerequisites ](https://spatie.be/docs/laravel-permission/v4/prerequisites) - [ Installation in Laravel ](https://spatie.be/docs/laravel-permission/v4/installation-laravel) - [ Installation in Lumen ](https://spatie.be/docs/laravel-permission/v4/installation-lumen) - [ Upgrading ](https://spatie.be/docs/laravel-permission/v4/upgrading) - [ Questions and issues ](https://spatie.be/docs/laravel-permission/v4/questions-issues) - [ Changelog ](https://spatie.be/docs/laravel-permission/v4/changelog) - [ About us ](https://spatie.be/docs/laravel-permission/v4/about-us) Basic Usage ----------- - [ Basic Usage ](https://spatie.be/docs/laravel-permission/v4/basic-usage/basic-usage) - [ Direct Permissions ](https://spatie.be/docs/laravel-permission/v4/basic-usage/direct-permissions) - [ Using Permissions via Roles ](https://spatie.be/docs/laravel-permission/v4/basic-usage/role-permissions) - [ Wildcard permissions ](https://spatie.be/docs/laravel-permission/v4/basic-usage/wildcard-permissions) - [ Blade directives ](https://spatie.be/docs/laravel-permission/v4/basic-usage/blade-directives) - [ Defining a Super-Admin ](https://spatie.be/docs/laravel-permission/v4/basic-usage/super-admin) - [ Using multiple guards ](https://spatie.be/docs/laravel-permission/v4/basic-usage/multiple-guards) - [ Using artisan commands ](https://spatie.be/docs/laravel-permission/v4/basic-usage/artisan) - [ Using a middleware ](https://spatie.be/docs/laravel-permission/v4/basic-usage/middleware) - [ Example App ](https://spatie.be/docs/laravel-permission/v4/basic-usage/new-app) Best Practices -------------- - [ Roles vs Permissions ](https://spatie.be/docs/laravel-permission/v4/best-practices/roles-vs-permissions) - [ Model Policies ](https://spatie.be/docs/laravel-permission/v4/best-practices/using-policies) - [ Performance Tips ](https://spatie.be/docs/laravel-permission/v4/best-practices/performance) Advanced usage -------------- - [ Testing ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/testing) - [ Database Seeding ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/seeding) - [ Exceptions ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/exceptions) - [ Extending ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/extending) - [ Cache ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/cache) - [ UUID ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/uuid) - [ PhpStorm Interaction ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/phpstorm) - [ Other ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/other) - [ Timestamps ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/timestamps) - [ UI Options ](https://spatie.be/docs/laravel-permission/v4/advanced-usage/ui-options) You are viewing the documentation for **an older version** of this package. You can check the version you are using with the following command: ` composer show spatie/laravel-permission ` Direct Permissions ================== A permission can be given to any user: ``` $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']); ``` A permission can be revoked from a user: ``` $user->revokePermissionTo('edit articles'); ``` Or revoke & add new permissions in one go: ``` $user->syncPermissions(['edit articles', 'delete articles']); ``` You can check if a user has a permission: ``` $user->hasPermissionTo('edit articles'); ``` Or you may pass an integer representing the permission id ``` $user->hasPermissionTo('1'); $user->hasPermissionTo(Permission::find(1)->id); $user->hasPermissionTo($somePermission->id); ``` You can check if a user has Any of an array of permissions: ``` $user->hasAnyPermission(['edit articles', 'publish articles', 'unpublish articles']); ``` ...or if a user has All of an array of permissions: ``` $user->hasAllPermissions(['edit articles', 'publish articles', 'unpublish articles']); ``` You may also pass integers to lookup by permission id ``` $user->hasAnyPermission(['edit articles', 1, 5]); ``` Saved permissions will be registered with the `Illuminate\Auth\Access\Gate` class for the default guard. So you can check if a user has a permission with Laravel's default `can` function: ``` $user->can('edit articles'); ``` A good match? ------------- ### What we do best - All things Laravel - Custom frontend components - Building APIs - AI-powered features - Simplifying things - Clean solutions - Integrating services ### Not our cup of tea - WordPress themes - Cutting corners - Free mockups to win a job - "Just execute the briefing" In short: we'd like to be a **substantial part** of your project. [ Get in touch via email ](mailto:info@spatie.be?subject=A%20good%20match%21&body=Tell%20us%20as%20much%20as%20you%20can%20about%0A-%20your%20online%20project%0A-%20your%20planning%0A-%20your%20budget%0A-%20%E2%80%A6%0A%0AAnything%20that%20helps%20us%20to%20start%20straightforward%21)