This is the documentation for v4 but the latest version is v5 . You can switch versions in the menu at the top. Check your current version 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"

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.