제로보드4 → 라이믹스 이전 툴킷 (XE 경유 없이 직행)

제로보드4 사이트를 라이믹스로 옮길 때 쓰는 변환 도구 모음입니다. XE를 거치지 않으므로 PHP 5.3 스택을 재현할 필요가 없고, 최신 PHP에서 전 과정이 돌아갑니다.

실제 이전 프로젝트에서 문서 4,311건 · 댓글 6,905건 · 회원 188명 · 첨부 317건 · 쪽지 22건을 옮기며 사용한 도구입니다. 원본과 건수가 일치하는 것을 확인했습니다.

구성

• zb4-to-xexml.php — 회원·게시글·댓글·첨부를 XE-XML로 추출하는 핵심 도구
• zb4-messages.php — 쪽지를 라이믹스 message 형식으로 변환
• validate-xexml.php — 생성된 XML의 구조와 건수 검증
• rx-import.sh — 라이믹스 importer 구동 (로그인 → 게시판 생성 → 임포트 루프)
• README.md — 설정, 사용법, 배포 후 점검 항목

왜 XE를 거치지 않는가

흔히 안내되는 경로는 제로보드4에서 XML을 뽑아 XE 1.4.5.7에 복원하고, XE를 단계별로 업그레이드한 뒤 라이믹스로 전환하는 것입니다. 문제는 그 도구들이 PHP 5.3 시절 스택을 요구한다는 점입니다. 요즘 서버에서 그 환경을 재현하는 일 자체가 하나의 프로젝트가 됩니다.

라이믹스는 XE의 importer 모듈을 그대로 계승했습니다. 제로보드4 형식의 XML을 직접 받으므로 XE를 중간에 세울 이유가 없습니다. 이 도구는 최신 PHP로 그 XML을 만듭니다.

요구사항

• PHP 8.x CLI (mysqli 확장)
• 제로보드4 데이터베이스가 UTF-8로 복원된 상태
• 라이믹스 2.x 설치본과 관리자 계정

자격증명은 코드에 넣지 않습니다

모든 접속 정보를 .env 파일에서 런타임에 읽습니다. 스크립트나 명령문에 비밀번호가 남지 않습니다. 경로도 환경변수로 지정해 어느 프로젝트 구조에서나 그대로 씁니다.

미리 알아 둘 것

도구의 한계가 아니라 형식과 구조에서 오는 제약이 둘 있습니다. README에 자세히 적었습니다.

• 회원 비밀번호는 옮겨지지 않습니다. 제로보드4는 MySQL의 PASSWORD() 해시를 쓰는데 라이믹스가 지원하는 방식이 아닙니다. 어떤 도구를 쓰든 같으며, 이전 후 전 회원 재설정 안내가 필요합니다.
• 답글 계층은 평탄화됩니다. XE-XML 형식에 부모 개념이 없어 시간순 목록이 됩니다.

배포 후 점검 항목 포함

이전이 끝나고 서버에 올린 뒤 증상이 원인을 전혀 가리키지 않는 함정이 셋 있습니다. 관리자 메뉴가 비어 보이는 것, 설정을 저장해도 반영되지 않는 것, 스킨 설정만 먹통이 되는 것입니다. 각각의 원인과 해결을 README에 정리했습니다.

함께 보면 좋은 자료

전체 절차와 함정을 다룬 전자책이 있습니다. 제로보드4에서 라이믹스로 — 실전 이전 가이드 (PDF 24쪽)

라이선스

구매자의 프로젝트에 자유롭게 사용할 수 있습니다. 재배포와 재판매는 허용되지 않습니다.