워드프레스 PHP 버전 업그레이드, 이렇게 하면 장애 시간을 아낀다

워드프레스 PHP 버전 업그레이드는 보안과 성능을 위해 필요하지만, 운영 서버에서 바로 바꾸면 예상치 못한 오류가 날 수 있습니다. 특히 플러그인이 많은 병원 홈페이지는 사전 점검이 중요합니다.

실제로 PHP 7.4 지원 종료 이슈로 8.1 업그레이드를 준비한 적이 있습니다. 스테이징 서버에서 먼저 테스트했는데, 예약 기능에 쓰던 플러그인 하나가 PHP 8.1에서 deprecated 함수를 사용해 치명적 오류를 냈습니다. 그래서 워드프레스 PHP 버전 업그레이드는 “올리는 작업”이 아니라 “깨질 것을 미리 찾는 작업”에 가깝다고 봅니다.

업그레이드 전 체크리스트

운영 서버를 건드리기 전에는 현재 상태를 기록해야 합니다. 문제가 생겼을 때 되돌릴 기준점이 없으면 복구가 길어집니다.

1. 워드프레스 코어 버전 확인
2. 테마와 플러그인 최신 호환 정보 확인
3. PHP 확장 모듈 목록 기록
4. 전체 파일과 DB 백업
5. PHP-FPM 버전 전환 가능 여부 확인

워드프레스 PHP 버전 업그레이드 전에는 플러그인 changelog에서 PHP 8.x 호환 문구를 확인합니다. 업데이트가 오래 멈춘 플러그인은 대체 플러그인 검토까지 같이 해야 합니다.

스테이징 테스트 방법

스테이징 서버는 운영 서버와 최대한 비슷해야 합니다. PHP 버전만 다른 상태로 만들어야 어떤 문제가 PHP 변경 때문인지 파악하기 쉽습니다.

테스트 순서는 이렇게 잡습니다.

1. 운영 사이트를 스테이징으로 복제
2. PHP 8.1 또는 목표 버전으로 전환
3. 관리자 로그인, 게시글, 문의 폼, 예약 폼 등 웹 기능 확인
4. debug.log와 웹서버 오류 로그 확인
5. 플러그인별 경고와 치명적 오류 분류

여기서 의료 조언이나 임상 내용은 다룰 필요가 없습니다. 웹사이트 기능이 정상 동작하는지만 확인하면 됩니다.

실패했을 때 롤백

제가 작업한 환경은 PHP-FPM 설정에서 버전 전환이 가능했습니다. 그래서 문제가 생기면 7.4로 즉시 되돌릴 수 있게 준비한 뒤 워드프레스 PHP 버전 업그레이드를 진행했습니다.

롤백 기준도 미리 정해두는 것이 좋습니다. 관리자 화면 접속 불가, 주요 플러그인 치명적 오류, 폼 제출 실패처럼 사용자 흐름에 영향을 주는 문제가 나오면 즉시 되돌립니다.

sudo update-alternatives --config php
sudo systemctl restart php-fpm
sudo systemctl reload nginx

명령은 서버 구성마다 다르므로 실제 환경에 맞게 바꿔야 합니다. 중요한 것은 롤백 명령을 작업 전에 적어두고, 담당자가 바로 실행할 수 있게 하는 것입니다.

운영 기준

워드프레스 PHP 버전 업그레이드는 미루기만 해도 보안 부담이 생기고, 급하게 해도 장애 위험이 생깁니다. 그래서 스테이징 테스트, 백업, 롤백 세 가지를 한 묶음으로 봐야 합니다.

한 번 체크리스트를 만들어두면 다음 병원 홈페이지 작업에도 그대로 활용할 수 있습니다. 최신 버전으로 올리는 것보다 중요한 것은 안전하게 올리고, 문제가 생기면 빠르게 되돌리는 운영 기준입니다.