Laravel Diterbitkan: • Diperbarui: • 8 menit baca • 63 views

Laravel Inertia Vue 3: Optimasi SSR & Performa Production

Juan Mths
Juan Mths
Chief Technology Officer & Administrator • Skor SEO: 100/100
Ilustrasi Laravel Inertia Vue 3: Optimasi SSR & Performa Production
Laravel Featured Article Laravel Inertia Vue 3: Optimasi SSR & Performa Production

Untuk mengaktifkan Server-Side Rendering (SSR) pada Laravel Inertia Vue 3, Anda wajib membangun bundel entry point khusus Node.js melalui Vite dan menjalankan proses daemon SSR terpisah di server VPS menggunakan Supervisor. Langkah ini memungkinkan server merender halaman Vue menjadi HTML utuh sebelum dikirim ke browser, sekaligus memangkas Time to First Byte (TTFB) serta memastikan bot mesin pencari mengindeks seluruh konten dinamis secara instan.

Setelah pada seri sebelumnya kita berhasil mengamankan pipeline deployment otomatis menggunakan CI/CD[cite: 1], tantangan nyata berikutnya muncul saat aplikasi mulai diakses ribuan pengguna bersamaan. Tanpa konfigurasi SSR dan strategi caching tingkat lanjut, aplikasi SPA berbasis Inertia hanya mengirimkan tag <div id="app"> kosong saat pertama kali dimuat, yang berakibat fatal pada skor Core Web Vitals dan visibilitas SEO halaman publik.

Prasyarat Teknis & Perbandingan Arsitektur Rendering

Sebelum memodifikasi konfigurasi bundel produksi, pastikan lingkungan server VPS maupun lokal Anda telah memenuhi spesifikasi arsitektur berikut agar proses kompilasi berjalan tanpa hambatan memori:

  • Backend Runtime: PHP 8.2+ dengan ekstensi php-redis aktif serta Laravel 11.x.

  • Frontend & Bundler: Vue 3.4+, @inertiajs/vue3 v1.0+, dan Vite 5.x.

  • SSR Runtime Engine: Node.js v20 LTS terinstal di server produksi (wajib untuk mengeksekusi server SSR).

  • Infrastruktur Cloud / VPS: Minimal RAM 2 GB dengan akses root untuk konfigurasi Supervisor dan Redis Server.

Dalam proyek Enterprise Architecture dan SaaS yang saya tangani, pemilihan mode rendering sangat menentukan beban CPU server dan kecepatan muat awal. Tabel berikut merangkum perbandingan performa antara mode standar dengan arsitektur SSR teroptimasi:

Parameter Teknis

Client-Side Rendering (CSR)

Inertia SSR + Vite Splitting

Inertia SSR + Redis Cache

Respons HTML Awal

Kosong (Hanya div root)

HTML penuh ter-render

HTML penuh dari memori

Indeksasi SEO Bot

Lambat (Butuh eksekusi JS)

Instan (100% terbaca)

Instan (100% terbaca)

Beban CPU Server

Rendah (Beban di browser)

Tinggi saat trafik melonjak

Sangat rendah (Bypass render)

First Contentful Paint

1.4s – 2.8s

0.5s – 0.9s

< 0.3s

Langkah 1: Konfigurasi Entry Point SSR & Vite Code Splitting

Secara default, Laravel hanya memiliki file resources/js/app.js yang berjalan di sisi browser. Untuk menjalankan SSR, kita perlu membuat file resources/js/ssr.js sebagai pintu masuk khusus bagi daemon Node.js sekaligus memasang paket @vue/server-renderer.

npm install @vue/server-renderer

Setelah paket terpasang, buat file resources/js/ssr.js untuk menangani rendering komponen Vue di sisi server dan menyinkronkan rute Ziggy agar fungsi route() tetap bekerja tanpa objek window:

import { createSSRApp, h } from 'vue';
import { renderToString } from '@vue/server-renderer';
import { createInertiaApp } from '@inertiajs/vue3';
import createServer from '@inertiajs/vue3/server';
import { resolvePageComponent } from 'laravel-vite-plugin/inertia-helpers';
import { ZiggyVue } from '../../vendor/tightenco/ziggy';

const appName = import.meta.env.VITE_APP_NAME || 'SarjanaIT';

createServer((page) =>
    createInertiaApp({
        page,
        render: renderToString,
        title: (title) => `${title} - ${appName}`,
        resolve: (name) =>
            resolvePageComponent(
                `./Pages/${name}.vue`,
                import.meta.glob('./Pages/**/*.vue')
            ),
        setup({ App, props, plugin }) {
            return createSSRApp({ render: () => h(App, props) })
                .use(plugin)
                .use(ZiggyVue, {
                    ...page.props.ziggy,
                    location: new URL(page.props.ziggy.location),
                });
        },
    })
);

Bedah Teknis Kode di Atas:

  • createServer & renderToString: Membuka server HTTP internal Node.js (default port 13714) yang menerima payload JSON dari Laravel dan mengembalikannya sebagai string HTML matang.

  • createSSRApp: Menggantikan fungsi createApp biasa agar Vue melakukan proses hydration (menempelkan event listener ke DOM yang sudah ada) alih-alih merender ulang seluruh elemen dari nol.

  • Konfigurasi ZiggyVue: Karena Node.js tidak memiliki objek global window.location, kita wajib menyuntikkan URL saat ini secara eksplisit dari properti page.props.ziggy.location.

Selanjutnya, perbarui vite.config.js untuk mendaftarkan entry point SSR sekaligus memecah ukuran bundel vendor (Manual Chunks) agar browser tidak mengunduh satu file JavaScript raksasa:

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import vue from '@vitejs/plugin-vue';

export default defineConfig({
    plugins: [
        laravel({
            input: 'resources/js/app.js',
            ssr: 'resources/js/ssr.js',
            refresh: true,
        }),
        vue({
            template: {
                transformAssetUrls: {
                    base: null,
                    includeAbsolute: false,
                },
            },
        }),
    ],
    build: {
        rollupOptions: {
            output: {
                manualChunks(id) {
                    if (id.includes('node_modules')) {
                        if (id.includes('vue') || id.includes('@inertiajs')) {
                            return 'vendor-core';
                        }
                        return 'vendor-libs';
                    }
                },
            },
        },
    },
});

Dengan aturan manualChunks di atas, Vite memisahkan library inti Vue dan Inertia ke dalam vendor-core.js yang jarang berubah sehingga dapat disimpan di cache browser pengguna dalam jangka waktu lama.

Output terminal hasil kompilasi Vite build client dan server SSR pada proyek Laravel Inertia Vue 3

Langkah 2: Mengaktifkan SSR & Redis Payload Caching di Backend

Publikasikan file konfigurasi Inertia apabila belum tersedia di folder config/inertia.php menggunakan perintah php artisan vendor:publish --provider="Inertia\ServiceProvider", lalu pastikan opsi SSR diaktifkan:

<?php

return [
    'ssr' => [
        'enabled' => env('INERTIA_SSR_ENABLED', true),
        'url' => env('INERTIA_SSR_URL', 'http://127.0.0.1:13714'),
    ],
];

Merender komponen Vue via Node.js pada setiap permintaan masuk tetap memakan siklus CPU. Untuk halaman katalog, artikel, atau landing page SaaS yang datanya jarang berubah setiap detik, saya selalu membungkus data controller dengan Redis Cache serta mengevaluasi properti malas (Lazy Evaluation) di dalam HandleInertiaRequests.php:

<?php

namespace App\Http\Controllers;

use App\Models\Article;
use Illuminate\Support\Facades\Cache;
use Inertia\Inertia;
use Inertia\Response;

class PublicArticleController extends Controller
{
    public function show(string $slug): Response
    {
        $article = Cache::tags(['articles'])->remember(
            "article_detail_{$slug}",
            now()->addHours(6),
            fn () => Article::with(['author:id,name,avatar', 'category:id,name,slug'])
                ->where('slug', $slug)
                ->where('status', 'published')
                ->firstOrFail()
        );

        return Inertia::render('Articles/Show', [
            'article' => $article,
            'relatedArticles' => Inertia::defer(fn () => 
                Article::where('category_id', $article->category_id)
                    ->where('id', '!=', $article->id)
                    ->select('id', 'title', 'slug', 'published_at')
                    ->limit(4)
                    ->get()
            ),
        ]);
    }
}

Analisis Optimasi Query & Inertia Payload:

  • Cache::tags(['articles']): Menyimpan hasil query Eloquent beserta relasinya di memori RAM Redis selama 6 jam, sehingga database MySQL/PostgreSQL tidak tersentuh saat terjadi lonjakan trafik.

  • Inertia::defer(): Menunda pemuatan data sekunder seperti daftar artikel terkait hingga halaman utama selesai di-render, menjaga ukuran payload JSON awal tetap sangat ringan.

💡 Tips Praktis & Optimasi Performa dari Pengalaman Saya

Saat mengelola server Cloud VPS produksi dengan trafik tinggi, jangan pernah menjalankan perintah php artisan inertia:start-ssr secara manual di sesi SSH karena prosesnya akan mati begitu terminal ditutup. Daftarkan layanan SSR ke dalam Supervisor agar otomatis menyala ulang jika terjadi lonjakan memori.

Tambahkan juga perintah php artisan inertia:stop-ssr pada baris akhir skrip deployment CI/CD Anda. Supervisor akan langsung mendeteksi penghentian tersebut dan me-restart daemon Node.js menggunakan bundel ssr.mjs versi terbaru tanpa downtime.

Langkah 3: Konfigurasi Supervisor di Server Produksi VPS

Buat file konfigurasi worker baru di direktori /etc/supervisor/conf.d/inertia-ssr.conf pada server Ubuntu/Debian Anda untuk menjaga stabilitas daemon SSR:

[program:inertia-ssr]
process_name=%(program_name)s
command=php /var/www/sarjanait/artisan inertia:start-ssr
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/sarjanait/storage/logs/ssr.log
stopwaitsecs=3600

Aktifkan worker tersebut dengan menjalankan sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl start inertia-ssr. Anda bisa memverifikasi apakah SSR sudah bekerja dengan melihat kode sumber halaman (View Page Source atau Ctrl + U) di browser; seluruh teks HTML komponen Vue kini tampil utuh di dalam elemen <div id="app" data-page="...">.

Bukti kode sumber HTML ter-render sempurna menggunakan Server-Side Rendering pada Laravel Inertia Vue 3

⚠️ Troubleshooting & Skenario Error Handling di Lapangan

Error Spesifik: ReferenceError: window is not defined atau document is not defined di dalam file log storage/logs/ssr.log saat halaman diakses.

Akar Masalah & Solusi: Error ini terjadi karena ada kode atau library pihak ketiga (seperti chart atau editor teks) yang memanggil objek DOM browser di dalam blok <script setup> tingkat atas yang ikut dieksekusi oleh Node.js. Pindahkan seluruh manipulasi window atau localStorage ke dalam hook onMounted(() => { ... }) karena hook tersebut hanya dieksekusi di sisi browser setelah proses hydration selesai.

FAQ Teknis Implementasi SSR & Optimasi Laravel Inertia

1. Apakah semua halaman dashboard admin wajib menggunakan SSR?

Tidak perlu. Halaman internal di balik layar login seperti panel admin tidak membutuhkan indeksasi SEO. Anda bisa membatasi SSR hanya untuk rute publik melalui konfigurasi middleware atau membiarkan server SSR berjalan ringan karena Inertia hanya merender permintaan pertama kali (initial page load), sementara navigasi berikutnya tetap berjalan murni sebagai SPA via XHR.

2. Apa yang terjadi jika daemon Node.js SSR tiba-tiba crash di server produksi?

Laravel Inertia memiliki mekanisme graceful fallback bawaan. Jika koneksi ke port 13714 gagal atau timeout, Laravel otomatis menurunkan mode rendering kembali ke Client-Side Rendering standar tanpa memunculkan error 500 kepada pengguna.

3. Bagaimana cara mengatasi kebocoran memori (Memory Leak) pada proses Node.js SSR?

Hindari menyimpan state global atau instance variabel di luar fungsi callback createServer((page) => ...) pada file ssr.js. State yang dideklarasikan di luar fungsi tersebut akan bertahan di memori antar-permintaan pengguna yang berbeda, yang tidak hanya memicu kebocoran RAM tetapi juga berisiko membocorkan data sesi antar-pengguna.

4. Apakah Laravel Octane kompatibel dijalankan bersamaan dengan Inertia SSR?

Sangat kompatibel. Kombinasi Laravel Octane (berbasis Swoole atau FrankenPHP) dengan daemon Inertia SSR memangkas latensi komunikasi HTTP lokal antar-proses menjadi hitungan milidetik, menjadikannya arsitektur paling ideal untuk aplikasi SaaS skala tinggi.

Diskusi & Komentar

0

Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.

Tulis Komentar
* Tautan dalam komentar otomatis diamankan dengan atribut rel="nofollow ugc". Maks 2.000 karakter
Moderasi aktif: komentar akan ditinjau sebelum terbit.

Belum Ada Komentar

Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!