파일과 데이터베이스를 옮기고 나면 새 사이트는 여전히 옛 주소를 가리키고 있습니다. 본문의 이미지 경로, 메뉴 링크, 위젯 설정, 테마 설정, 플러그인 옵션에 옛 도메인이 흩어져 있습니다.
여기서 데이터베이스에 UPDATE … REPLACE() 를 한 줄 날리고 싶어집니다. 그 한 줄이 설정을 지웁니다. 왜 그런지 한 번만 이해하면 다시는 그 유혹에 빠지지 않습니다.
직렬화는 길이를 함께 적어 둡니다
워드프레스는 배열 형태의 설정을 직렬화된 문자열로 한 칸에 저장합니다. 그 형식은 값만 적는 것이 아니라 문자열이 몇 글자인지를 함께 적습니다.
a:1:{s:4:"logo";s:34:"https://old-domain.example/logo.png";}
↑ "뒤 문자열은 34자" 라는 선언
SQL 로 도메인만 바꾼 뒤 (길이 선언은 그대로다)
a:1:{s:4:"logo";s:34:"https://new.example/logo.png";}
↑ 실제로는 28자 — 선언과 어긋난다
길이가 어긋난 값은 되읽을 때 실패합니다. 실패하면 워드프레스는 그 옵션을 없는 것으로 취급합니다. 화면에서는 로고가 사라지고, 위젯이 초기값으로 돌아가고, 커스터마이저 설정이 비어 있습니다. 에러 메시지는 어디에도 없습니다. 사이트는 정상적으로 열리고 설정만 초기화된 것처럼 보이기 때문에, 원인을 도메인 치환에서 찾기까지 한참 걸립니다.
먼저 예행 연습, 그리고 guid 제외
도구는 wp search-replace 입니다. 값을 읽어 풀고, 안쪽 문자열을 바꾸고, 다시 묶어서 씁니다. 길이는 그 과정에서 자동으로 다시 계산됩니다.
실행 전에 무엇이 몇 건 바뀌는지부터 봅니다.
wp search-replace 'https://old-domain.example' 'https://new.example' --dry-run --report-changed-only
테이블별 건수가 나옵니다. 예상보다 훨씬 많다면 검색어가 너무 짧다는 신호이고, 예상보다 적다면 옛 주소가 여러 형태로 섞여 있다는 신호입니다.
납득되는 숫자가 나오면 그때 백업을 뜨고, 실제 실행에는 플래그를 하나 더 붙입니다.
wp search-replace 'https://old-domain.example' 'https://new.example' --skip-columns=guid --report-changed-only
guid 는 주소처럼 생겼지만 주소가 아니라 영구 식별자입니다. 프론트엔드의 링크는 퍼머링크 규칙이 만들고, guid 는 피드 리더가 “이 글을 전에 본 적 있는가” 를 판단하는 데만 쓰입니다. 그래서 guid 를 바꾸면 구독자의 피드에서 과거 글 전체가 새 글로 다시 뜹니다. 우리 화면은 멀쩡하고 문제는 남의 화면에서만 일어나는, 발견하기 가장 어려운 종류의 사고입니다.
옛 주소는 한 가지 형태가 아닙니다
치환을 한 번 돌리고 끝났다고 생각했는데 옛 주소가 남아 있는 경우가 흔합니다. 옛 주소가 데이터베이스 안에 여러 표기로 들어 있기 때문입니다.
마지막 형태가 특히 잘 빠집니다. 블록 에디터나 일부 플러그인은 값을 다시 한 번 감싸서 저장하기 때문에 슬래시 앞에 역슬래시가 붙습니다. 이 형태는 평범한 검색어로는 잡히지 않으므로 따로 한 번 더 돌립니다.
치환이 끝나면 siteurl 과 home 두 옵션의 값을 직접 확인하고, 관리자에 로그인해 위젯 · 메뉴 · 커스터마이저가 그대로 남아 있는지 한 번 봅니다. 여기까지가 치환의 마지막 단계입니다.
데이터베이스를 다루는 다른 작업들은 개발 워크플로우 아카이브에 있고, 치환과 검증까지 포함한 이전을 맡기고 싶다면 최적화 지원 사업에서 다룹니다.
다음 회차
새 서버에 사이트가 제대로 서 있습니다. 이제 세상에 알릴 차례인데, DNS 전환은 되돌릴 준비를 먼저 해 두는 작업입니다.