PHP 멀티테넌트 플랫폼에 Vue 3 + Vite 아일랜드 아키텍처 적용기

관리자 2026-07-25 21:33 조회 272
하나의 PHP 플랫폼에서 도메인마다 다른 테마를 서빙하면서도 최신 프론트엔드(Vue 3)를 도입하고 싶었습니다. 전면 SPA 전환 대신 **PHP 서버 렌더링 + Vue 아일랜드(island)** 방식을 선택했습니다. ## 구조 PHP가 페이지의 뼈대와 SEO를 렌더링하고, 특정 영역만 Vue 컴포넌트로 hydrate합니다. 마운트 지점과 데이터는 PHP가 심습니다. ```mermaid graph TD REQ[요청 /sub/nas.php] --> PHP[PHP 라우팅 · 테마 오버라이드] PHP --> HEAD[SEO · head 렌더] PHP --> MNT["마운트 노드 + props(pageKey)"] MNT --> VUE[Vite 번들 · Vue 컴포넌트 hydrate] ``` - PHP가 `data-it-hp-props`에 `pageKey` 등 props를 JSON으로 주입 - Vue `main.js`가 마운트 노드를 찾아 `createApp().mount()` 실행 - 페이지별 콘텐츠는 `pageKey`로 분기 ## Vite 번들 · 캐시버스팅 테마별로 Vite 번들을 빌드하고 `manifest.json` 기준으로 엔트리·청크를 배포합니다. 파일명 해시로 캐시버스팅되어 브라우저 캐시 문제를 원천 차단합니다. | 항목 | 방식 | | :--- | :--- | | 엔트리 | `main-[hash].js` | | 배포 | manifest 클로저 계산 → 변경분만 | | 캐시 | 해시 파일명 → 강제 갱신 불필요 | ## 장점 - 기존 PHP 자산·SEO를 유지하며 점진적 현대화 - 도메인별 테마 격리, 공통 컴포넌트 재사용 - 초기 로딩은 SSR, 상호작용은 Vue로 분담 ## 마무리 전면 재작성 없이 레거시 PHP 위에 Vue를 얹어, 유지보수성과 사용자 경험을 동시에 끌어올렸습니다. 멀티테넌트 환경에서 프레임워크를 점진 도입하려는 팀에 유효한 패턴입니다.
KO