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

Pelajari cara menginstal Laravel 11 terbaru, mengonfigurasi Vite untuk bundling asset, menambahkan Breeze untuk otentikasi cepat, serta mengamankan API dengan Sanctum dalam satu tutorial step‑by‑step.

1. Prasyarat

• PHP 8.3+ (disarankan 8.3.2)
• Composer 2.7+
• Node.js 20.x dan npm 10.x
• Database MySQL 8 atau PostgreSQL

2. Instalasi Laravel 11

composer create-project laravel/laravel blog --prefer-dist "^11.0"

Perintah di atas membuat proyek blog dengan Laravel 11 stabil.

2.1. Verifikasi Instalasi

cd blog
php artisan serve

Buka http://localhost:8000, Anda harus melihat halaman welcome Laravel.

3. Mengganti Mix dengan Vite (Default di Laravel 11)

Laravel 11 sudah menyertakan Vite, cukup install dependensi JavaScript.

npm install
npm run dev

Folder resources/js/app.js dan resources/css/app.css otomatis di‑bundle oleh Vite.

3.1. Konfigurasi Vite untuk Tailwind CSS (opsional)

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init -p

Tambahkan ke tailwind.config.js:

module.exports = {
  content: [
    './resources/**/*.blade.php',
    './resources/**/*.js',
    './resources/**/*.vue',
  ],
  theme: { extend: {} },
  plugins: [],
};

4. Menambahkan Laravel Breeze (Livewire atau Inertia)

Breeze menyediakan scaffolding otentikasi ringan dengan Blade. Pilih Blade (default) atau Livewire.

composer require laravel/breeze --dev
php artisan breeze:install blade
# atau untuk Livewire
# php artisan breeze:install livewire
npm run dev
php artisan migrate

Setelah migrasi, kunjungi /login atau /register.

4.1. Best Practice: Verifikasi Email

Aktifkan fitur verifikasi email di App\Models\User.php dengan menambahkan MustVerifyEmail pada implementasi.

use Illuminate\Notifications\Notifiable;
use Illuminate\Contracts\Auth\MustVerifyEmail;

class User extends Authenticatable implements MustVerifyEmail {
    use Notifiable;
}

5. Mengamankan API dengan Laravel Sanctum

Sanctum memungkinkan token‑based authentication untuk SPA atau mobile.

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

5.1. Konfigurasi Middleware

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

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

5.2. Membuat Route API dengan Sanctum

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

5.3. Menghasilkan Token di Controller

public function login(Request $request)
{
    $credentials = $request->only('email', 'password');
    if (!Auth::attempt($credentials)) {
        return response()->json(['message' => 'Invalid credentials'], 401);
    }
    $token = $request->user()->createToken('api-token')->plainTextToken;
    return response()->json(['token' => $token]);
}

6. Pengaturan Environment & Keamanan

• Set APP_DEBUG=false di .env produksi.
• Gunakan APP_URL yang tepat.
• Aktifkan SESSION_SECURE_COOKIE=true dan SESSION_SAME_SITE=lax untuk HTTPS.
• Jalankan php artisan config:cache & php artisan route:cache di server.

7. Deploy ke Server Linux (contoh dengan Nginx)

# Clone repo
git clone https://github.com/username/blog.git /var/www/blog
cd /var/www/blog
composer install --optimize-autoloader --no-dev
npm ci
npm run build
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

# Nginx config snippet
server {
    listen 80;
    server_name example.com;
    root /var/www/blog/public;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

7.1. Best Practice CI/CD

Gunakan GitHub Actions untuk otomatisasi testing, linting, dan deploy ke VPS atau layanan seperti Laravel Forge.

8. Testing & Debugging

php artisan test

Laravel 11 menyertakan Pest & PHPUnit. Pastikan semua test lulus sebelum merge.

9. Dokumentasi & Sumber Daya Lanjutan

• Laravel 11 Documentation
• Vite Integration
• Laravel Breeze
• Laravel Sanctum

Dengan mengikuti langkah‑langkah di atas, Anda memiliki aplikasi Laravel 11 yang modern, terstruktur, dan siap produksi. Kombinasi Vite, Breeze, dan Sanctum memberikan kecepatan pengembangan, UI bersih, serta keamanan API yang handal—semua mengikuti best practice 2026.

---

Tutorial lengkap setup Laravel 11 dengan Vite, Breeze, dan Sanctum. Panduan step‑by‑step instalasi, konfigurasi, contoh kode, serta best practice modern untuk pengembangan web PHP Framework.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend