워드프레스 본문을 스크립트로 고치다 글이 망가진 세 가지

먼저 결론

겪은 일: 스크립트로 본문을 고친 뒤 문단 사이에 \n\n 이 글자로 보이거나, 모바일에서 문장마다 줄이 끊기거나, 본문이 통째로 사라졌습니다.

원인: 각각 wp db query 출력의 이스케이프, <p> 안의 줄바꿈, PHP 정규식 구분자 충돌 때문이었습니다.

이렇게 풀었다: 본문은 wp post get --field=content 로 읽고, 저장 전에 결과를 세어 보고, 백업과 안전장치를 먼저 둡니다.

워드프레스 글 본문을 관리 화면이 아니라 스크립트로 고치다 세 번 글을 망가뜨렸습니다. 세 번 모두 명령은 오류 없이 끝났고, 망가진 것은 화면을 본 뒤에야 알았습니다.

세 사고를 한 표로

사고 보인 것 원인 센 숫자
첫째 문단 사이마다 \n\n 글자 wp db query 가 줄바꿈을 두 글자로 바꿔 냄 진짜 줄바꿈 0개, 글자 \n 132개
둘째 모바일에서 문장마다 한 줄 <p> 안의 줄바꿈을 wpautop 이 <br> 로 그림 6편을 합쳐 고침
셋째 본문이 통째로 빈 글 정규식 구분자 # 가 &#160; 의 # 와 충돌 백업으로 바로 복구

첫째, 문단 사이에 \n\n 이 글자로 보였다

2026년 7월 19일, 공개된 글의 이미지 순서를 바꾸려고 wp db query "SELECT post_content ..." 로 본문을 읽었습니다. src 만 바꾼 뒤 wp post update <id> - 로 다시 저장했더니 문단 사이마다 \n\n 이 보였습니다.

wp db query 의 출력은 표 형식(TSV)이라 칸 안의 진짜 줄바꿈을 두 글자 \n 으로 바꿔 냅니다. 화면에 찍힌 \n 을 "보일 때만 그렇다"고 넘긴 것이 실수였습니다. 고칠 본문은 원문이 그대로 나오는 wp post get <id> --field=content 로 읽어야 합니다. 이미 박힌 경우에는 글자 \n 을 진짜 줄바꿈으로 되돌리면 이미지와 태그는 다치지 않고 복구됩니다.

둘째, 모바일에서 문장마다 줄이 끊겼다

2026년 6월 30일, 붙여 넣은 본문이 <p>문장1.\n문장2.\n문장3.</p> 처럼 한 문단 안에서 문장 사이를 줄바꿈으로 나누고 있었습니다. 워드프레스의 wpautop 은 문단 안의 줄바꿈을 <br> 로 그리기 때문에 모바일에서 문장마다 한 줄씩 끊겨 보였습니다.

진단에서 놓친 이유는 문단 길이만 봤기 때문입니다. 문단당 문장 수는 정상이었습니다. 줄 끝을 보이게 하는 cat -A 로 <p> 안에 $ 가 있는지 봐야 잡힙니다. 고칠 때는 <p> 안의 줄바꿈만 공백으로 바꾸고, 문단 사이의 빈 줄은 그대로 둡니다.

import re
html = re.sub(r'<p>(.*?)</p>',
              lambda m: '<p>' + re.sub(r'[ \t]*\n[ \t]*', ' ', m.group(1)) + '</p>',
              html, flags=re.S)

셋째, 정규식 치환 뒤 본문이 통째로 비었다

2026년 6월 23일, wp eval 안에서 preg_replace 로 문단을 고쳤습니다. 패턴을 # 로 감쌌는데 패턴 안에 &#160; 이 있었습니다. 그 # 가 구분자와 부딪혀 패턴이 깨졌고, preg_replace 는 null 을 돌려줬습니다. 그 null 이 그대로 본문으로 저장돼 글이 비었습니다.

PHP 공식 문서에도 preg_replace 는 오류가 나면 null 을 돌려준다고 적혀 있습니다. 결과를 확인하지 않고 저장하면 오류가 곧 삭제가 됩니다. 구분자는 / 를 쓰고 패턴 안에 / 가 없게 했습니다.

저장하기 전에 세는 것

세 사고 이후 본문을 다시 저장하는 스크립트에는 아래 검사를 붙였습니다. 결과가 이상하면 저장하지 않고 멈춥니다.

$new = preg_replace('/패턴/', '바꿀값', $old);
if ($new === null || $new === '' || strlen($old) - strlen($new) > 200) {
    exit("중단: 결과가 비었거나 너무 많이 줄었습니다\n");
}

저장한 뒤에는 다시 읽어서 진짜 줄바꿈이 0 보다 많고 글자 \n 이 0 인지 셉니다.

wp post get 123 --field=content > after.html
wc -l < after.html                 # 진짜 줄바꿈 수, 0 보다 커야 함
grep -o '\\n' after.html | wc -l   # 글자 \n 수, 0 이어야 함

되돌릴 길을 먼저 만든다

  • 본문을 건드리기 전에 원문을 파일로 떠 둡니다. 셋째 사고는 이 백업 덕분에 바로 복구했습니다.
  • 이미지 주소만 바꾸는 일은 본문을 읽고 쓰지 않고 wp search-replace 를 쓰는 도구로 합니다. 이 길은 위 함정을 밟지 않았습니다.
  • 순서 바꾸기처럼 도구가 못 하는 일만 직접 손대고, 그때는 위 검산을 반드시 붙입니다.

함께 보면 좋은 글

명령은 성공인데 결과가 다른 경우는 wp-cli 가 Success 라는데 안 바뀌었을 때에 더 있습니다. 둘째 사고 무렵 비슷한 줄 끊김을 처음에 캐시 탓으로 읽었다가 틀린 적도 있는데, 캐시인지 가리는 법은 워드프레스 수정이 화면에 안 보일 때에 적었습니다.

이 글의 내용은 2026년 10월 8일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.