Technote

개발 워크플로우 실무

연재 사이트 이전 실전 8부 중 3부

도메인 치환 — SQL 한 줄이 설정을 지웁니다

데이터베이스 안의 옛 주소를 SQL 로 바꾸면 위젯과 테마 설정이 조용히 빈 값이 됩니다. 직렬화가 문자열 길이를 함께 저장하기 때문입니다.

파일과 데이터베이스를 옮기고 나면 새 사이트는 여전히 옛 주소를 가리키고 있습니다. 본문의 이미지 경로, 메뉴 링크, 위젯 설정, 테마 설정, 플러그인 옵션에 옛 도메인이 흩어져 있습니다.

여기서 데이터베이스에 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 전환은 되돌릴 준비를 먼저 해 두는 작업입니다.

이 주제의 다른 글

노하우 목록으로

개발 워크플로우 실무

스테이징에서 먼저 올려 보는 30분

스테이징은 개발자만 쓰는 장치가 아닙니다. 프로덕션에서 복구하는 데 드는 하루와 스테이징에서 확인하는 30분을 비교하면, 이것은 취향이 아니라 계산입니다.

운영 · 관리자 3분 읽기

개발 워크플로우 실무

예외는 QA 가 아니라 명세에서 다룹니다

빈 상태 · 실패 · 권한 없음 · 아주 긴 값. 구현이 의도에서 갈라지는 자리는 거의 항상 이 넷 중 하나이고, 넷 다 명세에서 한 줄이면 끝나는 것들입니다.

기획자 3분 읽기

개발 워크플로우 실무

자주 울리는 알림은 결국 꺼집니다

알림을 무시하기 시작하면 그 감시는 이미 고장 난 것입니다. 게다가 꺼진 알림은 없는 알림보다 나쁩니다 — 지켜지고 있다는 착각을 남기기 때문입니다.

운영 · 관리자 4분 읽기

₩270,000 · 신청하기