Maravel Permissions Package for Laravel

Packages

June 2nd, 2020

marvel-permissions-featured.png

Maravel Permissions is a package by Inani El Houssain that provides permissions in Laravel using superhero jargon. The package helps you grant users abilities, but in a fun, superhero kind of way.

Because every user deserves to be a hero, The Maravel API is based on superhero jargon:

// Having a user
$user = User::first();

// Create a new marvel
$storm = Spectre::create('storm')->havingPower([
    'weather_manipulation',
      'earth_telepathy',
      'high_sens',
      'see_the_future'
]);

// we can grant a power to it
$storm = Spectre::of($storm)->grant('flying');

// Or take it off
$storm = Spectre::of($storm)->takeOff('see_the_future');


// bless the user with the abilities of the marvel
$user->cerebro()->blessWith($storm);


// check if it has the ability
$user->cerebro()->owns('weather_manipulation');

// check if it has one of the provided abilities
$user->cerebro()->ownsOneOf([
    'earth_telepathy',
      'flying',
      'x-ray',
]);

// make it human again (remove its role)
$user->cerebro()->humanize();

Further, here are more examples from the readme, demonstrating how to manage the instances directly:

// Create Ability
$ability = Ability::create([
    'super_power' => 'speed'
]);

// Create a Marvel
$marvel = Marvel::create([
    'name' => 'Cristiano Ronaldo'
]);

// Grant the ability
$marvel->grant($ability);

// remove a certain ability
$marvel->takeOff($ability);

// remove all and keep only those
$marvel->keep($abilities);

// bless it to our user
$user->cerebro()->blessWith($marvel);

Tests are planned for this package, feel free to jump in and contribute. You can learn more about this package, get full installation instructions, and view the source code on GitHub at akiyamaSM/maravel-permissions.

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.