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

Panduan lengkap instalasi Laravel 11 terbaru, dikombinasikan dengan Vite, Laravel Breeze, Laravel Sanctum, dan konfigurasi best practice untuk pengembangan aplikasi web modern di tahun 2026.

1. Persiapan Lingkungan

Pastikan sistem Anda sudah terpasang:

• PHP 8.3 atau lebih tinggi
• Composer 2.7+
• Node.js 20.x LTS
• Database (MySQL 8+, PostgreSQL 15+, atau SQLite untuk pengujian)

1.1. Verifikasi versi

php -v
composer -V
node -v
npm -v

2. Instalasi Laravel 11

Gunakan composer create-project atau laravel new untuk membuat proyek baru.

composer create-project laravel/laravel myapp "^11.0" --prefer-dist
# atau jika sudah menginstal Laravel installer
laravel new myapp --jetstream

2.1. Struktur Direktori

Laravel 11 tetap menggunakan struktur standar, namun resources/js kini dikelola oleh Vite.

3. Mengintegrasikan Vite

Laravel 11 sudah menyertakan Vite secara default. Pastikan file vite.config.js ada di root proyek.

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.1. Jalankan Vite

npm install && npm run dev

Gunakan npm run build untuk produksi.

4. Menambahkan Laravel Breeze (Blade atau Inertia)

Breeze memberikan scaffolding otentikasi ringan.

4.1. Instalasi Breeze dengan Blade

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

4.2. Instalasi Breeze dengan Inertia & Vue 3

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

5. Konfigurasi Laravel Sanctum untuk API Token & SPA

Sanctum memungkinkan authentication berbasis token serta cookie‑based SPA.

5.1. Instalasi Sanctum

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

5.2. Middleware

Tambahkan EnsureFrontendRequestsAreStateful::class ke grup api di app/Http/Kernel.php jika menggunakan SPA.

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

5.3. Contoh Route API dengan Token

use App\Models\User;
use Laravel\Sanctum\PersonalAccessToken;

Route::post('/login', function (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]);
});

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

6. Best Practice Modern

• Environment Files: Simpan semua variabel sensitif di .env dan gunakan env() hanya di konfigurasi, bukan dalam aplikasi.
• Cache Config & Routes: php artisan config:cache & php artisan route:cache untuk produksi.
• Database Migrations: Selalu versi‑kan schema dengan php artisan migrate:fresh --seed di CI.
• Testing: Gunakan PestPHP (bundled) atau PHPUnit, contoh: php artisan test.
• Static Analysis: Pasang phpstan atau larastan untuk memastikan tipe data.
• Docker: Buat container resmi (php, mysql, redis) untuk konsistensi lingkungan develop‑to‑prod.
• Code Style: Terapkan Laravel Pint (vendor/bin/pint) sebelum commit.

7. Deploy ke Production

1. Upload kode ke server atau gunakan platform Laravel Forge/Envoyer.
2. Install dependencies: composer install --optimize-autoloader --no-dev
3. Build assets: npm ci && npm run build
4. Cache konfigurasi & routes.
5. Jalankan migrasi: php artisan migrate --force
6. Set permission folder storage & bootstrap/cache.
7. Pastikan queue worker dan scheduler berjalan (Supervisor + cron).

Dengan mengikuti langkah‑langkah di atas, Anda akan memiliki proyek Laravel 11 yang modern, cepat, dan siap produksi. Kombinasi Vite, Breeze, dan Sanctum memberikan fondasi yang solid untuk aplikasi SPA atau monolitik, sementara best practice seperti caching, static analysis, dan Docker memastikan kualitas kode dan kemudahan pemeliharaan di tahun 2026.

---

Tutorial lengkap setup Laravel 11 dengan Vite, Breeze, Sanctum, dan best practice modern untuk pengembangan web di 2026.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend