Usuario:ManuelRomero/Laravel/Roles
Contenido
Qué es un sistema de roles
$roles= auth()->user()->getRoleNames()
$rol= auth()->user()->getRoleNames()[0]
@hasanyrole(["gestor","administrador"]) ..... @elsehasanyrole ........ @endhasanyrole
|
- Es una utilidad que suelen tener muchas aplicaciónes donde hay diferentes secciones en nuestro sistema
- Es algo muy típico y muy bien implementado en los csm, que básicamente consiste en:
1.- Te identificas en el sistema |
- Para este post, vamos a implementar un ejemplo de una aplicación donde tenemos la siguiente situación.
- Una app que gestiona a nivel de CRUD las sigueintes tablas
- Y queremos establecer el siguiente sistema de permisos que pretende dejar claro el diagrama siguiente
Paquetes para gestionar roles en Laravel
- Vamos a utilizar el paquete laravel-permission para gestionar estas acciones en nuestro proyecto (A la fecha de este post la versión de este paquete es la V5.9)
- Lo primero que necesitamos es tener una aplicación desarrollada.
- Vamos a realizar una donde tengamos el siguiente esquema.
- Por supuesto en nuestra aplicación el usuario se tiene que autentificar para acceder
- En nuestra aplicación vamos a gestionar Facturas y Clientes pudiendo un cliente tener varias facturas y pudiendo ser una factura de hasta 6 clientes. Por otro lado gestionamos Empleados e Idiomas que habla cada empleado, siendo éste un atributo multivaluado que mostramos en tabla
1.- Crear modelos, crontroladores, migraciones, seeder y factory y resources para cada elemento
2.- Creemos el crud de, por ejemplos las facturas
3.- Activamos el sistema de autenticación de laravel con
- Ahora agregamos o instalamos el paquete en nuestro proyecto
composer require spatie/laravel-permission
- Para que autocomplete en phpstorm los métodos
- Las opciones se pueden encontrar en File->Setting->PHP->Blade
https://spatie.be/docs/laravel-permission/v5/advanced-usage/phpstorm
- Una vez que tenemos creada la aplicación vamos a realizar los roles y permisos
Creamos un seeder para poblar los roles y permisos
php artisan make:seed RoleSeeder
- Registramos el proveedor de servicios añadiendolo en el fichero config/app.php
'providers' => [ // ... Spatie\Permission\PermissionServiceProvider::class, ];
- Publicamos la migración y el fichero de configuración de 'permission config/permission.php:
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
- Borramos si lo tuviéramos cacheada la cofiguracioń de los ficheros, habría que borrarla para que la vuelva a cargar
php artisan optimize:clear
# or
php artisan config:clear
- Ejecutamos las migraciones
php artisan migrate
- Observamos que ha creado las siguientes tablas
- Tenemos roles y permisos. Cada rol tendrá asociado permisos (uno o varios) y a su vez, cada permiso tendrá asociado roles (1 o varios), por eso la tabla role_has_permissions.
ejemplos de roles y permisos
| |
administrador o contabilidad o alumno ...
all_facturas (representaría todos los permisos en la tabla(modelo) facturas) read_faturas (representaría que solo se puede leer la tabla(modelo) facturas)
|
Tanto los permisos, como los roles, se asocia a modelos (tablas model_has_roles, model_has_permissons).
- Creamos las tablas con las migraciones creadas
- role_has_permissions
- model_has_roles
- model_has_permissions
- roles
- permissions
- La siguiente imagen muestra las tablas relacionadas
- Este paquete implementa un trait HasRoles (https://diego.com.es/traits-en-php) el cual hay que incorporar a la tabla User, ya que se pretende dar a cada usuario permisos específicos o grupo de permisos (roles)
... use Spatie\Permission\Traits\HasRoles; class User extends Authenticatable { use Notifiable, HasRoles; ... }
Creando Roles y Permisos
- Ahora tendremos que crear los roles y permisos, según necesitemos en nuestra aplicación
- Como hemos comentado un Rol, puede tener asociado uno o varios permisos, cada uno de los cuales puede estar asociado a uno o varios roles.
- Siguiendo con nuestro ejemplo, vamos a crear 3 roles:
use Spatie\Permission\Models\Role; use Spatie\Permission\Models\Permission; $role = Role::create(['name' => 'administrador']); $role = Role::create(['name' => 'gestor']); $role = Role::create(['name' => 'comercial']); $permission = Permission::create(['name' => 'edit articles']);
- Este código lo tendremos que ejecutar cuando queramos crear el roll, en un controlador. Pero muchas veces, la creación de roles, no será algo dinámico en nuestra aplicación, otras veces sí.
- Suponemos que queremos tener creados estos tres roles, y ya no se van a crear más. Para ello lo mejor es crear un seeder que alimente la tabla de roles con estos valores.
- Usamos el seeder creado previamente en este ejemplo (si no lo existiera lo tendríamos que crear)
php artisan make:seeder RolesSeeder
- Editamos el fichero que se ha creado database/seeders/RoleSeeder.php
public function run() { $roles =["administrador","profesor", "alulmno"]; foreach ($roles as $role) { Role::create(["name"=>$role]); } // }
- Y para ejecutarlo modificamos el método Run de la clase DatabaseSeeder.php
public function run() { $this->call([ RoleSeeder::class ]); }
- Ahora ya podemos ejectuarlo
php artisan db:seed
- O bien establecer toda la carga completa de la base de datos
php artisan migrate:fresh --seed
Creando Roles y Permisos
Asignando roles a un usuario
- Vamos a crear un usuario para cada uno de los grupos
- Otra práctica sería que al crearse un usuario, no tenga ningún rol asignado (o se podría crear uno muy básico)
- Posteriormente el adminsitrador/a de la aplicación le podrá asignar un rol, o podrá modificar los roles de los usuarios
- Vamos con la primera parte
Crear un usuario para cada roll en la aplicación
- Creamos un seed para usuarios
php artisan make:seed SeedUsers
- Lo poblamos con valores y le asignamos roles
- Hay que tener en cuenta que este seeder, habrá que ejecutarlo después de que se hayan creado los roles y permisos
- En este caso, no hace falta permisos, ya que vamos a gestionar el ejemplo solo con roles como se puede ver en la imagen anterior
php artisan make:seed SeedUsers
- Y establecemos la población de usuarios (creamos 3 usuarios)
public function run(): void { // $datos=[ 'name' => 'administrador', 'email' => 'a@a.com', 'email_verified_at' => now(), 'password' => bcrypt('12345678'), // password 'remember_token' => Str::random(10), ]; $user = new User($datos); $user->assignRole('administrador'); $user->saveOrFail(); $datos=[ 'name' => 'comercial', 'email' => 'c@c.com', 'email_verified_at' => now(), 'password' => bcrypt('12345678'), // password 'remember_token' => Str::random(10), ]; $user = new User($datos); $user->assignRole('comercial'); $user->saveOrFail(); $datos=[ 'name' => 'gestor', 'email' => 'g@g.com', 'email_verified_at' => now(), 'password' => bcrypt('12345678'), // password 'remember_token' => Str::random(10), ]; $user = new User($datos); $user->assignRole('gestor'); $user->saveOrFail(); }
.....
- Ahora hay que proteger las páginas y obligar a que el usuario se registre con el middleware auth
- En lugar de proteger cada ruta, establecemos un grupo
Route::middleware('auth')->group(function () { Route::resource("clientes", \App\Http\Controllers\ClienteController::class); Route::resource("facturas", \App\Http\Controllers\FacturaController::class); Route::resource("empleados", \App\Http\Controllers\EmpleadoController::class); Route::view('/', 'acceso')->name("main"); });
Administrar los roles en la propia aplicación
Cremos los tres usuarios
- En el modelo especificamos que vamos a usar roles especificando que vamos a usar HasRoles
class User extends Authenticatable { //.... use HasRoles; //... }