제로보드4에서 라이믹스로 — 실전 이전 가이드

제로보드4로 만든 사이트를 최신 PHP 환경으로 옮겨야 하는데, 검색해 보면 "XE를 거쳐서 가라"는 안내만 나옵니다. 그런데 그 경로는 PHP 5.3 시절 스택을 요구합니다.

이 책은 XE를 건너뛰고 라이믹스로 직행하는 경로를 다룹니다. 실제 이전 프로젝트에서 문서 4,311건, 댓글 6,905건, 회원 188명, 첨부 317건, 쪽지 22건을 옮기며 만난 함정과 해법을 그대로 담았습니다. 최종 배포 환경의 PHP는 8.4입니다.

이 책이 다루는 것

• 경로 선택의 근거 — XE 1.x가 개발 중단됐고 XE3가 별개 제품인 상황에서, 왜 라이믹스가 사실상 "PHP 8용 XE"인지
• 데이터베이스 인코딩의 첫 함정 — 테이블은 EUC-KR인데 내용은 이미 UTF-8인 덤프를 어떻게 알아보고 어떻게 복원하는지. iconv에 euc-kr 대신 cp949를 줘야 하는 이유
• 옛 사이트를 최신 PHP에서 띄우기 — 단축 태그·mysql_ 함수·따옴표 없는 배열 키를 각각 어떻게 넘기는지. 그리고 "고쳤는데 화면이 안 바뀌는" opcache 함정
• XML 추출 — XE-XML의 base64 규칙과 날짜 형식, 라이믹스 importer가 리터럴 스캔으로 파싱한다는 사실, 건수 대조로 신뢰성을 증명하는 법
• importer 자동화와 CSRF의 벽 — 토큰 검사가 꺼져 있는데도 curl 요청이 거부되는 이유와, 헤더 한 줄로 통과하는 법. 3단계 호출 흐름과 데모 게시판 mid 충돌
• 회원·첨부·쪽지 — 비밀번호가 어떤 도구로도 옮겨지지 않는 구조적 이유, 첨부 방식 세 가지의 선택 기준, 쪽지의 회원 매핑
• 배포 함정 세 가지 — 관리자 메뉴가 비는 rx_sequence, 설정이 반영되지 않는 도메인 미등록, 스킨 설정만 먹통이 되는 저장 위치 문제. 셋 다 증상이 원인을 가리키지 않습니다
• 레이아웃과 스킨 — 관리자가 로고·배경을 바꾸게 만드는 법, 이미지 경로 리라이트의 예외, 옛 디자인을 어디까지 살릴지의 기준

이 책의 태도

확인한 것과 확인하지 못한 것을 구분해 적었습니다. 건수 대조와 화면 검증은 실제 수행한 결과이고, 회원 비밀번호를 옮기지 못한 것과 원본 첨부 9건을 복구하지 못한 것은 원인과 함께 그대로 밝혔습니다.

이런 분께 권합니다

• 제로보드4 사이트를 넘겨받았는데 어디서 시작할지 막막한 분
• XE 경유 경로를 시도하다 PHP 5.3 스택에서 막힌 분
• 이전은 끝냈는데 서버에서만 설정이 반영되지 않아 원인을 못 찾는 분
• 옛 게시판 사이트의 유지보수를 맡고 있는 분

부록

10단계 전체 순서표, 자주 쓰는 명령 모음, 그리고 증상으로 원인을 찾는 표를 실었습니다. 작업 중에 막혔을 때 증상 하나로 해당 절을 바로 찾을 수 있습니다.

전자책 정보
저자 이온디 · PDF · 24쪽 · 2026년 초판