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

Tutorial step‑by‑step untuk menginstal Laravel 11 terbaru, mengkonfigurasi Vite, Breeze, Sanctum, serta menerapkan best practice keamanan dan kode bersih menggunakan Laravel Pint.

1. Persiapan Lingkungan

Pastikan server Anda memenuhi persyaratan minimum Laravel 11:

• PHP >= 8.2
• Ekstensi PHP: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath
• Composer 2.x
• Node.js >= 18 (untuk Vite)
• Database (MySQL 8+, PostgreSQL, atau SQLite)

1.1 Install Composer & Node

curl -sS https://getcomposer.org/installer | php
npm install -g npm@latest

2. Instalasi Laravel 11

composer create-project laravel/laravel blog "11.*" --prefer-dist
cd blog

Perintah di atas membuat proyek blog dengan versi stabil Laravel 11.

3. Mengaktifkan Vite (Bundler Frontend Default)

Laravel 11 sudah menyertakan Vite secara default. Pastikan file vite.config.js ada dan package.json berisi script berikut:

"scripts": {
  "dev": "vite",
  "build": "vite build"
}

3.1 Instalasi Dependency Frontend

npm install
npm run dev

Browser akan memuat asset melalui http://localhost:5173 dengan hot‑module replacement.

4. Menambahkan Laravel Breeze (Starter Kit Auth)

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

Perintah di atas menginstal Breeze dengan stack Vue 3 (pilihan lain: blade, react, svelte). Selanjutnya:

npm install && npm run dev
php artisan migrate

4.1 Struktur Direktori Breeze

• resources/js/Components – komponen Vue
• resources/views/auth – blade fallback
• routes/web.php – route registrasi default

5. Menyiapkan Laravel Sanctum (API Token & SPA Authentication)

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

5.1 Konfigurasi Sanctum

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,
],

Setelah itu, dalam .env pastikan SESSION_DOMAIN=localhost dan SANCTUM_STATEFUL_DOMAINS=localhost,127.0.0.1 untuk pengembangan lokal.

5.2 Contoh Endpoint API dengan Sanctum

use Illuminate\Http\Request;
use App\Models\User;

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

6. Menambahkan Laravel Pint (Code Style)

composer require laravel/pint --dev
./vendor/bin/pint

Laravel Pint otomatis memperbaiki style code sesuai aturan PSR‑12. Jalankan dalam CI/CD untuk menjaga konsistensi.

7. Konfigurasi Database & .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_blog
DB_USERNAME=root
DB_PASSWORD=

Jalankan migrasi:

php artisan migrate

8. Best Practice Modern

• Environment Variables: Gunakan .env.example yang lengkap, jangan commit .env ke repo.
• Cache Config & Routes di produksi: php artisan config:cache && php artisan route:cache
• Queue & Jobs: Siapkan driver redis untuk job yang berat.
• Health Checks: Tambahkan route /up dengan php artisan up untuk monitoring.
• Testing: Gunakan php artisan test dengan PHPUnit 10 & Pest.
• Security: Aktifkan APP_DEBUG=false di produksi, gunakan Sanctum untuk token, dan set SESSION_SECURE_COOKIE=true bila HTTPS.

9. Deploy ke Server (Contoh Laravel Vapor atau VPS)

Untuk VPS standar:

1. Upload kode via Git atau SFTP.
2. Jalankan composer install --optimize-autoloader --no-dev.
3. Set APP_ENV=production dan APP_KEY (generate dengan php artisan key:generate).
4. Build assets: npm ci && npm run build.
5. Cache konfigurasi, routes, dan view: php artisan config:cache && php artisan route:cache && php artisan view:cache.
6. Setup queue worker (systemd) dan scheduler (php artisan schedule:run setiap menit).

10. Verifikasi Instalasi

Buka http://your-domain.test. Anda harus melihat halaman beranda Breeze, login/register berfungsi, dan API /api/user mengembalikan JSON setelah autentikasi via Sanctum.

Dengan mengikuti langkah‑langkah di atas, Anda memiliki proyek Laravel 11 yang modern, aman, dan siap produksi. Menggunakan Vite untuk asset, Breeze untuk starter kit UI, Sanctum untuk autentikasi API, serta Laravel Pint untuk kualitas kode memberikan fondasi yang kuat bagi aplikasi web skala kecil hingga enterprise.

---

Tutorial lengkap setup Laravel 11 dengan Vite, Breeze, Sanctum, dan best practice modern. Panduan step‑by‑step untuk developer PHP Framework 2026.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend