옛 PHP 코드를 PHP 8 에 올리다 보면 사람이 하나씩 고치기엔 오류가 너무 많아 수정 스크립트를 쓰는 경우가 있습니다. 저희는 AI 도구와 함께 만들어 쓰는 PHP 업그레이드 키트(스캐너와 자동 수정 스크립트 묶음)로 옛 PHP 사이트를 작업합니다. PHP 8.4 부팅 시험을 하다가 그 안의 수정 스크립트 하나가 코드를 고치는 대신 망가뜨리는 것을 확인했습니다. 사이트 전체가 500 이 된 것은 가장 눈에 띄는 쪽이었습니다. 더 나쁜 것은 오류 없이 통과하면서 동작이 달라지는 쪽이었습니다. 이 글은 그 재현 과정과 고친 방법입니다.

어떤 스크립트였나

이 글에서 다루는 것은 키트의 수정 스크립트 중 정렬·array_push 계열 호출에 null 방어 가드를 넣는 수정기(가드 수정기)입니다.

PHP 7 까지는 null 을 sort() 나 array_push() 에 넘겨도 경고로 넘어갔지만, PHP 8 에서는 TypeError 로 죽습니다. 옛 코드에는 이런 호출이 많습니다. 이 스크립트는 해당 호출이 줄의 맨 앞에 있으면 바로 위에 방어 한 줄을 끼워 넣습니다.

if(!is_array($v)){ $v=array(); }   // [guard]

줄 단위 정규식으로 후보 줄을 찾고 그 위에 한 줄을 넣는 방식입니다. 대부분의 줄에서는 잘 작동합니다. 문제는 "그 줄이 어떤 문장의 일부인가"를 보지 않는다는 점이었습니다. 워드프레스 코어처럼 옛 코드에는 if (조건) 문장; 형태로 중괄호를 생략한 제어문이 있습니다. 줄만 보는 도구에게는 이것이 한 문장으로 보이지 않고 두 줄로 보입니다.

처음 터진 곳: 워드프레스가 통째로 500

공식 워드프레스 4.9.26 을 PHP 8.4.27 에 설치하는 시험에서 이 스크립트를 포함한 키트의 수정 스크립트 전체를 적용하자 설치가 HTTP 500 으로 끝났습니다. 로그는 이렇습니다.

PHP Parse error:  syntax error, unexpected token "elseif" in …/wp-includes/functions.php on line 730

적용 전후를 비교한 diff 입니다(워드프레스 코어 _http_build_query() 의 일부).

 		if ( is_array($v) || is_object($v) )
+			if(!is_array($ret)){ $ret=array(); } // [guard]
 			array_push($ret,_http_build_query($v, '', $sep, $k, $urlencode));
 		elseif ( $urlencode )
+			if(!is_array($ret)){ $ret=array(); } // [guard]
 			array_push($ret, $k.'='.urlencode($v));
 		else
+			if(!is_array($ret)){ $ret=array(); } // [guard]
 			array_push($ret, $k.'='.$v);

원본은 중괄호 없이 if (조건) 문장; elseif (조건) 문장; else 문장; 으로 쓴 코드입니다. 이런 문법에서는 if (조건) 바로 뒤의 문장 하나가 본문이라서, 가드 줄이 if (조건) 와 array_push 사이에 들어가면 본문은 가드(안쪽 if)가 되고 array_push 는 if 문 바깥의 독립된 문장이 됩니다. 그 뒤의 elseif 는 짝이 되는 if 가 없어 문법 오류이고, 사이트 전체가 죽었습니다. 문법 검사(php -l)로 본 실패 파일은 적용 전 14개, 문법 수정기만 적용한 뒤 1개였는데 이 스크립트까지 적용하니 2개가 되었고 새로 늘어난 파일이 functions.php 였습니다. 이 시험에서 가드가 들어간 곳은 모두 98곳이었고, 그중 중괄호 없는 본문에 들어간 곳은 5곳으로 보입니다(새 판이 감싸기로 처리한 건수이고, 위 세 곳과 아래 while 두 곳이 그에 해당합니다).

