README

Provides a console interface to Entrust for Laravel

Currently this package only supports Entrust for Laravel 5.

Requirements

You must have Entrust installed and working before attempting to use Entrust-Cli.

Before using Entrust-Cli you must have the Entrust service provider and alias configured.

'providers' => [
    ...
    Zizaco\Entrust\EntrustServiceProvider::class,
    ...
],
'aliases' => [
    ...
     'Entrust'   => Zizaco\Entrust\EntrustFacade::class,
    ...
],

You must also have the Entrust database tables created.

php artisan entrust:migration
php artisan migrate

Visit the Entrust GitHub for more information on installing and configuring Entrust.

Installation

Install the latest version with

$ composer require linearsoft/entrust-cli

Then in your config/app.php you must add

    LinearSoft\EntrustCli\EntrustCliServiceProvider::class,

to your providers array.

Usage

Entrust-Cli adds the following artisan commands

php artisan list
 ...
 entrust-cli
  entrust-cli:permission:attach  Add a permission to an Entrust role
  entrust-cli:permission:create  Create an Entrust permission
  entrust-cli:permission:delete  Delete an Entrust permission
  entrust-cli:permission:detach  Remove a permission from an Entrust role
  entrust-cli:permission:list    List all Entrust permissions
  entrust-cli:role:attach        Add an Entrust role to a user
  entrust-cli:role:create        Create an Entrust role
  entrust-cli:role:delete        Delete an Entrust role
  entrust-cli:role:detach        Remove an Entrust role from a user
  entrust-cli:role:info          Show details for an Entrust role
  entrust-cli:role:list          List all Entrust role
  
 ...

Command	Action	Parameters	Example
`*:create`	Creates a role/permission	name [display name] [description]	`entrust-cli:role:create myrole "My Role"`
`*:delete`	Deletes a role/permission	name	`entrust-cli:permission:delete perm1`
`*:list`	Lists all roles/permissions	none	`entrust-cli:role:list`
`permission:attach`	Attaches a permission to a role	permission_name role_name	`entrust-cli:permission:attach perm1 myrole`
`permission:detach`	Detaches a permission from a role	permission_name role_name	`entrust-cli:permission:detach perm1 myrole`
`role:info`	Provides detailed role info (perms/users)	role_name	`entrust-cli:role:info myrole`
`role:attach`	Attaches a role to a user	role_name identity [--attr=]	`entrust-cli:role:attach myrole user2@gmail.com`
`role:detach`	Detaches a role from a user	role_name identity [--attr=]	`entrust-cli:role:detach myrole user2`

User Identity

Entrust-Cli does not know for certain what attribute your application uses to lookup user records. By default it will check for an email attribute and then fail-over to a username. If your User model does not use either one of these you must manually specify which attribute to search on:

entrust-cli:role:attach myrole "John Doe" --attr=name
entrust-cli:role:attach myrole 8846811346 --attr=barcode

About

Bugs or features requests

Found a problem or would like a feature submit it via GitHub

License

Entrust-Cli is licensed under the GPLv3 License - see the LICENSE file for details

linearsoft / entrust-cli

Maintainers

Details