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

Tutorial step‑by‑step ini membimbing Anda menginstal Laravel 11 terbaru, mengkonfigurasi Vite, Breeze, Sanctum, serta menerapkan best practice untuk pengembangan aplikasi web modern.

1. Prasyarat

• PHP 8.3 atau lebih tinggi
• Composer 2.x
• Node.js 20.x dan npm 10.x
• Database MySQL/PostgreSQL

2. Instalasi Laravel 11

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

Masuk ke folder proyek:

cd my-app

Penjelasan

Perintah di atas mengunduh versi stabil Laravel 11 beserta dependensi utama.

3. Mengatur Vite (Laravel Mix digantikan)

# Install dependencies
npm install --save-dev vite laravel-vite-plugin

# Buat file vite.config.js
cat <<'EOF' > 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,
        }),
    ],
});
EOF

Penjelasan

Laravel Vite Plugin menyediakan hot‑module‑replacement (HMR) dan build production secara otomatis.

4. Menginstall Breeze (Starter Kit dengan Blade atau Inertia)

# Pilih stack Blade (default)
composer require laravel/breeze --dev
php artisan breeze:install blade

# Atau pilih Inertia + Vue 3
# composer require laravel/breeze --dev
# php artisan breeze:install vue

npm install && npm run dev

Setelah instalasi, jalankan migrasi database:

php artisan migrate

Penjelasan

Breeze menyediakan autentikasi dasar, registrasi, reset password, dan UI minimal yang sudah terintegrasi dengan Vite.

5. Menambahkan Sanctum untuk API Token Authentication

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

Konfigurasi middleware di app/Http/Kernel.php:

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

Contoh route API yang dilindungi:

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

Penjelasan

Sanctum memungkinkan token‑based atau session‑based authentication yang ringan, cocok untuk SPA atau mobile app.

6. Best Practice Modern

• Environment Variables: Simpan rahasia di .env dan gunakan config:cache untuk produksi.
• Docker Development: Jalankan Laravel dalam container untuk konsistensi lingkungan.
• PHPStan & Laravel Pint: Tambahkan static analysis dan linting.

  composer require --dev phpstan/phpstan laravel/pint

• Testing: Gunakan Pest atau PHPUnit, contoh:

  php artisan test

• Deploy: Build assets dengan npm run build, jalankan php artisan migrate --force, dan aktifkan php artisan config:cache, php artisan route:cache, php artisan view:cache.

7. Verifikasi Instalasi

# Jalankan server lokal
php artisan serve

# Buka browser: http://localhost:8000
# Pastikan halaman welcome tampil dan autentikasi Breeze berfungsi.

# Cek Vite HMR
npm run dev
# Modifikasi resources/js/app.js, perubahan harus muncul otomatis.

Dengan mengikuti langkah‑langkah di atas, Anda memiliki proyek Laravel 11 yang siap produksi, menggunakan Vite untuk asset modern, Breeze sebagai starter kit autentikasi, dan Sanctum untuk API security. Terapkan best practice seperti caching konfigurasi, static analysis, dan Docker untuk memastikan kode tetap maintainable dan scalable.

---

Tutorial lengkap setup Laravel 11 terbaru dengan Vite, Breeze, Sanctum, dan best practice modern. Panduan step‑by‑step untuk developer PHP framework yang ingin membangun aplikasi web aman dan cepat.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend