55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
---
|
|
title: Using artisan commands
|
|
weight: 7
|
|
---
|
|
|
|
## Creating roles and permissions with Artisan Commands
|
|
|
|
You can create a role or permission from the console with artisan commands.
|
|
|
|
```bash
|
|
php artisan permission:create-role writer
|
|
```
|
|
|
|
```bash
|
|
php artisan permission:create-permission "edit articles"
|
|
```
|
|
|
|
When creating permissions/roles for specific guards you can specify the guard names as a second argument:
|
|
|
|
```bash
|
|
php artisan permission:create-role writer web
|
|
```
|
|
|
|
```bash
|
|
php artisan permission:create-permission "edit articles" web
|
|
```
|
|
|
|
When creating roles you can also create and link permissions at the same time:
|
|
|
|
```bash
|
|
php artisan permission:create-role writer web "create articles|edit articles"
|
|
```
|
|
|
|
## Displaying roles and permissions in the console
|
|
|
|
There is also a `show` command to show a table of roles and permissions per guard:
|
|
|
|
```bash
|
|
php artisan permission:show
|
|
```
|
|
|
|
## Resetting the Cache
|
|
|
|
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:
|
|
|
|
```bash
|
|
php artisan permission:cache-reset
|
|
```
|
|
|
|
Again, it is more efficient to use the API provided by this package, instead of manually clearing the cache.
|