0Pricing
TypeScript Academy · Lezione

Tipizzazione delle variabili d’ambiente e configurazione

Validi e tipizzi le variabili d’ambiente; esponga variabili client sicure con NEXT_PUBLIC; centralizzi la configurazione per server e client.

Tipizzazione delle variabili d’ambiente e configurazione è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 3 di 3. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 3 lezioni in totale.

Introduzione

Obiettivo: centralizzare le variabili d'ambiente validate e mantenere sincronizzati i tipi. Analizzerà process.env con zod, esporterà un oggetto env tipizzato ed esporrà al client solo NEXT_PUBLIC_*.

  • Validazione a runtime
  • Esposizione lato server e lato client
  • Un'unica fonte di verità

Schemi e parser

Crei schemi separati per server e client. Interrompa subito l'avvio in presenza di una configurazione non valida.

// app/lib/env.ts
import { z } from "zod"

const serverSchema = z.object({
  NODE_ENV: z.enum(["development", "test", "production"]),
  DATABASE_URL: z.string().url(),
  API_SECRET: z.string().min(1)
})

const clientSchema = z.object({
  NEXT_PUBLIC_API_BASE: z.string().url()
})

function parseEnv<T extends z.ZodTypeAny>(schema: T, source: Record<string, unknown>) {
  const r = schema.safeParse(source)
  if (!r.success) {
    console.error(r.error.format())
    throw new Error("Invalid environment variables")
  }
  return r.data as z.infer<T>
}

export const serverEnv = parseEnv(serverSchema, process.env)
export const clientEnv = parseEnv(clientSchema, process.env)

Utilizzo lato server

I file server (route handler e componenti server) possono accedere ai segreti tramite serverEnv. Non li esponga mai al client.

// app/api/users/route.ts
import { NextResponse } from "next/server"
import { serverEnv } from "@/app/lib/env"

export async function GET() {
  // Safe to read secrets on the server
  const db = serverEnv.DATABASE_URL
  return NextResponse.json({ ok: true, dbConfigured: Boolean(db) })
}

Utilizzo lato client

I componenti client importano solo clientEnv, che contiene le variabili NEXT_PUBLIC_*. I segreti non vengono mai inviati al browser.

"use client"
import { clientEnv } from "@/app/lib/env"

export default function ApiBaseNotice() {
  return <small>API base: {clientEnv.NEXT_PUBLIC_API_BASE}</small>
}

Tipi ambientali

I tipi ambientali migliorano la DX per process.env, ma non eseguono la validazione a runtime: mantenga i controlli zod.

// env.d.ts (optional hints; runtime validation still required)
/// <reference types="node" />

declare namespace NodeJS {
  interface ProcessEnv {
    NODE_ENV: "development" | "test" | "production"
    DATABASE_URL?: string
    API_SECRET?: string
    NEXT_PUBLIC_API_BASE?: string
  }
}

Buone pratiche

Buone pratiche:

  • Non legga mai i segreti nei file client.
  • Validi una volta all'avvio; in ambienti non di produzione interrompa subito l'esecuzione per rilevare i problemi.
  • Raggruppi l'accesso alle variabili d'ambiente in un piccolo modulo, per garantire coerenza e facilitare i test.

Verifica della tipizzazione delle variabili d'ambiente

Verifica rapida: qual è uno schema sicuro per tipizzare ed esporre le variabili d'ambiente?

Riepilogo

Riepilogo: analizzi process.env con zod, esporti serverEnv/clientEnv tipizzati e si affidi a NEXT_PUBLIC_* per un'esposizione sicura al client.

Domande Frequenti

La lezione «Tipizzazione delle variabili d’ambiente e configurazione» è gratuita?

Sì — il testo completo di «Tipizzazione delle variabili d’ambiente e configurazione» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 3 lezioni in totale.

Cosa imparerò in «Tipizzazione delle variabili d’ambiente e configurazione»?

Validi e tipizzi le variabili d’ambiente; esponga variabili client sicure con NEXT_PUBLIC; centralizzi la configurazione per server e client. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 3.

Quanto tempo richiede la lezione «Tipizzazione delle variabili d’ambiente e configurazione»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Tipi dei gestori App Router; componenti server e client
  2. Recupero dei dati e tipizzazione delle action
  3. Tipizzazione delle variabili d’ambiente e configurazione
← Torna a TypeScript Academy