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

Tutorial step‑by‑step ini menjelaskan cara menginstal Laravel 11 terbaru, mengkonfigurasi Vite, Breeze, Sanctum, serta menyiapkan testing environment untuk proyek produksi siap pakai.

1. Prasyarat

• PHP >= 8.2
• Composer terbaru
• Node.js >= 20 dan npm atau yarn
• Database MySQL/PostgreSQL/SQLite

2. Instalasi Laravel 11

composer create-project laravel/laravel my-project "11.*"

Masuk ke folder proyek:

cd my-project

2.1. Memastikan .env

Copy file contoh dan set key aplikasi:

cp .env.example .env
php artisan key:generate

3. Integrasi Vite (Frontend Build Tool)

Laravel 11 sudah menyertakan Vite secara default, tetapi pastikan dependensi terinstall:

npm install
# atau yarn
yarn install

3.1. Konfigurasi Vite

Edit vite.config.js bila perlu, contoh menambahkan alias:

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

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

3.2. Menjalankan Dev Server

npm run dev
# atau
yarn dev

Server Vite akan hot‑reload perubahan pada file Vue/React/Blade.

4. Instalasi Laravel Breeze (Starter Kit)

Breeze menyediakan autentikasi ringan dengan Blade atau Inertia. Di sini contoh dengan Blade:

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

Jalankan migrasi:

php artisan migrate

4.1. Menyesuaikan Layout

Modifikasi resources/views/layouts/app.blade.php sesuai desain UI/UX Anda. Pastikan @vite(['resources/css/app.css','resources/js/app.js']) tetap terpasang.

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

composer require laravel/sanctum

Publikasikan konfigurasi dan migrasi:

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

5.1. Konfigurasi Middleware

Tambahkan EnsureFrontendRequestsAreStateful::class pada grup middleware 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

use App\Http\Controllers\API\UserController;

Route::middleware('auth:sanctum')->get('/user', [UserController::class, 'profile']);

5.3. Contoh Request dengan Axios (frontend)

import axios from 'axios';

axios.get('/sanctum/csrf-cookie').then(() => {
    axios.get('/api/user').then(response => {
        console.log(response.data);
    });
});

6. Testing Environment (PHPUnit & Pest)

Laravel 11 sudah siap untuk testing. Install Pest untuk syntax yang lebih bersih:

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

6.1. Contoh Test Feature

/**
 * @test
 */
function user_can_register()
{
    $response = $this->post('/register', [
        'name' => 'John Doe',
        'email' => '[email protected]',
        'password' => 'secret123',
        'password_confirmation' => 'secret123',
    ]);

    $response->assertRedirect('/dashboard');
    $this->assertAuthenticated();
}

7. Best Practice Modern

• Environment variables: Jaga rahasia di .env dan gunakan config:cache di produksi.
• Static assets: Deploy hasil build Vite (npm run build) ke CDN.
• Database: Gunakan migrasi dengan php artisan migrate --force dalam CI/CD.
• Code style: Terapkan PHP CS Fixer atau Laravel Pint (./vendor/bin/pint).
• Security: Aktifkan Sanctum token expiration, gunakan HTTPS, dan set APP_DEBUG=false di produksi.
• Docker: Pertimbangkan kontainerisasi dengan docker-compose.yml yang menyertakan php, mysql, dan nginx.

8. Deploy ke Server Produksi

1. Upload kode ke repo Git.
2. Gunakan layanan seperti Laravel Forge, Vapor, atau VPS dengan git pull.
3. Jalankan perintah:

   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

4. Set permission storage dan bootstrap/cache untuk web server.

Dengan mengikuti langkah‑langkah di atas, Anda akan memiliki proyek Laravel 11 yang terstruktur, aman, dan siap skalabilitas modern. Menggabungkan Vite, Breeze, Sanctum, serta testing otomatis memberi fondasi kuat untuk aplikasi web yang cepat, dapat dipelihara, dan sesuai best practice 2026.

---

Tutorial lengkap setup Laravel 11 dengan Vite, Breeze, Sanctum, testing, dan best practice modern untuk pengembangan web PHP Framework tahun 2026.

Laravel,PHP Framework,Web Development

#Laravel #LaravelIndonesia #PHP #WebDev #Backend