Routing berbasis berkas

Tidak ada berkas rute untuk dipelihara. Yang ada aturan prioritas, dan satu keputusan trailing slash yang kalau salah akan menggandakan seluruh URL portalmu di mata Google.

Pemetaan dasar

Aturan prioritas — hafalkan urutannya

Saat lebih dari satu rute cocok dengan satu URL, Astro memilih berdasarkan spesifisitas, bukan urutan berkas:

1. Rute statis — /berita/arsip
2. Rute dinamis satu segmen — /berita/[slug]
3. Rute rest — /berita/[...jalur]
4. Rute rest paling luar — /[...jalur]

/berita/arsip  →  berita/arsip.astro     (menang: statis)
/berita/halo   →  berita/[slug].astro    (statis tidak ada)
/xyz/abc/def   →  [...jalur].astro       (tidak ada yang lebih spesifik)

Trailing slash — keputusan yang harus benar sejak awal

export default defineConfig({
  site: "https://portal.contoh.id",
  trailingSlash: "never",   // "always" | "never" | "ignore"
});

Perlu diingat juga: Cloudflare punya pengaturannya sendiri, dan nginx maupun ALB bisa menambahkan redirect. Kalau ketiganya tidak sepakat, kamu bisa mendapat rantai redirect atau — lebih buruk — loop. Verifikasi dengan curl -I setelah semuanya terpasang, bukan hanya di lokal.

Rewrite vs redirect

---
const artikel = await ambilArtikelPublik(Astro.params.slug!);

// Artikel tidak ada: tampilkan halaman 404, URL tetap seperti yang diminta
if (!artikel) {
  return Astro.rewrite("/404");
}

// Slug berubah karena judul disunting: kirim pembaca ke URL kanoniknya
if (artikel.slug !== Astro.params.slug) {
  return Astro.redirect(`/berita/${artikel.slug}`, 301);
}
---

Blok kedua di contoh itu penting untuk portal berita. Editor menyunting judul, slug ikut berubah, dan URL lama yang sudah tersebar di media sosial jadi mati. Dengan mencari artikel berdasarkan ID di dalam slug — atau lewat tabel slug lama — kamu bisa mengembalikan 301 ke slug baru, dan tautan lama tetap hidup. Ini akan diperluas di Fase 9.

Redirect statis di konfigurasi

export default defineConfig({
  redirects: {
    "/news": "/berita",
    "/news/[...jalur]": "/berita/[...jalur]",
    "/kategori/ekonomi": { status: 301, destination: "/berita/ekonomi" },
  },
});

Cocok untuk redirect yang jumlahnya puluhan dan diketahui saat build. Tidak cocok untuk peta 40.000 URL warisan — itu masuk ke database dan dilayani rute rest, karena memasukkan 40.000 entri ke konfigurasi akan memperlambat build dan membuat berkasnya tidak bisa direview siapa pun.

Endpoint: berkas .ts di dalam pages/

// src/pages/api/artikel.json.ts  →  /api/artikel.json
import type { APIRoute } from "astro";
import { ambilArtikelTerbaru } from "@/lib/artikel";

export const prerender = false;

export const GET: APIRoute = async ({ url }) => {
  const kategori = url.searchParams.get("kategori") ?? "semua";
  const artikel = await ambilArtikelTerbaru(kategori, 20);

  return new Response(JSON.stringify(artikel), {
    headers: {
      "Content-Type": "application/json",
      "Cache-Control": "public, max-age=60, s-maxage=300",
    },
  });
};

Nama fungsi yang di-export adalah metode HTTP-nya. Request POST ke berkas yang hanya meng-export GET mendapat 405 Method Not Allowed otomatis — tanpa kamu menuliskan satu pun pengecekan. Bandingkan dengan CI3, di mana satu method controller menerima semua metode dan pemeriksaan $this->input->method() mudah terlupa.