Conas a oibríonn athbhreithniú ar éileamh (ISR)?

Question

Accepted Answer

**Athbhreithniú ar éileamh** a ligint duit taisce/leathanaigh stataic a neamhbhailíochtú **go díreach nuair a athraíonn sonraí** — seachas a bheith ag feitheamh ar eatramh bunaithe ar am. Is é an comhlánú beacht a bheith ann do ISR bunaithe ar am (`revalidate: N`).

## Bunaithe ar am i gcoinne ar éileamh

```tsx
// Time-based: page refreshes on a fixed schedule (may serve stale data up to N seconds)
export const revalidate = 3600; // every hour

// On-demand: refresh the INSTANT the underlying data changes — no waiting, no waste
```

Tá ISR bunaithe ar am simplí ach neamhphuirfeasach: ró-ghearr = giniúint dhíobhálach; ró-fhada = inneachar stale. Soláthraíonn athbhreithniú ar éileamh an leigheas seo tríd an athbhreithniú a spreagadh ó do chód féin nuair a tharlaíonn athrú i ndáiríribh.

## An dá API ar éileamh

```tsx
import { revalidatePath, revalidateTag } from "next/cache";

// 1. Tag your fetches, then invalidate by tag
await fetch("https://api/posts", { next: { tags: ["posts"] } });
revalidateTag("posts");      // refresh EVERY page/fetch tagged "posts"

// 2. Or invalidate a specific path
revalidatePath("/blog/my-post");
```

## Sreabh fíordhúil: webhook CMS

```ts
// app/api/revalidate/route.ts — called by your CMS when an editor publishes
import { revalidateTag } from "next/cache";
import { NextRequest, NextResponse } from "next/server";

export async function POST(req: NextRequest) {
  const secret = req.nextUrl.searchParams.get("secret");
  if (secret !== process.env.REVALIDATE_SECRET) {       // verify it's really your CMS
    return NextResponse.json({ ok: false }, { status: 401 });
  }
  revalidateTag("posts");                                // rebuild affected pages now
  return NextResponse.json({ revalidated: true });
}
```

An sreabh: eagarthóir a fhoilsíonn sa CMS → CMS ag glao ar do webhook → `revalidateTag("posts")` ag neamhbhailíochtú an taisce → an cuairteoir athuair a fhaigheann HTML stataic ginte go nua. Fanann leathanaigh stataic-thapa **agus** nuashonraítear go tapa ar fhoilsiú.

## Tar éis athraitheas Server Action

```tsx
"use server";
export async function createPost(data) {
  await db.post.create({ data });
  revalidateTag("posts"); // user sees their new post immediately
}
```

## An fáth go bhfuil sé tábhachtach

Tugann athbhreithniú ar éileamh duit an Ghréal ar dheis: **feidhmíochta stataic le fionnachtana in-am-fíor**.

In ionad eatramh athbhreithnithe a bhheith ag obadh, neamhbhailíochtaíonn tú go beacht nuair a athraíonn inneachar — trí webhooks (foilsiú CMS) nó i ndiaidh athraitheas Server Action — ag baint úsáide as `revalidateTag`/`revalidatePath`.

Díonn sé an dá dhuine de inneachar stale agus giniúint dhíobhálach fhorbartha, ag déanamh ISR practiciúil do inneachar a nuashonraíonn gan a bheith intuigthe.