Conas a bhíonn feidhm ag athróga timpeallachta i Next.js?

Question

Accepted Answer

Lódálann Next.js athróga timpeallachta ó chomhaid `.env`, agus riail thábhachtach slándála ann: tá athróga **server-only de réir réamhshocrú**, agus ní dhéantar ach iad siúd a bhfuil `NEXT_PUBLIC_` rompu a nochtadh don bhrowser.

## Na comhaid

```text
.env                # loaded in all environments
.env.local          # local overrides — GITIGNORED (put secrets here)
.env.development    # only in `next dev`
.env.production     # only in production builds
```

## An riail réamhfhocail chriticiúil

```bash
# .env.local
DATABASE_URL=postgres://...secret...   # server-only — NEVER sent to the browser
NEXT_PUBLIC_API_URL=https://api.example.com  # exposed to the browser
```

```tsx
// Server Component / Route Handler / Server Action — can read anything
const db = process.env.DATABASE_URL;          // ✅ works on the server

// Client Component — only NEXT_PUBLIC_* are available
"use client";
const api = process.env.NEXT_PUBLIC_API_URL;  // ✅ works
const secret = process.env.DATABASE_URL;      // ❌ undefined in the browser
```

Is **gné slándála** an riail réamhfhocail seo: coimeádann sé ó bheith ag seachaint focail fhaire an bhunachair shonraí nó rúnda API a sheoladh go mall don chliaint. Ní bhaineann athróg gan réamhfhocal a bheith ann in éinneacht i mbundal an bhrowser.

## Conas a chuirtear luachanna NEXT_PUBLIC_ in ionad

```text
NEXT_PUBLIC_* are INLINED at BUILD time (baked into the JS bundle).
```

Toisc go ndéantar iad a ionadú in am tógála, éilíonn athrú ar luach `NEXT_PUBLIC_` **atógáil** — agus ba cheart duit riamh go deo rúnda fíor a chur taobh thiar den réamhfhocal (bheadh siad infhaicthe sa bhundal do dhuine ar bith).

## Dea-chleachtas

```text
✓ Secrets (DB URLs, API keys) → no prefix, kept server-side, in .env.local (gitignored)
✓ Public config (public API base, analytics id) → NEXT_PUBLIC_
✓ Commit a .env.example documenting required vars (no real values)
```

## Cén fáth a bhfuil sé tábhachtach

Is garda Next.js an tsamhail server-only de réir réamhshocrú agus an t-opt-in `NEXT_PUBLIC_` i gcoinne rúnda a shraoileadh chuig an gcliaint — botún coiteann, tromchúiseach.

Tá sé riachtanach don bhfeidhmiúlacht agus don tsláindáil a thuiscint cén athróg a shroicheann an browser, go bhfuil athróga poiblí ionadaithe in am tógála, agus cá háit a stóráil rúnda (`.env.local` fágtha ar lár ag git).