Panduan Laravel Spatie Permission: Role & Permission Mudah untuk Pemula

Abd. Asis
Panduan Laravel Spatie Permission: Role & Permission Mudah untuk Pemula

Pernah nggak sih kamu bingung gimana cara membatasi akses user di aplikasi Laravel? Misal, cuma admin yang boleh edit data, atau user biasa hanya bisa lihat saja. Nah, di dunia Laravel, ada satu package super populer yang bisa bikin urusan role & permission jadi gampang banget: Spatie Laravel Permission.

Artikel ini bakal membimbing kamu dari nol sampai paham cara setup, pakai, dan best practice permission di Laravel. Semua dijelaskan dengan bahasa santai, analogi sehari-hari, dan contoh kode yang bisa langsung dicoba. Yuk, mulai!

Kenapa Perlu Role & Permission?

Bayangin aplikasi seperti sekolah online. Ada admin, guru, dan murid. Tentu hak akses mereka beda-beda, kan? Dengan role & permission, kamu bisa atur siapa boleh apa, tanpa ribet cek manual di setiap controller.

Persiapan: Instalasi & Setup

  1. Install package
BashBASH
composer require spatie/laravel-permission
  1. Publish config & migration
BashBASH
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
  1. Jalankan migration
BashBASH
php artisan migrate
  1. Tambahkan trait di model User
PHPPHP
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasRoles;
    // ...
}

Membuat Role & Permission

PHPPHP
use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;

$role = Role::create(['name' => 'admin']);
$permission = Permission::create(['name' => 'edit articles']);

Assign Role & Permission ke User

PHPPHP
$user = User::find(1);
$user->assignRole('admin');
$user->givePermissionTo('edit articles');

Cek Role & Permission di Controller/Blade

PHPPHP
// Cek di controller
if ($user->hasRole('admin')) {
    // ...
}
if ($user->can('edit articles')) {
    // ...
}

// Di Blade
@can('edit articles')
    <button>Edit</button>
@endcan

Middleware Proteksi Route

PHPPHP
// Di routes/web.php
Route::group(['middleware' => ['role:admin']], function () {
    // hanya admin
});
Route::group(['middleware' => ['permission:edit articles']], function () {
    // hanya yang punya permission
});
Route::group(['middleware' => ['role_or_permission:admin|edit articles']], function () {
    // admin atau yang punya permission
});

Seeder Role & Permission (Contoh Praktis)

PHPPHP
use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;
use Spatie\Permission\PermissionRegistrar;

class PermissionsDemoSeeder extends Seeder
{
    public function run(): void
    {
        app()[PermissionRegistrar::class]->forgetCachedPermissions();
        Permission::create(['name' => 'edit articles']);
        Permission::create(['name' => 'delete articles']);
        $roleAdmin = Role::create(['name' => 'admin']);
        $roleAdmin->givePermissionTo(['edit articles', 'delete articles']);
        $user = \App\Models\User::factory()->create([
            'name' => 'Admin',
            'email' => '[email protected]',
        ]);
        $user->assignRole($roleAdmin);
    }
}

Query User Berdasarkan Role/Permission

PHPPHP
// Semua user dengan role tertentu
$users = User::role('admin')->get();
// User dengan permission tertentu
$users = User::permission('edit articles')->get();
// User tanpa role
$users = User::doesntHave('roles')->get();

Best Practice & Tips

  • Gunakan permission, bukan hanya role. Permission lebih fleksibel dan mudah diatur.
  • Cache permission otomatis. Package ini sudah handle cache, tapi kalau develop, bisa clear cache dengan:
BashBASH
php artisan optimize:clear
  • Integrasi dengan Enum (Laravel 9+):
PHPPHP
$user->hasPermissionTo(PermissionsEnum::EDITPOSTS);
  • Gunakan middleware untuk proteksi route, bukan di setiap controller.
  • Bisa multi-guard: Atur guard di config/permission.php jika punya lebih dari satu tipe user.
  • Wildcard permission:
PHPPHP
Permission::create(['name'=>'posts.*']);
$user->givePermissionTo('posts.create');
  • Testing: Set cache driver ke 'array' di phpunit.xml agar test permission tidak bentrok.

Troubleshooting Error Umum

  • Role/permission tidak terdeteksi: Pastikan trait HasRoles sudah di model User.
  • Cache permission tidak update: Jalankan php artisan optimize:clear.
  • Migration error: Pastikan migration sudah dijalankan dan tidak ada duplikasi table.
  • Guard mismatch: Cek guard_name di model dan config.

Penutup: Akses Aman, Coding Nyaman

Dengan Spatie Laravel Permission, kamu bisa atur akses user dengan mudah, aman, dan scalable. Cocok untuk aplikasi kecil sampai enterprise. Jangan ragu eksplorasi fitur lanjutan seperti multi-guard, wildcard, dan enum. Selamat mencoba!


Referensi Lanjutan:

Abd. Asis
Ditulis oleh
Abd. Asis

Software Developer dari Madura. Menulis tentang PHP, Laravel, dan pengembangan web modern dalam Bahasa Indonesia.

Artikel Terkait

Tulisan lain yang mungkin menarik buatmu.

Kenalan dengan Cache::flexible: Cache yang Boleh Basi Sebentar
laravelcache

Kenalan dengan Cache::flexible: Cache yang Boleh Basi Sebentar

Stale-while-revalidate bawaan Laravel. Dua angka TTL, refresh di belakang layar, dan lock yang mencegah sepuluh request menghitung hal yang sama. Plus kapan jangan dipakai.

Abd. Asis
Kiat Menguji Keamanan Payment Gateway Sebelum Uang Sungguhan Lewat
securitypayment-gateway

Kiat Menguji Keamanan Payment Gateway Sebelum Uang Sungguhan Lewat

Dua belas area yang wajib diuji, dari manipulasi nominal dan webhook palsu sampai race condition dan isolasi data merchant, lengkap dengan skenario serangan dan cara membuktikannya.

Abd. Asis
Cara Mendesain Aplikasi Ujian yang Tidak Bisa Ditebak Siswa
laravelcbt

Cara Mendesain Aplikasi Ujian yang Tidak Bisa Ditebak Siswa

Pelajaran dari modul CBT Buku Sekolah: kenapa soal harus di-snapshot, waktu harus milik server, pengacakan harus deterministik, dan token tidak boleh bisa dipakai dua kali.

Abd. Asis
Merge PDF di Laravel dengan FPDI
laravelphp

Merge PDF di Laravel dengan FPDI

Cara menggabungkan beberapa file PDF menjadi satu di Laravel menggunakan spatie/laravel-pdf untuk generate dan setasign/fpdi untuk merge, lengkap tiga studi kasus nyata.

Abd. Asis
Laravel Policies: Otorisasi Berbasis Model
laravelphp

Laravel Policies: Otorisasi Berbasis Model

Pelajari cara menggunakan Laravel Policies untuk otorisasi berbasis model, dari setup awal, Response object, before() hook, hingga pola multi-tenant SaaS yang siap produksi.

Abd. Asis
Livewire, Vue, atau React untuk Laravel?
laravelphp

Livewire, Vue, atau React untuk Laravel?

Perbandingan praktis Livewire, Vue.js, dan React untuk Laravel, kapan masing-masing pilihan masuk akal, dan bagaimana memilih tanpa terjebak debat framework.

Abd. Asis