PHP 업데이트 방법, 호스팅 패널과 리눅스 서버 순서
- PHP 업데이트는 백업, 호환성 점검, 버전 전환, 동작 확인, 오류 로그 확인 순서로 진행합니다.
- 호스팅 패널은 도메인별 PHP 버전을 바꾸는 메뉴를 쓰고, 서버는 패키지 관리자로 설치 후 웹 서버 연결을 바꿉니다.
- 한 번에 여러 단계를 건너뛰기보다 지원 중인 가까운 버전으로 올리고 문제를 확인하는 편이 안전합니다.
PHP 업데이트는 보안 패치를 계속 받기 위한 가장 기본적인 관리입니다. 하지만 버전을 올리면 오래된 플러그인과 테마가 작동하지 않을 수 있어서, 무작정 바꾸기보다 순서를 지켜야 합니다.
현재 버전을 모른다면 먼저 PHP 버전 확인 방법 글에서 확인하고 오세요. 이 글은 올릴 버전을 정한 뒤의 실제 작업 순서를 다룹니다.
업데이트 전에 준비할 것
작업 전에 아래 항목을 점검하면 사고를 크게 줄일 수 있습니다.
| 순서 | 할 일 | 이유 |
|---|---|---|
| 1 | 파일과 DB 백업 | 문제가 생기면 이전 상태로 복구하기 위해 |
| 2 | 올릴 버전 정하기 | 지원 일정이 충분히 남은 버전을 고르기 위해 |
| 3 | 프로그램 호환 확인 | 사용 중인 CMS·플러그인이 해당 PHP를 지원하는지 보기 위해 |
| 4 | 접속량이 적은 시간 선택 | 오류 노출 시간을 줄이기 위해 |
올릴 버전은 PHP 지원 버전 페이지에서 확인합니다. 2026년 10월 23일 표시 기준으로 8.2, 8.3, 8.4, 8.5가 지원 중이며, 8.2는 2026년 12월 31일에 지원이 끝납니다. 처음 올린다면 보안 지원이 오래 남은 8.4나 8.5를 후보로 두되, 사용 중인 프로그램이 지원하는지를 최종 기준으로 삼으세요. 워드프레스는 요구 사항 페이지에서 PHP 8.3 이상을 권장한다고 안내합니다.
호환성 점검
PHP 매뉴얼 부록에는 7.4에서 8.0으로, 8.3에서 8.4로 같은 식의 버전별 이전 가이드(Migrating from …)가 있어서 하위 호환이 깨지는 변경, 제거된 기능, 더 이상 권장하지 않는 기능을 확인할 수 있습니다. 직접 만든 코드가 있다면 이 목록과 대조하세요. 서버에서는 문법 검사 옵션도 쓸 수 있습니다.
# 새 버전의 php로 파일 문법만 검사 (실행하지 않음)
php -l wp-content/themes/my-theme/functions.php
-l 옵션은 파일을 실행하지 않고 문법만 확인하며, 정의되지 않은 함수 호출 같은 실행 중 오류는 찾지 못합니다. 그래서 문법 검사만 통과했다고 안심하지 말고 테스트 환경에서 실제 화면을 열어 봐야 합니다. 워드프레스라면 사용하지 않는 플러그인은 업데이트 전에 정리하는 것이 좋습니다.
여러 단계를 건너뛰어야 한다면, 예를 들어 7.4에서 8.x로 올리는 경우에는 이전 가이드를 단계별로 모두 읽어야 합니다. 8.0은 7.4에서 넘어오는 첫 8 버전이라 변경 사항이 가장 많으니, 테스트 환경에서 오류 로그를 켜 두고 화면을 하나씩 열어 확인하는 방식이 현실적입니다.
내 사이트의 HTTPS·인증서·보안 헤더를 바로 확인할 수 있습니다.
무료 보안 검사 시작호스팅 패널에서 올리기
대부분의 호스팅은 도메인별로 PHP 버전을 고르는 메뉴를 제공합니다. 메뉴 이름은 업체마다 다릅니다.
- 패널에서 PHP 설정 또는 언어 설정 메뉴를 엽니다.
- 도메인을 선택하고 새 버전을 지정합니다.
- 사이트 첫 화면, 로그인, 결제나 문의 같은 핵심 기능을 직접 눌러 봅니다.
- 문제가 있으면 같은 메뉴에서 이전 버전으로 되돌립니다.
패널에서 되돌리는 방법이 가장 빠른 복구 수단이므로, 바꾸기 전에 이전 버전 값을 적어 두세요.
Ubuntu·Debian 서버에서 올리기
서버를 직접 관리한다면 패키지 관리자로 새 버전을 설치하고 웹 서버가 그 버전을 쓰도록 연결을 바꿉니다. 배포판 저장소에서 제공하는 PHP 버전은 배포판마다 다르니, 먼저 어떤 버전이 있는지 검색해 보세요.
apt search '^php[0-9.]+-fpm$' # 설치 가능한 PHP-FPM 패키지 확인
sudo apt install php8.4-fpm php8.4-mysql php8.4-curl php8.4-mbstring # 예시
위 패키지 이름은 예시입니다. 실제 버전 번호와 필요한 확장 모듈은 환경에 맞게 바꾸세요. 기존 버전에서 쓰던 확장 모듈을 php -m으로 확인해 새 버전에도 같은 모듈을 설치해야 합니다. 저장소에 원하는 버전이 없다면 제3자 저장소를 써야 하는데, 이는 운영자가 출처를 신뢰할 수 있는지 판단한 뒤에 결정할 일입니다.
설치 후에는 웹 서버 설정에서 PHP-FPM 소켓 경로를 새 버전으로 바꾸고, 설정 문법 검사 후 다시 읽도록 합니다(Apache는 apachectl configtest, Nginx는 nginx -t). 서비스 재시작보다 설정 재적용(reload)이 접속 끊김을 줄입니다.
업데이트 후 확인
- phpinfo나 사이트 상태 화면에서 웹 버전이 바뀌었는지 확인합니다.
- 오류 로그에 새로운 경고나 치명적 오류가 쌓이는지 봅니다. 로그 위치는 PHP 오류 로그 확인 글에서 설명합니다.
- 하루 이틀은 폼 전송, 로그인, 파일 업로드가 정상인지 지켜봅니다.
문제가 생겼을 때 되돌리기
패널은 이전 버전으로 되돌리고, 서버는 웹 서버 설정의 연결 경로를 이전 값으로 바꾸면 됩니다. 되돌린 뒤에 오류 로그에서 원인이 된 플러그인이나 파일을 찾아 업데이트하거나 교체하세요. 원인을 해결하지 않은 채 오래된 버전에 머물면 지원 종료 위험이 커집니다.
웹사이트 기본 보안 검사HTTPS·리디렉션·인증서·보안 헤더·서버 정보 노출 10개 항목을 무료로 확인할 수 있습니다.
무료 보안 검사 시작자주 묻는 질문
PHP 버전을 올리면 사이트가 깨질 수 있나요?
오래된 플러그인이나 테마가 새 버전에서 제거된 기능을 쓰면 오류가 날 수 있습니다. 그래서 업데이트 전에 백업을 만들고, 가능하면 테스트 환경에서 먼저 확인하는 것이 좋습니다.
업데이트 후 흰 화면만 나옵니다.
PHP 치명적 오류가 화면에 나오지 않도록 설정된 상태일 가능성이 큽니다. 오류 로그에서 원인이 된 파일을 확인하고, 급하면 이전 PHP 버전으로 되돌린 뒤 해당 플러그인이나 테마를 점검하세요.
가장 최신 버전으로 바로 올려도 되나요?
지원 중인 버전이라면 가능하지만, 사용 중인 프로그램이 그 버전을 지원하는지 먼저 확인해야 합니다. 프로그램의 지원 PHP 버전 안내를 보고 정하세요.
호스팅 업체가 버전 선택 메뉴를 주지 않아요.
업체 고객센터에 지원 중인 PHP 버전과 변경 방법을 문의하세요. 지원이 끝난 버전만 제공하는 환경이라면 이전을 고려해야 할 수 있습니다.
확인한 자료
기술 정보는 2026-10-24에 위 자료로 확인했습니다. 소프트웨어 버전·기본값·서비스 정책은 바뀔 수 있으므로 적용 전 각 문서의 최신 내용을 확인하세요. 이 글은 일반 정보이며 특정 서비스 가입을 권하지 않습니다.