Maravel Permissions Package for Laravel

June 02, 2020 / Paul Redmond

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.