같은 실수가 낳는 세 가지 모양

중괄호 없는 제어문 앞에 가드를 끼웠을 때 나타나는 세 가지 모양
앞줄의 모양 가드를 끼운 뒤 눈에 띄는가
if/elseif/else 헤더(중괄호 없음) elseif 가 고아가 되어 Parse error 예, php -l 에 걸리고 사이트가 500
while 헤더(중괄호 없음) 본문이 가드뿐이 되고 원래 문장은 루프 밖으로 나감. 반복 조건이 변하지 않아 무한 루프 아니오, php -l 통과
if (조건) 문장; 가드가 본문, 원래 문장은 조건 없이 항상 실행 아니오, 오류도 경고도 없음

두 번째 모양은 같은 워드프레스의 텍스트 비교 화면 코드에서 나왔습니다.

 			while ( $diff_count < 0 )
+				if(!is_array($orig_rows)){ $orig_rows=array(); } // [guard]
 				array_push($orig_rows, $diff_count++);

$diff_count++ 가 루프 본문에서 빠졌으니 $diff_count < 0 은 영원히 참입니다. 문법 검사는 통과합니다. 이 코드는 글 수정 이력을 비교하는 화면에 쓰이는데, 이번 시험의 화면 순회에는 들어 있지 않아 사이트에서 열어 보지는 못했습니다. 같은 모양을 시험 사례로 만들어 제한 시간을 걸고 돌리면 원본 스크립트의 결과는 시간 초과로 끝났습니다.

세 번째 모양이 가장 위험합니다. 조건이 사라지는데 아무 오류도 나지 않기 때문입니다. 네 번째 문제도 함께 있었습니다. 스크립트 문서에는 "다시 실행해도 안전하다(멱등)"고 적혀 있었는데, 두 번 돌리면 가드가 또 붙었습니다.

그누보드에서는 어떻게 터졌나

같은 스크립트를 그누보드 공식 배포 트리 5개에 적용했을 때의 위험을 분류해 보았습니다(표는 원본 스크립트 기준). 워드프레스에서 본 elseif 고아와 무한 루프는 0곳이었고, 대신 다른 두 가지가 나왔습니다. 삼항 연산자 한가운데에 가드가 들어가 문법 오류가 된 곳, 그리고 중괄호 없는 if 본문에 가드가 들어가 조건이 사라진 곳입니다.

그누보드 공식 배포 트리별 가드 후보와 위험 분류(원본 스크립트 기준)
트리 가드 후보 중괄호 없는 if/else(의미 변경) 삼항 한가운데(문법 오류 후보) 적용 뒤 새로 생긴 문법 검사 실패
그누보드4 4.36.04 10 0 0 0
그누보드5 5.0.42 73 1 0 0
그누보드5 5.3.1.9 80 2 0 0
영카트5 5.3.1.9 트리 127 2 2문장 0*
그누보드5 5.6.48 135 1 2문장 1 (엑셀 라이브러리 파일)

*이미 다른 문제로 문법 검사에 실패하는 파일이어서 새 실패로 잡히지 않았습니다. 별도 시나리오에서 실패 건수가 2에서 3으로 늘어나는 것을 확인했습니다.

조건이 사라진 쪽은 실제로 확인했습니다. 5.6.48 에서 현재 테마 설정을 비우고 관리자 테마 화면을 열면, 원본 수정 스크립트를 적용한 트리에서는 "설치된 테마" 목록에 빈 항목이 하나 더 나왔고 PHP 경고가 1건 찍혔습니다. 적용하지 않은 트리와 수정판을 적용한 트리에서는 항목이 하나였습니다.

줄이 아니라 토큰으로 다시 만들었다

고친 방법은 줄 단위 정규식을 PHP 자신의 토크나이저(token_get_all)로 바꾸는 것이었습니다. 토크나이저는 문자열·히어독·주석 속 글자를 코드와 구별하고 호출이 어느 문장의 어느 자리에 있는지도 알려 줍니다. 호출 바로 앞의 유효한 토큰이 무엇인지에 따라 세 가지로 나눕니다.

  • 앞이 ; { } : 이거나 <?php 이면 문장의 시작이므로 위에 한 줄을 끼웁니다(기존 방식).
  • 앞이 else, do, 또는 if/elseif/while/for/foreach 의 닫는 ) 이면 중괄호 없는 본문입니다. 가드와 원래 문장을 중괄호로 함께 감쌉니다.
  • 그 밖에 , ( = . && 삼항의 :, for(;;) 머리처럼 식의 중간이거나, 여러 줄에 걸친 중괄호 없는 본문이면 건드리지 않고 "사람이 보라"고 보고만 합니다.
while ( $diff_count < 0 )
	{ if(!is_array($orig_rows)){ $orig_rows=array(); } /*[guard]*/ array_push($orig_rows, $diff_count++); }

안전장치도 넣었습니다. 파일을 쓰기 전에 수정본을 다시 파싱해서 원본은 파싱되는데 수정본이 안 되면 원본을 그대로 두고 "되돌림"을 보고합니다. 이미 가드가 붙은 호출은 건너뛰어 다시 실행해도 가드가 늘지 않고, 줄바꿈(CRLF)과 EUC-KR 바이트는 그대로 둡니다. 옛 판이 이미 고친 트리를 위해, 중괄호 없는 본문 아래에 가드 표지가 있으면 "옛 판의 피해"로 경고하는 탐지도 넣었습니다(보고만 하므로 원본으로 되돌려 다시 돌려야 합니다).

얼마나 확인했나

워드프레스 4.9.26 에 새 판을 적용하니 49개 파일에 98개 가드가 들어갔고, 그중 5곳은 중괄호로 감쌌고, 38곳은 건너뛰고 보고했습니다(예: 인자가 $this->stack 인 호출). 문법 검사 실패는 적용 전 14개에서 적용 뒤 1개로 줄었고, 문법 수정기만 적용한 결과와 같았습니다. 호환 파일과 수정 스크립트 전체를 함께 쓴 시나리오는 설치가 성공했고 순회 결과는 일부만 쓴 시나리오와 같았습니다. 같은 28개 사례를 원본 스크립트에 돌리자 28개 사례 모두 어느 검사에선가 실패했고(검사 단위로 496건 통과, 106건 실패), 문법 오류로 실행되지 않거나, 제한 시간 안에 끝나지 않거나, 두 번째 적용이 또 파일을 바꾸는(멱등 위반) 사례가 나왔습니다. 새 판을 포함한 키트 전체의 최종 시험은 로컬 PHP 8.2 에서 685건, 도커 PHP 8.4 에서 697건을 통과했고 실패는 0건입니다(둘 다 같은 명령으로 다시 돌려 확인).

시험을 시험하려고 코드를 일부러 망가뜨려 봤다

시험이 초록이라는 것만으로는 시험이 쓸모 있다는 뜻이 아닙니다. 그래서 도구의 조건 하나를 일부러 틀리게 바꿔(변이) 시험이 빨개지는지 봤습니다. 가드 수정기에 29종(옛 판의 피해 탐지 7종 포함), 키트 전체로 143종을 만들었습니다. 처음에는 144종 중 138종만 잡혔고, 살아남은 6종 중 5종은 시험을 보강해 잡았으며 1종은 결과가 달라지지 않는 등가 변이라 목록에서 뺐습니다. 지금은 143종이 모두 잡힙니다.

이 점검은 도구의 실제 결함도 하나 찾았습니다. count() 를 안전한 호출로 바꾸는 수정기의 사전 필터가 대소문자를 구분해서 sizeOf(·COUNT( 만 쓰는 파일을 통째로 건너뛰고 있었습니다(PHP 함수 이름은 대소문자를 가리지 않습니다). sizeOf($a) 만 있는 파일에서 0건이 나오는 것을 재현했고, 필터를 고치고 시험을 보강했습니다.

안 된 것과 남은 것

  • 식의 중간이나 여러 줄 본문은 사람이 고쳐야 합니다. 가드는 값이 null 이 아닌 문자열·객체도 빈 배열로 바꾸고(설계 그대로), 미정의 변수를 읽으면 PHP 8 은 경고를 냅니다.
  • 경로에 /data/, /cache/, /logs/, /uploads/ 가 들어 있으면 전체를 조용히 건너뜁니다. 이 필터는 그대로입니다.
  • 그누보드는 수정판 키트로 다시 돌렸습니다. 문법 검사 실패가 공식 트리 5개에서 적용 전 2~35건이던 것이 적용 뒤 0~1건이 되었고, 남은 1건은 가드와 무관한 __autoload 선언 또는 루프 밖 break 였습니다. 원본 스크립트가 5.6.48 에서 만든 엑셀 라이브러리 문법 오류도 나오지 않았습니다. 위 표와 테마 화면 재현은 원본 스크립트 기준입니다.
  • 같은 키트의 다른 수정기에서도 결함을 찾아 고쳤습니다. function &count() 정의까지 건드린 것, <?= $n > 5 ? 'a':'b' ?> 의 > 를 태그 닫기로 오인해 문법 검사는 통과하지만 화면이 깨지게 만든 것, 스캐너가 가드한 호출을 계속 보고한 것(12건이 가드 뒤에도 12건, 고친 뒤 6건), PHP4 생성자 수정기의 두 결함(① 생성자 이름을 바꾸면서 $this->옛이름()·parent::옛이름() 같은 호출부를 갱신하지 않은 것으로, 고친 뒤 WP 3.9.40 의 XML-RPC 가 500 에서 200 으로 바뀌고 addTwoNumbers(2,40)=42 응답을 확인했습니다. ② 부모가 옛 이름 껍데기를 함께 가진 클래스(WP_Widget)에서 자식 생성자 개명이 껍데기와 만나 무한 재귀가 되는 것으로, WP 3.0.6 에서 재현했고 고치자 호출부 수정이 9건에서 22건이 되었습니다), 문법 수정기가 ] { 0 } 같은 공백 변형을 놓친 것, 호환 파일의 mysql_ping 이 8.4 에서 알림을 낸 것입니다. 상수 배열 키에 따옴표를 붙여 뜻을 바꾸는 수정기는 define()·내장 상수를 지키게 고쳤지만, 도구를 돌리는 PHP 에 없는 확장의 상수는 알 수 없어 MYSQLI_TYPE_* 27곳이 바뀐 사례가 있었습니다.

자동 수정 도구를 쓸 때 저희가 하는 점검

  1. 적용 전에 복사본을 두고, 적용 뒤에는 바뀐 줄만 diff 로 훑습니다. 도구가 남긴 표지가 있다면 바로 윗줄이 if, elseif, else, while, for, foreach 의 머리인지 봅니다.
  2. 모든 파일에 php -l 을 돌립니다. 다만 이것은 문법만 봅니다. 무한 루프와 조건 소실은 통과합니다.
  3. 문법 검사로 잡히지 않는 오류는 같은 입력을 적용 전과 후에 넣어 결과를 비교합니다. 반복 구간은 제한 시간을 걸고 돌립니다.
  4. "다시 실행해도 안전하다"는 문서의 말을 믿지 말고 두 번 돌려 diff 가 비어 있는지 봅니다.
  5. 도구의 시험을 직접 만들었다면 조건을 일부러 틀리게 바꿔 시험이 빨개지는지 봅니다.

"고친 뒤 문법 검사가 통과했다"는 검증이 아닙니다. 고친 코드가 원래와 같은 일을 하는지를 확인해야 합니다. 이 시험에서도 문법 검사가 잡아낸 것은 elseif 고아(functions.php)뿐이었고, 무한 루프와 조건 소실은 돌려 보고서야 드러났습니다. 이 글의 키트와 시험은 AI 도구와 함께 만들고 돌렸습니다.