README

Gestion des rôles et permissions pour Laravel 11/12 avec interface d'administration intégrée.

Installation

composer require MecenePhrygien/laravel-acl
php artisan vendor:publish --tag=acl-config
php artisan vendor:publish --tag=acl-migrations
php artisan migrate

Configuration rapide

// app/Models/User.php
use MecenePhrygien\LaravelAcl\Traits\HasRolesAndPermissions;
use MecenePhrygien\LaravelAcl\Contracts\HasAcl;

class User extends Authenticatable implements HasAcl
{
    use HasRolesAndPermissions;
}

Interface d'administration

Accessible sur /acl après connexion :

Personnaliser dans config/acl.php :

'ui' => [
    'enabled'    => true,
    'prefix'     => 'acl',
    'middleware' => ['web', 'auth', 'role:admin'],
],

Utilisation

$user->assignRole('admin');
$user->removeRole('vendor');
$user->syncRoles(['vendor', 'editor']);

$user->hasRole('admin');                    // true
$user->hasAnyRole(['admin', 'vendor']);     // true
$user->hasPermission('products.edit');      // true
$user->hasAllPermissions(['p1', 'p2']);     // true

Middlewares

Route::middleware('role:admin')->group(...);
Route::middleware('permission:products.edit')->group(...);
Route::middleware('role_or_permission:admin,orders.view')->group(...);