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

Ikuti tutorial step‑by‑step ini untuk menginstal Laravel 11, mengonfigurasi Vite, Breeze, Sanctum, dan menerapkan praktik terbaik pengembangan modern di tahun 2026.

1. Prasyarat

• PHP >= 8.3
• Composer 2.7+
• Node.js >= 20 (LTS)
• Database MySQL 8.0 atau PostgreSQL 15
• Git

2. Instalasi Laravel 11

composer create-project laravel/laravel:^11 my-project
cd my-project

Perintah di atas mengunduh kerangka kerja Laravel 11 stabil (rilis 2026) dan masuk ke direktori proyek.

3. Mengatur Vite (Asset Bundler Modern)

1. Instal dependensi npm:

npm install

2. Pastikan file vite.config.js berisi plugin Laravel Vite terbaru:

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,
        }),
    ],
});

3. Jalankan server development Vite dengan hot‑module replacement:

npm run dev

4. Menambahkan Laravel Breeze (Starter Kit)

1. Instal Breeze via Composer:

composer require laravel/breeze --dev

2. Jalankan installer dengan opsi React, Vue atau Blade. Contoh menggunakan Blade (default):

php artisan breeze:install

3. Jika ingin menggunakan Inertia + Vue 3 (populer 2026), gunakan:

php artisan breeze:install vue

4. Compile aset:

npm run dev

5. Migrasi database:

php artisan migrate

5. Mengkonfigurasi Laravel Sanctum (API Authentication)

1. Instal Sanctum:

composer require laravel/sanctum

2. Publikasikan konfigurasi dan migrasi:

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

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

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

4. Set konfigurasi SANCTUM_STATEFUL_DOMAINS di file .env (contoh: localhost,127.0.0.1,dev.myapp.test)
5. Contoh route API yang dilindungi:

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

6. Struktur Direktori yang Direkomendasikan (Best Practice)

• app/Models – semua Eloquent model.
• app/Http/Controllers/API – controller API terpisah.
• app/Http/Requests – form request validation.
• app/Services – logika bisnis terisolasi.
• resources/views – Blade templates (atau resources/js/Pages untuk Inertia).
• routes/web.php – route UI.
• routes/api.php – route API, memakai api middleware grup.

7. Konfigurasi Caching & Queue (Production Ready)

1. Cache konfigurasi:

php artisan config:cache

2. Cache route:

php artisan route:cache

3. Queue driver di .env (gunakan Redis di 2026):

QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1

4. Jalankan worker supervisor (contoh systemd unit):

[Unit]
Description=Laravel Queue Worker
After=network.target

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /path/to/my-project/artisan queue:work redis --sleep=3 --tries=3

[Install]
WantedBy=multi-user.target

8. Testing Otomatis (PHPUnit & Pest)

1. Instal Pest (trending 2026) untuk testing yang lebih ekspresif:

composer require pestphp/pest --dev
php artisan pest:install

2. Contoh test feature API:

it('returns authenticated user', function () {
    $user = User::factory()->create();
    $this->actingAs($user, 'sanctum')
         ->getJson('/api/user')
         ->assertOk()
         ->assertJsonPath('email', $user->email);
});

9. Deployment Checklist

• Set APP_ENV=production dan APP_DEBUG=false di .env.
• Jalankan composer install --optimize-autoloader --no-dev.
• Compile aset produksi:

npm run build

• Cache konfigurasi, route & view:

php artisan config:cache
php artisan route:cache
php artisan view:cache

• Pastikan storage dan bootstrap/cache writable oleh web server.

10. Tips Tambahan 2026

• Gunakan Laravel Octane (Swoole atau RoadRunner) untuk performa tinggi bila beban traffic meningkat.
• Manfaatkan Laravel Pint untuk standar coding otomatis.
• Integrasikan Laravel Telescope di environment staging saja untuk debugging real‑time.

Dengan mengikuti langkah‑langkah di atas, Anda akan memiliki proyek Laravel 11 yang terstruktur, menggunakan Vite untuk asset modern, Breeze sebagai starter kit UI, serta Sanctum untuk API authentication. Mematuhi best practice seperti pemisahan folder, caching, queue, dan testing memastikan aplikasi siap untuk produksi scalable di tahun 2026.

---

Tutorial lengkap setup Laravel 11 dengan Vite, Breeze, Sanctum, dan praktik terbaik modern tahun 2026. Ikuti langkah-langkah instalasi, konfigurasi, contoh kode, dan deployment.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend