Setup Laravel 11 dengan Best Practice Modern: Vite, Breeze, Sanctum, dan Jetstream

Panduan lengkap langkah demi langkah untuk menginstal Laravel 11 terbaru dengan stack modern termasuk Vite, Breeze, Sanctum, dan Jetstream, disertai contoh kode dan best practice.

1. Persyaratan Sistem

• PHP >= 8.3
• Composer 2.x
• Node.js >= 20
• MySQL atau PostgreSQL

2. Instalasi Laravel 11

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

Masuk ke direktori proyek:

cd my-app

3. Mengatur Vite (Asset Bundler Default)

Laravel 11 sudah menyertakan Vite. Pastikan dependensi front‑end ter‑install:

npm install

Jalankan development server:

npm run dev

Konfigurasi Vite

Jika perlu menambah alias atau plugin, edit vite.config.js:

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: ['resources/js/app.js', 'resources/css/app.css'],
            refresh: true,
        }),
    ],
    resolve: {
        alias: {
            '@': '/resources/js',
        },
    },
});

4. Instalasi Breeze (Authentication Starter Kit)

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

Breeze menyiapkan routes, controller, view, dan Tailwind CSS siap pakai.

Best Practice Breeze

• Gunakan php artisan route:cache setelah produksi.
• Sesuaikan resources/js/app.js untuk menambahkan plugin Vue 3 atau React bila diperlukan.

5. Menambahkan Sanctum untuk API Token Authentication

composer require laravel/sanctum
php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
php artisan migrate

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

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

Contoh Penggunaan Token

// Login & create token
public function login(Request $request)
{
    $user = User::where('email', $request->email)->first();
    if (! $user || ! Hash::check($request->password, $user->password)) {
        return response()->json(['message' => 'Invalid credentials'], 401);
    }
    $token = $user->createToken('api-token')->plainTextToken;
    return response()->json(['token' => $token]);
}

// Protect route
Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
    return $request->user();
});

6. (Opsional) Menambahkan Jetstream untuk Fitur Team & Two‑Factor

composer require laravel/jetstream
php artisan jetstream:install livewire --team
npm install && npm run dev
php artisan migrate

Jetstream menambah scaffold lengkap dengan Livewire atau Inertia, team management, dan two‑factor authentication.

Best Practice Jetstream

• Gunakan php artisan config:cache dan php artisan route:cache di production.
• Non‑aktifkan fitur tidak terpakai di config/jetstream.php untuk mengurangi overhead.

7. Pengaturan Lingkungan Production

• Set APP_ENV=production dan APP_DEBUG=false di .env.
• Jalankan optimasi artisan:

  php artisan optimize:clear
  php artisan config:cache
  php artisan route:cache
  php artisan view:cache

• Compile assets:

  npm run build

• Gunakan server web teroptimasi (NGINX + PHP‑FPM) dan set opcache aktif.

8. Testing dan Deployment

# Unit & Feature Test
php artisan test

# Deploy (contoh dengan Laravel Forge)
forge deploy my-app

Pastikan queue worker dan scheduler berjalan dengan supervisor atau systemd.

9. Kesimpulan

Dengan mengikuti langkah di atas, Anda memiliki aplikasi Laravel 11 yang modern, cepat, dan aman, siap untuk dikembangkan lebih lanjut atau di‑scale ke produksi.

Setup Laravel 11 dengan Vite, Breeze, Sanctum, dan Jetstream memberikan fondasi solid untuk pengembangan aplikasi web modern. Ikuti best practice pada setiap tahap untuk memastikan performa optimal, keamanan tinggi, dan kemudahan pemeliharaan.

---

Panduan lengkap setup Laravel 11 dengan Vite, Breeze, Sanctum, dan Jetstream. Langkah demi langkah, contoh kode, dan best practice untuk proyek PHP Framework modern.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend