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

Using artisan commands

On this page

  1. Creating roles and permissions with Artisan Commands
  2. Displaying roles and permissions in the console
  3. Resetting the Cache

You can create a role or permission from the console with artisan commands.

php artisan permission:create-role writer

php artisan permission:create-permission "edit articles"

When creating permissions/roles for specific guards you can specify the guard names as a second argument:

php artisan permission:create-role writer web

php artisan permission:create-permission "edit articles" web

When creating roles you can also create and link permissions at the same time:

php artisan permission:create-role writer web "create articles|edit articles"

When creating roles with teams enabled you can set the team id by adding the --team-id parameter:

php artisan permission:create-role --team-id=1 writer
php artisan permission:create-role writer api --team-id=1

There is also a show command to show a table of roles and permissions per guard:

php artisan permission:show

When you use the built-in functions for manipulating roles and permissions, the cache is automatically reset for you, and relations are automatically reloaded for the current model record.

See the Advanced-Usage/Cache section of these docs for detailed specifics.

If you need to manually reset the cache for this package, you may use the following artisan command:

php artisan permission:cache-reset

Again, it is more efficient to use the API provided by this package, instead of manually clearing the cache.

Using multiple guards
Example App
Help us improve this page