피드로 돌아가기
Dev.toBackend
원문 읽기
Deploying a Laravel API + Separate Frontend (Next.js, Nuxt, SPA) on Deploynix
Deploynix에서 Laravel API와 Next.js/Nuxt 등 별도 프론트엔드를 독립적으로 배포하는 아키텍처 구성 및 CORS, Sanctum 인증, API 버저닝을 통한 동기화 전략
AI 요약
Context
Laravel 기반 애플리케이션이 Blade 템플릿 중심에서 순수 API + 독립 JavaScript 프론트엔드 프레임워크(Next.js, Nuxt, React, Vue, Svelte) 조합으로 전환되면서, 두 애플리케이션의 배포 조율, 환경 변수 관리, CORS 설정, 인증 토큰 처리 등 배포 복잡도가 대폭 증가했다. 프론트엔드와 백엔드가 독립적인 배포 주기를 따르면서 API 버저닝과 네트워크 경계 설정이 필수 고려사항이 되었다.
실천 포인트
Laravel 기반 분리형 아키텍처(API + 프론트엔드)를 구축하는 팀은 초기에 단일 서버에서 두 사이트로 시작하여 트래픽 증가에 따라 서버를 분리하되, Sanctum STATEFUL_DOMAINS에 localhost:3000을 포함시켜 개발 중 로컬 인증을 지원하고, CORS 설정에서 와일드카드 대신 명시적 도메인 화이트리스트를 적용하며, /v1/ 같은 버전 접두사로 API 진화와 프론트엔드 배포 독립성을 확보할 수 있다.