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

Tutorial step‑by‑step ini membimbing Anda menginstal Laravel 11, mengkonfigurasi Vite, menambahkan starter kit Breeze, mengamankan API dengan Sanctum, serta menerapkan best practice untuk produksi tahun 2026.

1. Persiapan Lingkungan

Pastikan server Anda memenuhi persyaratan resmi Laravel 11:

• PHP >= 8.3
• Ekstensi PHP: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath, Fileinfo
• Composer 2.7 atau lebih baru
• Node.js 20.x dan npm 10.x (atau Yarn 4)

Langkah Install Composer & Node

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

2. Membuat Project Laravel Baru

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

Folder blog kini berisi aplikasi Laravel 11 siap pakai.

3. Mengaktifkan Vite (Laravel Mix digantikan)

Laravel 11 menggunakan Vite secara default. Pastikan file vite.config.js ada dan sesuaikan bila diperlukan.

Instalasi Dependensi Frontend

npm install
npm run dev

Jika Anda ingin menambahkan React, Vue atau Svelte, jalankan:

# React
npm install react react-dom @vitejs/plugin-react
# Vue
npm install vue @vitejs/plugin-vue
# Svelte
npm install svelte @sveltejs/vite-plugin-svelte

4. Menambahkan Laravel Breeze (Starter Kit)

Breeze menyediakan autentikasi ringan berbasis Blade atau API (Inertia). Pilih Blade untuk tutorial ini.

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

Setelah ini Anda memiliki route, controller, dan view login/register yang berfungsi.

5. Mengamankan API dengan Laravel Sanctum

Sanctum memungkinkan token‑based authentication untuk SPA atau mobile app.

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

Tambahkan middleware EnsureFrontendRequestsAreStateful::class pada api guard (file config/sanctum.php) dan pastikan SESSION_DOMAIN serta SANCTUM_STATEFUL_DOMAINS di .env di‑set ke domain aplikasi.

Contoh Route API yang Dilindungi

use App\Http\Controllers\API\PostController;

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

6. Konfigurasi Environment untuk Produksi

• APP_DEBUG=false – matikan debug.
• APP_URL – set ke URL produksi.
• CACHE_DRIVER=redis
• SESSION_DRIVER=redis
• QUEUE_CONNECTION=redis
• Gunakan php artisan config:cache dan php artisan route:cache.

7. Optimasi Vite untuk Production

npm run build
php artisan view:cache

File aset akan berada di public/build. Pastikan server web (NGINX/Apache) meng‑serve folder tersebut dengan cache‑control yang tepat.

8. Deployment dengan Laravel Forge atau Docker

Berikut contoh Dockerfile modern (2026) yang men‑support PHP 8.3, Vite, dan Supervisor untuk queue worker.

FROM php:8.3-fpm-alpine
WORKDIR /var/www/html
COPY . .
RUN apk add --no-cache icu-dev libpng-dev zlib-dev libzip-dev npm git && \
    docker-php-ext-install pdo_mysql intl zip && \
    curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer && \
    composer install --no-dev --optimize-autoloader && \
    npm ci && npm run build && \
    php artisan storage:link && php artisan cache:clear
CMD ["php-fpm"]

9. Best Practice Tambahan

• Gunakan Route Model Binding untuk menghindari query manual.
• Implementasikan Form Request Validation pada semua endpoint.
• Audit kode dengan phpstan dan larastan untuk tipe safety.
• Logging terpusat dengan Laravel Telescope di environment staging.
• Gunakan Feature Flags (spatie/laravel-feature) untuk rollout bertahap.

Dengan mengikuti langkah‑langkah di atas, Anda memiliki aplikasi Laravel 11 yang terstruktur, aman, dan siap produksi. Kombinasi Vite, Breeze, dan Sanctum memberikan fondasi modern untuk SPA atau aplikasi tradisional, sementara konfigurasi caching, queue, dan Docker memastikan performa optimal di 2026.

---

Tutorial lengkap setup Laravel 11 dengan Vite, Breeze, Sanctum, dan best practice modern untuk produksi tahun 2026. Ikuti langkah demi langkah instalasi, konfigurasi, contoh kode, dan optimasi.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend