PHP 버전을 올리는 일은 대개 좋은 결정입니다. 새 버전은 빠르고, 오래된 버전은 보안 패치가 끊깁니다. 문제는 순서입니다 — 올린 다음에 무엇이 깨졌는지 알아보는 방식은 그 확인 작업을 방문자에게 시키는 것과 같습니다.
다행히 PHP 는 미리 알려 줍니다. 지금 버전에서 Deprecated 로 기록되는 것이 다음 버전에서 Fatal error 가 되는 후보이고, 그 목록은 올리기 전에 읽을 수 있습니다.
deprecated 는 오류가 아니라 예고입니다
Deprecated 는 “지금은 동작하지만 앞으로는 아니다” 라는 뜻입니다. 화면은 멀쩡하고 기능도 그대로이므로, 로그를 보지 않으면 존재 자체를 모릅니다. 그래서 이 경고를 읽는 습관이 있느냐 없느냐가 버전 업그레이드의 난이도를 정합니다.
지금 시점의 실제 예를 하나 들면, PHP 8.4 는 암묵적 nullable 파라미터를 deprecated 로 표시합니다. 기본값이 null 이면 타입이 자동으로 nullable 이 되던 오랜 관행인데, 이제는 물음표를 직접 적어야 합니다.
// PHP 8.4 에서 Deprecated — 타입이 암묵적으로 nullable 이 된다
function wper_render( Renderer $renderer = null ) {}
// 명시적으로 적는다
function wper_render( ?Renderer $renderer = null ) {}
이 형태는 오래된 코드베이스라면 어디에나 있습니다. 저희 환경에서도 어떤 플러그인이 WP-CLI 를 돌릴 때마다 이 계열의 알림을 표준 오류로 내보냅니다 — 기능은 정상이고, 그저 다음 메이저 버전을 위한 할 일 목록이 매번 출력되고 있는 것입니다.
런타임과 정적 분석은 다른 것을 봅니다
확인 방법은 두 갈래이고, 둘은 서로를 대체하지 않습니다.
런타임은 스테이징에서 확인합니다. 프로덕션 복제본에 새 PHP 를 물리고, 로그를 파일로 받은 뒤 사이트를 실제로 돌려 봅니다. 이때 화면만 눌러 보면 절반만 봅니다 — 관리자 저장, 결제 흐름, 예약 작업, WP-CLI 명령을 함께 돌려야 그 경로들의 코드가 실행됩니다.
// 스테이징 wp-config.php — 로그를 파일로만 받는다
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_DEBUG_LOG', '/var/log/wper/staging-php.log' );
@ini_set( 'display_errors', 0 );
error_reporting( E_ALL );
정적 분석은 실행 없이 코드를 훑습니다. PHP_CodeSniffer 에 PHPCompatibility 규칙을 얹으면 목표 버전을 지정해 검사할 수 있습니다.
composer require --dev phpcompatibility/phpcompatibility-wp
vendor/bin/phpcs -p wp-content/plugins/our-plugin
--standard=PHPCompatibilityWP
--runtime-set testVersion 8.4
남의 코드에서 나온 경고
목록의 상당수는 우리가 쓴 코드가 아니라 플러그인과 테마에서 나옵니다. 그래서 이 목록은 사실상 교체 대상 목록이기도 합니다. 각 항목을 세 갈래로 나눕니다 — 최신 버전에서 이미 고쳐졌는가, 개발이 멈춘 것인가, 우리가 감쌀 수 있는가.
설치된 것들이 스스로 선언한 요구 버전부터 확인하면 판단이 빨라집니다.
wp eval 'foreach ( get_plugins() as $p ) { printf( "%-34s %-10s PHP %sn", $p["Name"], $p["Version"], $p["RequiresPHP"] ?: "-" ); }'
한 가지 자주 놓치는 지점이 있습니다. CLI 의 PHP 와 웹(FPM)의 PHP 는 서로 다른 버전일 수 있습니다. 설정 파일도 별개입니다. php -v 가 8.4 라고 해서 웹 요청도 8.4 인 것은 아니므로, 웹 쪽 버전은 관리자의 도구 › 사이트 상태 › 정보 에서 따로 확인합니다.
목록을 다 처리한 뒤에도 로그는 끄지 않습니다. 남은 경고를 안 보이게 만드는 것은 해결이 아니라 다음 업그레이드를 더 어렵게 만드는 일입니다. 프로덕션에서 로그를 안전하게 남기는 설정은 별도의 규칙이 있습니다.
스테이징과 배포를 절차로 굳히는 방법은 개발 환경과 배포 연재에, 서버 구성에 관한 글은 서버 · 인프라 아카이브에 있습니다. 버전 업그레이드와 검증까지 한 번에 맡기고 싶다면 최적화 지원 사업이 그 작업을 포함합니다.