WordPress에서 PHP 업데이트하는 방법

WordPress 사이트의 PHP는 누가 관리하는가

WordPress는 PHP 애플리케이션입니다. 서버가 제공하는 PHP 버전에서 실행되며, 대시보드에서 PHP를 업그레이드할 수는 없습니다. 환경에 따라 PHP 버전을 관리하는 주체는 다음과 같습니다.

공유 또는 관리형 호스팅: 호스팅 제어판(cPanel, Plesk 또는 자체 대시보드)의 설정
VPS 또는 전용 서버: 운영체제에 설치된 패키지와 웹 서버가 사용하는 PHP-FPM 풀
컨테이너: Dockerfile 또는 compose 파일의 베이스 이미지

이 가이드는 대부분의 WordPress 사이트에 해당하는 처음 두 가지에 초점을 맞춥니다.

시작하기 전에: 대상 버전 정하기

업스트림에서 지원되면서 사용 중인 WordPress 버전에서도 지원되는 PHP 브랜치를 선택하십시오.

최신 WordPress 요구 사항 페이지에서 권장 PHP 버전을 확인합니다.
WordPress Core Handbook의 PHP 호환성 표를 확인합니다. 이 표는 각 WordPress 릴리스가 어떤 PHP 버전을 지원하는지, 그리고 어떤 지원이 아직 “베타”인지 보여 줍니다.
PHP 자체의 수명 주기를 확인합니다. 2026년 10월 기준으로 8.2는 2026-12-31까지만 보안 수정을 받으며, 8.3, 8.4, 8.5는 더 오래 지원됩니다. 8.1 이하 브랜치는 지원이 종료되었습니다. PHP 보안 지원 수명 주기를 참고하십시오.

실제로는 WordPress 코어가 완전히 지원하면서 동시에 사용 중인 플러그인과 테마도 지원하는 가장 최신 PHP 브랜치가 적절한 대상입니다. 확장 기능 때문에 필요하다면 최신 브랜치보다 한 단계 낮은 브랜치를 사용해도 괜찮습니다.

1단계: 현재 상태 기록하기

도구 → 사이트 건강 → 정보(Tools → Site Health → Info)(WordPress 5.2 이상)로 이동해 다음을 기록합니다.

서버 → PHP 버전(Server → PHP version) 및 PHP SAPI
워드프레스 → 버전(WordPress → Version)
**활성 테마(Active theme)**와 활성 플러그인(Active plugins) 및 각각의 버전

정보 탭 상단의 **사이트 정보를 클립보드로 복사(Copy site info to clipboard)**를 클릭해 텍스트 파일로 저장할 수 있습니다. 롤백해야 하거나 개발자에게 도움을 요청할 때 이것이 기준점이 됩니다. 다른 방법은 PHP 버전 확인 방법 가이드에 정리되어 있습니다.

2단계: WordPress, 플러그인, 테마를 먼저 업데이트하기

새로운 PHP 버전은 사용 중단된 기능을 제거하고 타입 처리를 더 엄격하게 합니다. 플러그인과 테마 개발자는 보통 자체 릴리스에서 이러한 문제를 수정하므로, 오래된 확장 기능이 문제의 주된 원인입니다.

WordPress 코어를 최신 릴리스로 업데이트합니다.
모든 플러그인과 테마를 업데이트합니다.
사용하지 않는 플러그인과 테마를 제거합니다. 비활성화된 코드도 누군가 파일을 직접 요청하면 실행되며, 여전히 호환되어야 합니다.
남은 각 확장 기능에 대해 WordPress.org 페이지나 벤더 문서에서 “Tested up to” 표기나 명시된 PHP 요구 사항을 확인합니다. 수년간 업데이트되지 않은 확장 기능은 위험 요소로 간주하십시오.

사용자 정의 코드(자식 테마, 사이트 전용 플러그인, functions.php의 코드 조각)는 직접 책임져야 합니다. 개발자가 있다면 PHP 업그레이드 계획에서 설명하는 PHPCompatibility로 스캔해 달라고 요청하십시오.

3단계: 전체 백업하기

사이트의 두 부분을 모두 백업합니다.

파일: wp-content와 wp-config.php를 포함한 WordPress 디렉터리 전체
데이터베이스: 전체 내보내기

호스팅 업체의 백업 도구나 백업 플러그인을 사용하고, 백업 파일을 다운로드할 수 있는지 확인하십시오. 한 번도 복원해 보지 않은 백업은 계획이 아니라 희망에 가깝습니다. 가능하다면 스테이징 사본에서 복원을 테스트하십시오.

4단계: 스테이징 사이트에서 테스트하기

많은 호스팅 업체가 원클릭 스테이징(staging)을 제공합니다. 제공하지 않는다면 하위 도메인에 사본을 만들고 비밀번호로 보호하거나 검색 엔진을 차단하십시오.

