컨텐츠로 건너뛰기

환경 변수 API 참조

Added in: astro@5.0.0

Astro의 astro:env API를 사용하면 설정한 환경 변수에 대한 타입 안전 스키마를 구성할 수 있습니다. 이를 통해 서버 또는 클라이언트에서 사용 가능한지 여부를 표시하고, 데이터 타입과 추가 속성을 정의할 수 있습니다. 예시와 사용 방법은 astro:env 가이드를 참조하세요.

import {
getSecret,
} from 'astro:env';

Added in: astro@5.0.0

getSecret() 헬퍼 함수를 사용하면 키를 통해 환경 변수의 원시 값을 검색할 수 있습니다.

예를 들어, 불리언 값을 문자열로 검색할 수 있습니다:

import {
FEATURE_FLAG, // boolean
getSecret
} from 'astro:env/server'
getSecret('FEATURE_FLAG') // string | undefined

이는 데이터베이스나 API의 동적 데이터에 의존하는 것과 같이 스키마에 정의되지 않은 비밀을 가져오는 데에도 유용할 수 있습니다.

프로그래밍 방식으로 환경 변수를 검색해야 하는 경우, process.env (또는 이와 동등한 것) 대신 getSecret()를 사용하는 것이 좋습니다. 구현이 어댑터에 의해 제공되므로 어댑터를 전환할 때 모든 호출을 업데이트할 필요가 없습니다. 개발 및 빌드 시에는 기본적으로 process.env를 사용합니다.

기여하기 커뮤니티 Sponsor