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

Tutorial step-by-step memandu Anda menginstal Laravel 11 terbaru, mengintegrasikan Vite, Breeze, Sanctum, serta konfigurasi best practice untuk pengembangan aplikasi web modern.

1. Prerequisite & Lingkungan Pengembangan

Pastikan sistem Anda memenuhi persyaratan berikut:

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

1.1. Verifikasi Versi

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

2. Instalasi Laravel 11 dengan Composer

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

# Menggunakan Laravel Installer (direkomendasikan)
composer global require laravel/installer
laravel new blog --jetstream

# Atau tanpa installer
composer create-project laravel/laravel blog "11.*"

2.1. Struktur Direktori

Setelah instalasi, periksa struktur utama: app/, routes/, resources/views/, vite.config.js, dsb.

3. Konfigurasi Vite sebagai Asset Bundler

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

3.1. Instalasi Dependencies Frontend

cd blog
npm install
# atau yarn
yarn install

3.2. Menjalankan Dev Server

npm run dev
# atau
yarn dev

Anda akan melihat URL http://localhost:5173 yang menyediakan hot‑module replacement.

4. Menambahkan Laravel Breeze (Starter Kit) dengan Blade atau Inertia

Breeze menyediakan otentikasi ringan serta stack UI pilihan.

4.1. Install Breeze (Blade)

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

4.2. Install Breeze (Inertia + Vue)

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

Setelah instalasi, migrasi database:

php artisan migrate

5. Mengamankan API dengan Laravel Sanctum

Sanctum memungkinkan token‑based authentication untuk SPA atau mobile.

5.1. Instalasi Sanctum

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

5.2. Konfigurasi Middleware

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

\Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,

5.3. Contoh Route API

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

6. Best Practice Modern

• Environment Variables: Simpan rahasia di .env dan gunakan config:cache untuk produksi.
• Database Migration & Seeders: Selalu versi skema dengan migration; gunakan factory untuk seed data testing.
• Docker Development: Gunakan laravel/sail untuk containerized environment.

  ./vendor/bin/sail up -d

• Code Style: Terapkan PHP CS Fixer atau Laravel Pint (vendor/bin/pint) secara otomatis pada CI.
• Testing: Tuliskan Feature Test dengan Pest atau PHPUnit; jalankan php artisan test pada setiap pull request.
• Cache & Queues: Konfigurasi Redis sebagai driver cache & queue untuk performa tinggi.

7. Deployment ke Production

1. Set APP_ENV=production dan APP_DEBUG=false di .env server.
2. Run composer install --optimize-autoloader --no-dev.
3. Generate optimized assets: npm run build.
4. Cache konfigurasi & routes: php artisan config:cache & php artisan route:cache.
5. Setup supervisor untuk queue workers jika menggunakan queue.
6. Pastikan permission folder storage dan bootstrap/cache dapat ditulis.

Dengan mengikuti langkah‑langkah di atas, Anda akan memiliki aplikasi Laravel 11 yang terstruktur, aman, dan siap skala. Integrasi Vite, Breeze, dan Sanctum memberikan fondasi modern untuk SPA atau aplikasi monolith tradisional, sementara best practice seperti Docker, caching, dan testing memastikan kualitas kode terjaga di setiap fase pengembangan.

---

Tutorial step-by-step setup Laravel 11 modern dengan Vite, Breeze, Sanctum, Docker, dan best practice untuk produksi.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend