NXDOM

Nxdom Framework

Nusantara eXtreme Development Object Model — dokumentasi resmi

Proxy API & aset

Browser memanggil same-origin ke origin SPA; Express meneruskan ke PHP dan aset sesuai konfigurasi, dengan penyesuaian URL dan header agar redirect tidak memecahkan CORS.

reverse proxy · patch URL

Alur ringkas

  1. Browser memanggil misalnya http://localhost:5000/api/... dan http://localhost:5000/assets/drive/....
  2. Express mem-proxy ke host di urlApi / drive jika origin backend berbeda dengan origin listener SPA.
  3. Middleware seperti patchReqUrlToOriginal memastikan req.url selaras dengan req.originalUrl sebelum proxy, sehingga path ke upstream tetap lengkap (misalnya /api/outside tidak terpotong).
  4. Pada respons proxy, header Location / Content-Location yang mengarah ke host PHP dapat ditulis ulang ke origin yang dipakai browser agar tidak terjadi redirect lintas origin yang memicu masalah CORS.

Patch URL ke upstream

Pastikan middleware patch URL dijalankan sebelum handler proxy. Tanpa itu, path setelah mount Express bisa tidak sesuai dengan yang diharapkan backend PHP.

Header redirect

Implementasi on.proxyRes (atau setara di versi proxy) menangani pengalihan absolut ke host PHP dengan menyesuaikan ke origin browser.

Tip: jika request ke …/outside bukan …/api/outside, periksa urutan middleware dan mount path proxy.

Injeksi nilai ke klien SPA dijelaskan di Injeksi endpoint.