Panduan Lengkap Setup Laravel 11 dengan Best Practice Modern (Vite, Breeze, Sanctum, dan Jetstream)

Temukan cara instalasi dan konfigurasi Laravel 11 terbaru dengan workflow modern menggunakan Vite, Breeze, Sanctum, serta praktik terbaik untuk pengembangan aplikasi PHP Framework yang aman dan efisien.

1. Prasyarat

• PHP >= 8.2
• Composer terbaru
• Node.js >= 20 dan npm/yarn
• Database (MySQL 8, PostgreSQL, atau SQLite)

2. Instalasi Laravel 11

composer create-project laravel/laravel my-app "11.*"

Perintah di atas mengunduh Laravel 11 dengan semua dependensi inti.

3. Setup Vite (Asset Bundler Modern)

1. Masuk ke folder proyek:

   cd my-app

2. Instalasi dependensi front‑end:

   npm install --save-dev vite laravel-vite-plugin

3. Jika belum ada, buat file vite.config.js:

   import { defineConfig } from 'vite';
   import laravel from 'laravel-vite-plugin';
   
   export default defineConfig({
       plugins: [
           laravel({
               input: ['resources/css/app.css', 'resources/js/app.js'],
               refresh: true,
           }),
       ],
   });

4. Perbarui package.json script:

   "scripts": {
       "dev": "vite",
       "build": "vite build"
   }

5. Jalankan dev server:

   npm run dev

4. Instalasi Laravel Breeze (Starter Kit UI)

composer require laravel/breeze --dev
php artisan breeze:install vue
npm install && npm run dev

Breeze menyediakan autentikasi dasar dengan Vue 3 (atau React, Blade) dan terintegrasi dengan Vite secara otomatis.

5. Konfigurasi Sanctum untuk API Token & SPA Authentication

1. Instal Sanctum:

   composer require laravel/sanctum

2. Publish konfigurasi dan migrasi:

   php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
   php artisan migrate

3. Tambahkan middleware ke api di app/Http/Kernel.php:

   'api' => [
       \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
       'throttle:api',
       \Illuminate\Routing\Middleware\SubstituteBindings::class,
   ],

4. Konfigurasikan config/sanctum.php untuk domain SPA Anda (misalnya localhost atau myapp.test).
5. Gunakan token personal di controller API:

   $user = User::find(1);
   $token = $user->createToken('mobile')->plainTextToken;

6. Database & Environment

# .env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel11
DB_USERNAME=root
DB_PASSWORD=

SANCTUM_STATEFUL_DOMAINS=localhost,127.0.0.1
SESSION_DOMAIN=localhost
COOKIE_DOMAIN=localhost

Jalankan migrasi:

php artisan migrate

7. Best Practice Modern

• Environment Configuration: Gunakan .env.example yang lengkap, jangan pernah commit .env ke repository.
• Code Quality: Integrasikan PHPStan level 8 dan Laravel Pint untuk standar coding.

  composer require --dev nunomaduro/larastan
  composer require --dev laravel/pint

• Testing: Tulis Feature Test dengan Pest atau PHPUnit, contoh:

  php artisan test --filter AuthTest

• Cache & Queue: Aktifkan redis sebagai driver cache & queue di production.
• Docker: Gunakan Laravel Sail untuk development container yang konsisten.

  ./vendor/bin/sail up -d

8. Deploy ke Production

1. Build assets:

   npm run build

2. Jalankan migrasi dan cache config:

   php artisan migrate --force
   php artisan config:cache
   php artisan route:cache
   php artisan view:cache

3. Set permission folder storage dan bootstrap/cache menjadi writable.
4. Gunakan supervisor untuk queue worker dan horizon (opsional).

9. Verifikasi

Buka http://localhost dan pastikan halaman landing Breeze muncul, registrasi/login berfungsi, serta API token dapat di‑generate dengan Sanctum.

Dengan mengikuti langkah‑step ini, Anda memiliki fondasi Laravel 11 yang modern, aman, dan siap untuk skala produksi. Kombinasi Vite, Breeze, dan Sanctum memberikan workflow frontend‑backend yang cepat, sementara best practice seperti testing, code linting, dan Docker memastikan kualitas kode yang tinggi dalam ekosistem PHP Framework Laravel.

---

Tutorial step-by-step setup Laravel 11 dengan Vite, Breeze, Sanctum, serta best practice modern untuk pengembangan aplikasi web menggunakan Laravel, PHP Framework, dan Web Development.

Laravel,PHP Framework,Web Development,Vite,Breeze,Sanctum,Laravel 11

#Laravel #LaravelIndonesia #PHP #WebDev #Backend