어댑터

비공식 베타 번역

이 페이지는 PageTurner AI로 번역되었습니다(베타). 프로젝트 공식 승인을 받지 않았습니다. 오류를 발견하셨나요? 문제 신고 →

tRPC는 그 자체로 서버가 아니므로, Node.js HTTP Server, Express 또는 Next.js와 같은 다른 호스트를 사용하여 서빙되어야 합니다. 선택한 백엔드에 관계없이 대부분의 tRPC 기능은 동일하게 작동합니다. 어댑터는 호스트 시스템과 tRPC API를 연결하는 접착제 역할을 합니다.

어댑터는 일반적으로 공통된 규칙을 따르며, createContext를 통한 컨텍스트 생성 설정과 onError를 통한 전역 오류 처리를 지원합니다. 무엇보다도 애플리케이션에 적합한 호스트를 선택할 수 있는 유연성을 제공합니다.

여기서는 API 호스팅을 위한 다양한 방식을 지원하며, 관련 문서를 확인하실 수 있습니다.

• 서버풀 API의 경우 Standalone 어댑터를 사용하거나, 기존 API에 통합하기 위해 Express 또는 Fastify 어댑터를 활용할 수 있습니다

• 서버리스 솔루션을 원한다면 AWS Lambda를 선택하거나 엣지 런타임을 위한 Fetch 어댑터를 사용할 수 있습니다

• 풀스택 프레임워크를 사용 중이라면 Next.js와 같은 완전한 통합을 원하실 수 있으며, Next.js, Astro, Remix 또는 SolidStart와 함께 Fetch 어댑터를 사용할 수도 있습니다

팁

로컬 개발이나 서버풀 인프라에서는 Standalone Adapter가 가장 간단한 선택지입니다. 표준 Node.js HTTP 서버를 실행할 수 있으며, 빠르게 시작해야 하고 통합할 기존 HTTP 서버가 없는 경우 권장됩니다. 요구사항이 변경되면 나중에 교체하는 것도 간단합니다.