Next.js मा environment variables कसरी काम गर्छन्?

Question

Accepted Answer

Next.js ले `.env` फाइलहरूबाट environment variables लोड गर्छ, एक महत्त्वपूर्ण सुरक्षा नियमको साथ: चरहरू **पूर्वनिर्धारितमा सर्भर-मात्र** हुन्छन्, र केवल `NEXT_PUBLIC_` को साथ उपसर्ग गरिएकाहरू ब्राउजरमा उजागर हुन्छन्।

## फाइलहरू

```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
```

## महत्वपूर्ण उपसर्ग नियम

```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
```

यो उपसर्ग नियम एक **सुरक्षा सुविधा** हो: यसले तपाईंलाई डेटाबेस पासवर्ड वा API गोपनीयताहरू क्लायन्टमा दुर्घटनावश पठाउनबाट रोक्छ। एक गैर-उपसर्गित चर ब्राउजर बन्डलहरूमा अस्तित्वमा छैन।

## NEXT_PUBLIC मानहरू कसरी इम्बेड गरिन्छन्

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

किनभने तिनीहरू बिल्ड समयमा इनलाइन गरिन्छन्, `NEXT_PUBLIC_` मान परिवर्तन गर्नको लागि **पुनः बिल्ड** आवश्यक छ — र तपाईंले कहिल्यै उपसर्गको पछाडि सत्य गोपनीयता राख्नु हुँदैन (तिनीहरू बन्डलमा कसैलाई देखिने थिए)।

## सर्वोत्तम अभ्यास

```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)
```

## किन यो महत्वपूर्ण छ

सर्भर-मात्र-पूर्वनिर्धारित मडेल `NEXT_PUBLIC_` अप्ट-इनको साथ Next.js को गोपनीयताहरू क्लायन्टमा रिसाउनको विरुद्धको सुरक्षा हो — एक सामान्य, गम्भीर गलती।

कुन चरहरू ब्राउजरमा पुग्छन्, सार्वजनिक चरहरू बिल्ड-समय इनलाइन गरिन्छन्, र गोपनीयताहरू कहाँ भण्डार गर्ने (gitignored `.env.local`) बुझ्नु कार्यक्षमता र सुरक्षा दुवैको लागि आवश्यक छ।