PHP 레거시 시스템을 Spring Boot로 전환하며 고민했던 기록들

💭 전환 경험을 통한 회고

진행했던 시스템 개편 프로젝트는 단순히 언어를 PHP에서 Spring Boot로 바꾸는 것을 넘어, 보안과 안정성을 강화한 현대적 아키텍처로의 재설계를 목표로 했습니다.

하지만 과정은 쉽지 않았습니다.

절차 지향적으로 짜여진 기존 코드는 여러 파일과 DB 프로시저에 로직이 파편화되어 있어 비즈니스 흐름을 파악하는 것조차 거대한 도전이었습니다.

여기에 Spring Boot의 Bean 관리와 같은 프레임워크의 구조를 익히고, Thymeleaf를 활용해 프론트엔드까지 통합 구현해야 하는 과제가 주어졌습니다.

 

이번 포스팅에서는 이러한 '언어의 장벽'과 '구조적 복잡성'이라는 난관을 어떻게 하나씩 풀어내며 시스템을 안착시켰는지, 고민의 흔적들을 기록해보려 합니다.

 

---

🚩 자유로운 PHP vs 엄격한 Spring Boot

가장 먼저 마주한 벽은 프레임워크의 구조적 차이였습니다.

PHP 환경에서는 비교적 자유롭게 파일을 구성하고 로직을 배치할 수 있었지만, Spring Boot 3는 Bean 관리, 의존성 주입(DI), 계층형 아키텍처(Layered Architecture)라는 엄격한 규칙이 존재했습니다.

 

	기존 환경 (Legacy PHP)	신규 환경 (Spring Boot 3)
프로그래밍 패러다임	절차 지향 중심	객체 지향 (OOP) 중심
데이터 타입	느슨한 타입 (Array 위주)	강한 타입 (DTO/Entity)
로직 관리	파일 및 DB 프로시저 파편화	Layered Architecture
화면 렌더링	PHP 내장 템플릿	Thymeleaf 엔진
배포 방식	FTP 수동 업로드	GitLab CI/CD 자동화

 

---

🛠️ 이번 프로젝트를 통해 내재화한 핵심 역량

단순한 언어 습득을 넘어, 적용될 시스템에 적응하기 위해 다음과 같은 역량들을 집중적으로 강화했습니다.

• Spring 프레임워크의 핵심 메커니즘 이해
  • 제어의 역전(IoC)과 의존성 주입(DI)을 통한 Bean 관리 원리를 파악하여, 객체 간의 결합도를 낮추는 설계를 익혔습니다.
• 데이터의 규격화 및 계층형 아키텍처(Layered Architecture) 적용
  • Controller-Service-Repository로 이어지는 계층 분리를 통해 각 레이어의 역할을 명확히 하고, 데이터의 안정적인 흐름을 설계했습니다.
  • 느슨한 데이터 구조 대신 강한 타입 기반의 DTO/Entity 계층화를 통해 데이터 무결성을 확보했습니다.
• SSR(Server Side Rendering)과 Thymeleaf의 조화
  • 서버 사이드 렌더링의 동작 방식을 심도 있게 이해하고, Thymeleaf 템플릿 엔진을 활용해 백엔드 데이터를 효율적으로 화면에 투영하는 풀스택적 역량을 발휘했습니다.
  • 기존의 퍼블리싱 및 프론트엔드 실무 경험을 바탕으로, 서버에서 내려주는 데이터가 화면에 가장 효율적으로 그려질 수 있는 최적의 구조를 설계했습니다.
• 안정적인 운영을 위한 신규 배포 파이프라인 가이드 습득
  • 기존 수동 배포 방식의 한계를 인지하고, CI/CD 파이프라인 기반의 새로운 배포 가이드를 익혀 휴먼 에러를 원천 차단하는 운영 마인드를 갖추었습니다.

---

💬 회고를 마치며

우여곡절 끝에 약 1년 간의 서비스 고도화 겸 사이트 리뉴얼이 완성되었고 Spring Boot로의 전환을 마쳤습니다.

하지만 코드를 바꾸는 것만큼 중요했던 숙제가 하나 더 남았습니다.

바로 불안한 FTP 배포 방식이 아닌 다른 배포 방식을 적용해 내는 일이었는데요.

이 파이프라인을 개선하며 서비스 장애율을 기존 대비 80% 이상 낮춘 이야기는 다음 포스팅에서 자세히 다뤄보겠습니다!