스테이징 사본을 만듭니다.
스테이징을 대상 PHP 버전으로 전환합니다(방법은 5단계 참고).
스테이징에서만 오류 로그를 활성화합니다. wp-config.php에 다음을 추가합니다.
```
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
```
오류는 방문자에게 표시되지 않고 wp-content/debug.log에 기록됩니다.
사이트를 둘러봅니다. 홈페이지, 주요 템플릿, 폼, 검색, 쇼핑몰을 운영한다면 결제 및 계정 페이지, 관리자 대시보드, 편집기를 확인합니다.
debug.log를 읽습니다. 치명적 오류(fatal error)는 사이트를 공개하기 전에 반드시 수정해야 합니다. 사용 중단(deprecation) 알림은 향후 버전에 대한 경고이며, 보통 추적해 두었다가 나중에 해결해도 됩니다.

5단계: PHP 버전 변경하기

cPanel: MultiPHP Manager

Software 섹션에서 MultiPHP Manager를 엽니다.
도메인을 선택(체크)합니다.
드롭다운에서 새 버전을 선택하고 Apply를 클릭합니다.

cPanel: Select PHP Version(CloudLinux)

Select PHP Version을 엽니다.
새 버전을 선택하고 Set as current를 클릭합니다.
Extensions 목록을 검토합니다. WordPress에는 일반적으로 mysqli, curl, gd 또는 imagick, mbstring, xml, zip, intl 같은 확장 기능이 필요합니다. 확장 기능은 버전별로 설정되므로 자동으로 이어지지 않을 수 있습니다.

Plesk

Websites & Domains로 이동해 도메인을 선택합니다.
PHP(또는 PHP Settings)를 엽니다.
새 버전과 핸들러(예: FPM 핸들러)를 선택하고 Apply 또는 OK를 클릭합니다.

직접 운영하는 서버(Debian/Ubuntu 예시)

새 버전을 기존 버전과 나란히 설치한 다음, 사이트의 FPM 소켓이 새 버전을 가리키도록 합니다.

sudo apt install php8.4-fpm php8.4-mysql php8.4-curl php8.4-gd \
  php8.4-mbstring php8.4-xml php8.4-zip php8.4-intl

패키지 이름과 제공 여부는 배포판과 저장소에 따라 다릅니다. 그런 다음 사이트의 nginx 설정을 수정합니다.

fastcgi_pass unix:/run/php/php8.4-fpm.sock;

이전 버전의 php.ini와 풀 파일에 있던 사용자 정의 설정(memory_limit, upload_max_filesize, max_execution_time)을 새 버전으로 복사한 뒤, 설정을 테스트하고 다시 로드합니다.

sudo nginx -t && sudo systemctl reload nginx

변경에 확신이 생길 때까지 이전 FPM 서비스를 설치된 상태로 유지하십시오.

6단계: 운영 환경에서 확인하기

**도구 → 사이트 건강 → 정보 → 서버(Tools → Site Health → Info → Server)**를 새로 고쳐 새 PHP 버전을 확인합니다.
상태(Status) 탭에서 확장 기능 누락 같은 새로운 경고가 있는지 확인합니다.
4단계의 테스트 점검을 반복합니다.
이후 하루이틀 동안 PHP 오류 로그와 가동 시간 모니터링을 살펴봅니다.

롤백하기

문제가 생기면 같은 제어판 화면에서 이전 버전으로 되돌리십시오. 보통 즉시 적용됩니다. PHP를 롤백해도 플러그인 업데이트로 인한 데이터베이스 변경은 되돌려지지 않으며, 3단계의 백업이 중요한 이유가 여기에 있습니다.

롤백은 임시 조치입니다. 이전 브랜치가 지원 종료되었거나 종료가 임박했다면, 그대로 머무르지 말고 호환되지 않는 플러그인을 수정하거나 교체하십시오.

업데이트 이후

패치를 계속 적용하십시오. 호스팅 업체나 패키지 관리자가 브랜치 내 패치 릴리스(예: 2026년 10월 보안 릴리스 이후의 8.4.27)를 제공해야 합니다. PHP 버전 검사기로 패치 수준을 주기적으로 확인하십시오.
버전을 숨기십시오. 호스팅 업체가 X-Powered-By: PHP/... 헤더를 노출한다면 expose_php = Off로 설정해 달라고 요청하거나, php.ini를 직접 관리한다면 직접 설정하십시오.
디버그 모드를 어디에서든 활성화했다면 운영 환경에서는 끄십시오.
전반적인 보안 강화 상태를 점검하십시오. WordPress 보안 개요에서 추가 단계를 다루며, 웹사이트 보안 점검 도구로 사이트의 공개 구성을 점검할 수 있습니다.