Sylius 1.x에서 2.0으로의 스택 현대화 및 아키텍처 전면 재설계

Migrating Sylius 1.x to 2.0: A Complete Guide

Pierre-Arthur DEMENGEL2026년 4월 11일4분intermediate

AI 요약

Context

Semantic UI, jQuery 및 구형 Symfony 번들 기반의 레거시 스택으로 인한 유지보수 효율성 저하. Twig 템플릿의 전체 파일 오버라이드 방식에 따른 코드 중복과 확장성 제약 발생.

Twig Hooks 도입을 통한 템플릿 구조의 Composable 설계로 전환하여 파일 전체 복사 없이 특정 블록만 수정하는 구조 구현
winzou State Machine을 Symfony Workflow로 대체하여 프레임워크 표준 기반의 상태 전이 및 이벤트 구독 모델 채택
Payum 기반 결제 시스템을 새로운 Payment Requests 아키텍처로 변경하여 결제 처리 로직의 유연성 확보
Semantic UI와 jQuery를 제거하고 Bootstrap 5 및 Symfony UX(Turbo, Stimulus)를 도입하여 프론트엔드 반응성 및 현대적 컴포넌트 구조 구축
SwiftMailer를 symfony/mailer로 교체하여 최신 메일 전송 표준 및 인터페이스 준수
API Platform 3에서 4로 업그레이드하여 리소스 설정 및 데이터 처리 프로세스의 최신화 달성

실천 포인트

1. Twig 템플릿 오버라이드 파일 개수 전수 조사 및 Twig Hook 매핑 리스트 작성

2. composer.json 내 서드파티 플러그인의

2.x 버전 호환성 여부 및 업데이트 로드맵 확인

3. Custom State Machine 콜백을 Symfony Workflow Event Subscriber로 재작성하는 전략 수립

4. Headless 구조가 아닐 경우 Semantic UI 클래스를 Bootstrap 5로 치환하는 UI 마이그레이션 계획 수립

태그