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

Ikuti tutorial step‑by‑step ini untuk menginstal Laravel 11 terbaru, mengonfigurasi Vite, Breeze, Sanctum, serta menyiapkan testing environment secara optimal pada tahun 2026.

1. Prasyarat

• PHP 8.3 atau lebih tinggi
• Composer 2.7+
• Node.js 20+ dan npm 10+
• Database MySQL 8.0 atau PostgreSQL 15

2. Instalasi Laravel 11

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

Masuk ke folder proyek:

cd blog

3. Setup Vite (Frontend Asset Bundler)

Laravel 11 sudah menyertakan Vite secara default. Pastikan package sudah terinstall:

npm install

Jalankan dev server untuk memastikan:

npm run dev

Konfigurasi tambahan

Jika menggunakan TypeScript atau TailwindCSS, instal paket berikut:

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

Modifikasi vite.config.js bila perlu, misalnya menambahkan alias:

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [laravel(['resources/js/app.js', 'resources/css/app.css'])],
    resolve: { alias: { '@': '/resources/js' } },
});

4. Instalasi Laravel Breeze (Starter Kit)

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

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

npm install && npm run dev

Migrasi database

php artisan migrate

5. Konfigurasi Laravel Sanctum (API Authentication)

composer require laravel/sanctum

Publish konfigurasi dan migrasi:

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

Tambahkan middleware pada api guard di app/Http/Kernel.php:

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

Contoh penggunaan token

// routes/api.php
use App\Http\Controllers\API\AuthController;
Route::post('/login', [AuthController::class, 'login']);
Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
    return $request->user();
});

6. Penulisan Feature Test dengan Pest (alternatif PHPUnit)

composer require pestphp/pest --dev
php artisan pest:install

Contoh test autentikasi API:

/** @test */
function user_can_obtain_sanctum_token()
{
    $user = \App\Models\User::factory()->create(['password' => bcrypt('secret')]);

    $response = $this->postJson('/api/login', [
        'email' => $user->email,
        'password' => 'secret',
    ]);

    $response->assertOk()->assertJsonStructure(['token']);
}

7. Best Practice Modern (2026)

• Environment Variables: Simpan semua secret di .env dan gunakan config:cache setelah perubahan.
• Docker Development: Gunakan docker-compose.yml resmi Laravel untuk konsistensi lintas tim.
• Code Style: Terapkan Laravel Pint (PHP CS Fixer) untuk standar kode.

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

• Version Control: Commit vite.config.js, package.json, dan composer.lock untuk menjaga reproducibility.
• Cache & Queues: Konfigurasi Redis sebagai driver cache dan queue di .env.

  CACHE_DRIVER=redis
  QUEUE_CONNECTION=redis

8. Deploy ke Production (Laravel Vapor atau traditional VPS)

1. Build assets: npm run build
2. Cache konfigurasi & routes: php artisan config:cache && php artisan route:cache
3. Optimalkan autoloader: composer install --optimize-autoloader --no-dev
4. Set permission: chmod -R 775 storage bootstrap/cache

Pastikan APP_ENV=production dan APP_DEBUG=false di environment server.

Dengan mengikuti langkah‑langkah di atas, Anda memiliki aplikasi Laravel 11 yang terstruktur modern—menggunakan Vite untuk asset bundling, Breeze sebagai starter kit, Sanctum untuk API authentication, serta testing otomatis dengan Pest. Mengikuti best practice seperti Docker, Laravel Pint, dan caching akan memastikan kode Anda siap untuk produksi skala besar di tahun 2026.

---

Tutorial step-by-step menginstal Laravel 11 dengan Vite, Breeze, Sanctum, dan testing modern. Panduan lengkap 2026 untuk developer PHP Framework.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend