PHP 호환성 점검, 웹사이트 수백 개를 파이썬으로 살펴본 이유

바이거는 웹사이트 수백 개의 PHP 호환성 오류를 점검하기 위해 파이썬 파이프라인을 직접 만들었습니다. 사이트가 하나라면 담당자가 파일을 살펴보고 주요 화면을 열어볼 수 있습니다. 수백 개라면 질문이 달라집니다. 같은 오류를 공유하는 사이트는 어디이고, 공통 코드를 고친 뒤에도 따로 확인해야 할 곳은 어디일까요?

PHP 8.2를 쓰고 있다면 지금 필요한 목록

PHP 프로젝트가 공지한 8.2 계열의 보안 지원 종료일은 2026년 12월 31일입니다. 그날 사이트가 멈추는 것은 아닙니다. 다만 이후 발견되는 문제에 대해 PHP 프로젝트의 보안 수정을 기대할 수 없으므로, 운영팀에는 이전 대상을 파악하고 시험할 시간이 필요합니다. PHP 공식 지원 일정

예를 들어 여러 브랜드몰을 맡은 담당자가 금요일 오후에 “다음 달 서버 이전 때 어느 몰부터 옮길 수 있나요?”라는 질문을 받았다고 해보겠습니다. 도메인 목록에는 세 몰 모두 같은 솔루션이라고 적혀 있습니다. 그런데 한 곳은 회원 전용 가격표를, 다른 곳은 오래된 송장 출력 모듈을 씁니다. 대표 몰의 첫 화면만 확인해서는 나머지 두 곳에 답을 주기 어렵습니다.

반복 검사는 파이썬에, 판단 근거는 사이트별로

여기서 파이썬을 쓰는 이유는 PHP 대신 웹페이지를 실행하기 위해서가 아닙니다. 대상 목록을 읽고, 정해진 검사를 같은 조건으로 반복하고, 어느 사이트의 어느 파일에서 어떤 결과가 나왔는지 연결하는 일이 파이썬에 잘 맞습니다. 아래는 이런 점검을 쇼핑몰에 적용할 때의 흐름입니다.

첫 목록에는 도메인 옆에 현재 웹서버의 PHP 버전, 옮겨갈 버전, 사이트별로 바꾼 모듈을 적습니다. 서버 터미널에서 확인한 PHP와 실제 웹 요청을 처리하는 PHP가 다를 수도 있습니다. 검사에 쓴 버전까지 기록해야 나중에 같은 결과를 다시 확인할 수 있습니다.

결과를 모을 때는 오류 건수보다 발생 위치가 더 유용합니다. 세 몰에서 같은 공통 파일이 걸렸다면 수정 후보를 한데 묶을 수 있습니다. 반대로 파일 이름이 같아도 한 몰에서만 주문서 양식을 수정했다면 별도 검토 대상으로 남겨야 합니다. 접근 권한이 없어 읽지 못한 파일도 결과표에 남깁니다. 빈칸 하나가 ‘문제없음’으로 전달되면 이전 일정을 잘못 잡을 수 있기 때문입니다.

문법 검사를 통과했는데 송장이 나오지 않는다면

PHP의 기본 문법 검사인 php -l은 코드를 실행하지 않습니다. 괄호가 닫히지 않은 파일은 찾아낼 수 있지만, 송장 버튼을 눌렀을 때 비로소 호출되는 함수가 서버에 있는지는 이 검사만으로 알 수 없습니다. PHP 명령행 검사 설명서

앞의 담당자에게 필요한 다음 결과는 ‘검사 통과’ 한 줄보다 구체적입니다. 시험용 주문으로 송장 출력 화면을 열었는지, 파일이 내려왔는지, 파일 안의 주문번호가 맞는지까지 확인해야 그 몰의 출고 업무를 판단할 수 있습니다. 이때 시험 환경은 실배송이나 고객 알림으로 이어지지 않도록 분리합니다.

점검을 의뢰할 때 어디까지 맡기면 될까요?

처음부터 전체 사이트의 수정 견적을 확정하기는 어렵습니다. 같은 솔루션의 기본형 한 곳과 변경이 많은 한 곳을 먼저 골라 보세요. 소스 복제본, 목표 PHP 버전, 중단되면 곤란한 업무, 시험 계정을 준비하면 공통으로 반복할 검사와 사이트별 확인 작업을 가를 수 있습니다.

이 단계의 산출물은 사이트별 점검표입니다. 각 항목에 검사 조건과 결과, 다음에 확인할 기능을 적습니다. 그래야 운영자는 “세 몰 모두 이전 가능” 같은 넓은 답 대신 “기본형은 주문 시험까지 끝났고, 맞춤형은 송장 모듈 확인 뒤 날짜를 잡을 수 있다”는 답을 얻습니다. 수백 개 사이트의 호환성을 점검하는 자동화는 이렇게 한 곳씩 내릴 결정을 준비하는 일입니다.