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

Ikuti tutorial step‑by‑step ini untuk menginstal Laravel 11 terbaru, mengkonfigurasi Vite, Breeze, Sanctum, serta menerapkan best practice yang cocok untuk proyek produksi di tahun 2026.

1. Persiapan Lingkungan

Instalasi Prasyarat

Pastikan Anda memiliki:

• PHP >= 8.2
• Composer 2.x
• Node.js >= 20 (LTS) dengan npm atau Yarn
• Database (MySQL 8+, PostgreSQL 15+)

Verifikasi Versi

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

2. Membuat Project Laravel 11

Instalasi via Composer

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

Masuk ke folder project:

cd blog

Inisialisasi Git (opsional tapi direkomendasikan)

git init
git add .
git commit -m "Initial Laravel 11 setup"

3. Mengonfigurasi Vite (Asset Bundler Modern)

Instalasi dependensi

npm install --save-dev vite laravel-vite-plugin

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

Modifikasi resources/js/app.js

import './bootstrap';
import '../css/app.css';

// Contoh penggunaan Alpine.js (opsional)
import Alpine from 'alpinejs';
window.Alpine = Alpine;
Alpine.start();

Jalankan dev server

npm run dev

Vite akan menjalankan hot‑module replacement (HMR) pada http://localhost:5173.

4. Menambahkan Laravel Breeze (Starter Kit Auth)

Instalasi Breeze

composer require laravel/breeze --dev
php artisan breeze:install vue
# atau gunakan blade: php artisan breeze:install

Instalasi NPM dependencies untuk Breeze

npm install && npm run dev

Migrasi database

php artisan migrate

Setelah ini, fitur login, register, dan reset password siap pakai.

5. Mengamankan API dengan Laravel Sanctum

Instalasi Sanctum

composer require laravel/sanctum

Publish konfigurasi & migrasi

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

Konfigurasi config/sanctum.php

Pastikan stateful berisi domain front‑end Anda (contoh: localhost, myapp.test).

'stateful' => explode(",", env('SANCTUM_STATEFUL_DOMAINS', 'localhost,127.0.0.1')),

Tambahkan Middleware ke api guard

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
    'api' => [
        'driver' => 'sanctum',
        'provider' => 'users',
    ],
],

Contoh Route API yang Dilindungi

use App\Http\Controllers\API\PostController;

Route::middleware('auth:sanctum')->group(function () {
    Route::apiResource('posts', PostController::class);
});

Contoh Request Token dengan Axios (Vue)

import axios from 'axios';

axios.get('/sanctum/csrf-cookie').then(() => {
    axios.post('/login', {email, password})
        .then(response => {
            // token otomatis tersimpan sebagai cookie
        });
});

6. Best Practice Modern (2026)

• Environment Files: Simpan semua variabel sensitif di .env dan gunakan .env.example untuk tim.
• Docker: Gunakan Laravel Sail atau Docker Compose untuk konsistensi lingkungan dev.
• Testing: Tuliskan unit & feature test dengan PestPHP (atau PHPUnit). Contoh:

  php artisan test --filter=UserCanLoginTest

• Static Analysis: Integrasikan phpstan dan larastan untuk kode bebas error.
• Code Formatting: Gunakan Laravel Pint (vendor/bin/pint) sebelum commit.
• Cache Config & Routes pada production:

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

• Queue & Jobs: Aktifkan Redis sebagai driver queue, gunakan horizon untuk monitoring.

7. Deploy ke Production

Langkah Umum

1. Upload source code ke server (Git, FTP, atau CI/CD).
2. Install dependencies:

   composer install --optimize-autoloader --no-dev
   npm ci && npm run build

3. Set environment variables di .env server.
4. Migrasi dan seeding database:

   php artisan migrate --force
   php artisan db:seed --force

5. Cache konfigurasi & route (lihat best practice).
6. Restart queue workers & horizon jika digunakan.

Pastikan web server (NGINX/Apache) mengarahkan semua request ke public/index.php dan mengaktifkan HTTPS.

Dengan mengikuti langkah‑langkah di atas, Anda berhasil menyiapkan proyek Laravel 11 modern yang terintegrasi dengan Vite, Breeze, dan Sanctum. Kombinasi ini memberikan developer pengalaman pengembangan cepat, keamanan API yang solid, serta fondasi yang siap untuk skala produksi di tahun 2026.

---

Tutorial step-by-step setup Laravel 11 terbaru dengan Vite, Breeze, Sanctum, dan best practice modern untuk pengembangan web 2026.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend