Laravel: จัดการสิทธิ์ user ด้วย Spatie

หากคุณต้องการระบบ Role / Permission (ACL) , RBAC ที่มาพร้อมกับ หน้าจอจัดการ (UI) และฟีเจอร์ความปลอดภัยแบบจัดเต็มโดยไม่ต้องเขียนเองเยอะ “การลง Jetstream (Livewire) , Spatie Laravel-Permission คือทางเลือกที่ดีมาก” ครับ

1. ติดตั้ง Laravel 12 (Clean Install)
   เปิด Terminal และไปที่ Path ที่คุณกำหนด เพื่อสร้างโปรเจกต์ใหม่
   cd /Users/Shared/Gits/phunsanit/prototypes-laravel-spatie
composer create-project laravel/laravel Sourcecode
cd Sourcecode
2. ตั้งค่า Database (.env) เช่น

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE={DB_DATABASE}
   DB_USERNAME={DB_USERNAME}
   DB_PASSWORD={DB_PASSWORD}
   

3. ติดตั้ง Laravel Jetstream (Livewire Stack)
   Jetstream จะจัดการระบบ Login, Profile, และ Security ทั้งหมดให้เรา
   composer require laravel/jetstream
php artisan jetstream:install livewire
4. ติดตั้ง Spatie Laravel-Permission
   ติดตั้งตัวจัดการ ACL เพื่อเสริมเขี้ยวเล็บให้ Jetstream
   composer require spatie/laravel-permission
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
5. รัน Migration พร้อมกัน
   ขั้นตอนนี้จะสร้างตารางของทั้ง Jetstream และ Spatie ลงใน dtabase
   php artisan migrate
6. ตั้งค่า Model User
   เปิดไฟล์ app/Models/User.php และเพิ่ม HasRoles trait

   <?php
   
   namespace App\Models;
   
   // use Illuminate\Contracts\Auth\MustVerifyEmail;
   use Illuminate\Database\Eloquent\Factories\HasFactory;
   use Illuminate\Foundation\Auth\User as Authenticatable;
   use Illuminate\Notifications\Notifiable;
   use Laravel\Fortify\TwoFactorAuthenticatable;
   use Laravel\Jetstream\HasProfilePhoto;
   use Laravel\Sanctum\HasApiTokens;
   use Spatie\Permission\Traits\HasRoles; // Add this line to include the HasRoles trait
   
   class User extends Authenticatable
   {
   	use HasApiTokens;
   
   	/** @use HasFactory<\Database\Factories\UserFactory> */
   	use HasFactory;
   	use HasProfilePhoto;
   	use Notifiable;
   	use TwoFactorAuthenticatable;
   	use HasRoles; // Add this line to use the HasRoles trait
   
   	/**
   	 * The attributes that are mass assignable.
   	 *
   	 * @var array<int, string>
   	 */
   	protected $fillable = [
   		'name',
   		'email',
   		'password',
   	];
   
   	/**
   	 * The attributes that should be hidden for serialization.
   	 *
   	 * @var array<int, string>
   	 */
   	protected $hidden = [
   		'password',
   		'remember_token',
   		'two_factor_recovery_codes',
   		'two_factor_secret',
   	];
   
   	/**
   	 * The accessors to append to the model's array form.
   	 *
   	 * @var array<int, string>
   	 */
   	protected $appends = [
   		'profile_photo_url',
   	];
   
   	/**
   	 * Get the attributes that should be cast.
   	 *
   	 * @return array<string, string>
   	 */
   	protected function casts () : array
   	{
   		return [
   			'email_verified_at' => 'datetime',
   			'password' => 'hashed',
   		];
   	}
   }
   
   

7. สร้างระบบ Role เริ่มต้น (Seeder)
   สร้างไฟล์ Seeder: php artisan make:seeder RoleSeeder แก้ไขไฟล์ database/seeders/RoleSeeder.php เพื่อสร้าง Admin คนแรก

   <?php
   
   namespace Database\Seeders;
   
   use Illuminate\Database\Console\Seeds\WithoutModelEvents;
   use Illuminate\Database\Seeder;
   
   class RoleSeeder extends Seeder
   {
   	/**
   	 * Run the database seeds.
   	 */
   	public function run () : void
   	{
   		// clear cached roles and permissions
   		app () [\Spatie\Permission\PermissionRegistrar::class]->forgetCachedPermissions () ;
   
   		// create role 'admin'
   		$adminRole = \Spatie\Permission\Models\Role::firstOrCreate (['name' => 'admin']) ;
   
   		// create fist user and assign role 'admin'
   		$user = \App\Models\User::updateOrCreate (['email' => '[email protected]'],
   			[
   				'name' => 'Phunsanit Admin',
   				'password' => bcrypt ('12345678') ,
   			]) ;
   
   		// assign role 'admin' to the user
    $user->assignRole ($adminRole) ;
   
   	}
   }
   
   

8. รัน Seeder
   php artisan db:seed --class=RoleSeeder
9. คอมไพล์ Assets (CSS / JS)
   เพื่อให้หน้าตา Jetstream แสดงผลถูกต้อง (ต้องใช้ Node.js ในเครื่อง)
   npm install
npm run build

วิธีการเข้าใช้งาน (Login)

1. รัน Server:
   php artisan serve
2. เปิด Browser ไปที่: http://127.0.0.1:8000/login
3. เข้าใช้งานด้วย
   • Email: [email protected]
   • Password: 12345678

สรุปผลลัพธ์ที่คุณจะได้

• Jetstream: จัดการหน้า Login, หน้า Profile, และระบบ Two-Factor Auth
• Spatie: จัดการสิทธิ์ว่าใครคือ Admin หรือ User ทั่วไป

อ่านเพิ่มเติม

• Laravel: Breeze
• Laravel: Jetstream
• ติดตั้ง laravel ลั๊ลลาเวล
• Laravel 5: LDAP.Active Directory (AD)
• ACL (Access Control List) และ RBAC (Role-Based Access Control)
• laravel-permission