10월 21일 PHP2Shell(CVE-2026-109618, CVE-2026-109619) 공식 패치는 8.2.35, 8.3.36, 8.4.27, 8.5.12에만 나왔습니다. 8.1 이하를 쓰는 사이트는 지원되는 버전으로 올리는 것 외에 공식 해결책이 없습니다. 버전을 올리면 화면이 하얗게 뜨거나 경고 문구가 페이지 위에 찍히는 일이 생깁니다. PHP 공식 마이그레이션 문서의 호환성 항목을 기준으로 무엇이 깨지는지 정리했습니다.
몇 버전까지 올려야 합니까?
- 8.5
- 보안 지원 종료
- 2029-12-31
- 비고
- 최신
- 8.4
- 보안 지원 종료
- 2028-12-31
- 비고
- 8.3
- 보안 지원 종료
- 2027-12-31
- 비고
- 워드프레스 권장 기준(8.3 이상)
- 8.2
- 보안 지원 종료
- 2026-12-31
- 비고
- 두 달이 채 남지 않음
- 8.1
- 보안 지원 종료
- 2025-12-31 종료
- 비고
- 마지막 릴리스 8.1.34
- 8.0
- 보안 지원 종료
- 2023-11-26 종료
- 비고
- 7.4
- 보안 지원 종료
- 2022-11-28 종료
- 비고
| 버전 | 보안 지원 종료 | 비고 |
|---|---|---|
| 8.5 | 2029-12-31 | 최신 |
| 8.4 | 2028-12-31 | |
| 8.3 | 2027-12-31 | 워드프레스 권장 기준(8.3 이상) |
| 8.2 | 2026-12-31 | 두 달이 채 남지 않음 |
| 8.1 | 2025-12-31 종료 | 마지막 릴리스 8.1.34 |
| 8.0 | 2023-11-26 종료 | |
| 7.4 | 2022-11-28 종료 |
PHP 공식 지원 일정입니다.
8.2로 올리면 연말에 다시 올려야 합니다. 한 번에 8.3이나 8.4로 가는 것이 작업 횟수를 줄입니다.
지금 버전에 따라 무엇이 다릅니까?
- 5.x
- 주요 변화
- 7.0에서 mysql, ereg 확장 제거
- 영향
- mysql_query() 같은 함수를 쓰는 코드는 DB 연결부터 실패
- 7.x
- 주요 변화
- 8.0에서 다수 기능 제거, 경고가 오류로 전환
- 영향
- 가장 많이 깨지는 구간
- 8.0, 8.1
- 주요 변화
- 8.1, 8.2에서 기능 폐기 예고(Deprecated)
- 영향
- 대부분 동작하지만 로그에 경고가 쌓임
| 출발 버전 | 주요 변화 | 영향 |
|---|---|---|
| 5.x | 7.0에서 mysql, ereg 확장 제거 | mysql_query() 같은 함수를 쓰는 코드는 DB 연결부터 실패 |
| 7.x | 8.0에서 다수 기능 제거, 경고가 오류로 전환 | 가장 많이 깨지는 구간 |
| 8.0, 8.1 | 8.1, 8.2에서 기능 폐기 예고(Deprecated) | 대부분 동작하지만 로그에 경고가 쌓임 |
출발 버전에 따라 깨지는 범위가 다릅니다.
국내에서 오래 운영한 사이트는 7.x 구간이 가장 흔합니다. 7.4에서 8.x로 넘어가는 지점이 이번 작업의 핵심입니다.
PHP 8.0에서 오류로 바뀐 것은 무엇입니까?
- each(), create_function()
- 8.0 이후 동작
- 함수 제거
- 증상
- 해당 페이지가 치명적 오류로 멈춤
- get_magic_quotes_gpc()
- 8.0 이후 동작
- 함수 제거
- 증상
- 입력값 처리 공통 파일에서 쓰면 사이트 전체가 멈춤
- $str{0} 형태의 중괄호 접근
- 8.0 이후 동작
- 문법 제거
- 증상
- 파일을 읽는 단계에서 구문 오류
- count()에 배열이 아닌 값
- 8.0 이후 동작
- TypeError 발생
- 증상
- 목록 화면이 비어 있을 때 오류
- 배열에 산술 연산, 숫자가 아닌 문자열 산술
- 8.0 이후 동작
- TypeError 발생
- 증상
- 합계, 수량 계산 화면 오류
- 0 == "foo"
- 8.0 이후 동작
- false로 바뀜
- 증상
- 오류 없이 조건문 결과가 달라짐
- @ 연산자
- 8.0 이후 동작
- 치명적 오류는 더 이상 숨기지 않음
- 증상
- 숨겨져 있던 오류가 드러남
- 기본 error_reporting
- 8.0 이후 동작
- E_ALL
- 증상
- 정의되지 않은 변수와 배열 키 경고가 표시됨
- match
- 8.0 이후 동작
- 예약어
- 증상
- match라는 이름의 함수가 있으면 구문 오류
| 항목 | 8.0 이후 동작 | 증상 |
|---|---|---|
| each(), create_function() | 함수 제거 | 해당 페이지가 치명적 오류로 멈춤 |
| get_magic_quotes_gpc() | 함수 제거 | 입력값 처리 공통 파일에서 쓰면 사이트 전체가 멈춤 |
| $str{0} 형태의 중괄호 접근 | 문법 제거 | 파일을 읽는 단계에서 구문 오류 |
| count()에 배열이 아닌 값 | TypeError 발생 | 목록 화면이 비어 있을 때 오류 |
| 배열에 산술 연산, 숫자가 아닌 문자열 산술 | TypeError 발생 | 합계, 수량 계산 화면 오류 |
| 0 == "foo" | false로 바뀜 | 오류 없이 조건문 결과가 달라짐 |
| @ 연산자 | 치명적 오류는 더 이상 숨기지 않음 | 숨겨져 있던 오류가 드러남 |
| 기본 error_reporting | E_ALL | 정의되지 않은 변수와 배열 키 경고가 표시됨 |
| match | 예약어 | match라는 이름의 함수가 있으면 구문 오류 |
PHP 8.0 호환성 문서에 있는 항목 가운데 운영 사이트에서 자주 걸리는 것입니다.
가장 주의할 항목은 0 == "foo"입니다. 화면은 정상으로 보이는데 권한 검사나 결제 금액 비교 결과가 달라질 수 있습니다. 오류 로그에도 남지 않으므로 기능 시험으로만 찾을 수 있습니다.
8.1에서 8.3이나 8.4로 갈 때는 무엇이 바뀝니까?
8.1과 8.2에서 폐기 예고된 기능은 아직 동작합니다. 대신 Deprecated 경고가 오류 로그에 쌓이고, 이후 버전에서 제거될 수 있습니다.
내장 함수의 문자열 인자에 null 전달 (8.1)
FILTER_SANITIZE_STRING 필터, strftime() 함수 (8.1)
선언하지 않은 속성을 객체에 새로 만드는 동적 속성 (8.2)
utf8_encode(), utf8_decode() (8.2)
"${var}" 형태의 문자열 안 변수 표기 (8.2)
동적 속성은 오래된 클래스 코드에서 흔합니다. 그누보드 5.6.43 릴리스 노트에도 "KCP 모듈의 PHP 8.4 동적 속성 경고" 보완이 들어 있습니다.
그누보드와 영카트는 어떻게 확인합니까?
그누보드는 5.4.6부터 영카트를 포함해 배포합니다. 버전은 설치 폴더의 version.php에 있습니다.
grep -n "G5_GNUBOARD_VER" version.php5.4.x 릴리스 노트에는 PHP 8 대응 수정이 여러 건 있습니다. 5.4.16에는 "PHP8에서 나오는 Undefined array key "HTTP_USER_AGENT" 오류 수정", count() TypeError 해결이 들어 있습니다. 5.4 이전 버전에 직접 수정한 스킨이 얹혀 있다면 PHP만 올려서는 같은 오류가 다시 납니다. 그누보드 본체 업데이트와 스킨, 플러그인 수정을 함께 계획합니다.
제거된 함수와 문법을 쓰는 파일은 아래 명령으로 후보를 뽑습니다. 주석에 쓰인 단어도 함께 걸리므로 결과는 사람이 확인합니다.
# 제거된 함수 이름이 들어 있는 줄
grep -rnw -e each -e create_function -e get_magic_quotes_gpc -e mysql_query --include="*.php" .
# 중괄호 문자열 접근 후보
grep -rnE '\$[A-Za-z_]+\{[0-9$]' --include="*.php" .새 PHP가 설치된 시험 서버에서는 구문 검사를 돌립니다. php -l은 구문 오류만 찾고 실행 중 오류는 찾지 못합니다.
find . -name "*.php" -exec php -l {} \; | grep -v "No syntax errors"워드프레스는 무엇을 봅니까?
워드프레스 공식 요구 사항은 PHP 8.3 이상을 권장하고, 7.4 이상에서도 동작하지만 지원 종료 버전이라 보안 위험이 있다고 안내합니다. 코어보다 플러그인과 테마가 먼저 깨집니다. 관리자 화면의 도구, 사이트 건강 메뉴에서 현재 PHP 버전을 확인하고, 플러그인마다 최근 업데이트 날짜를 봅니다. 서버에 WP-CLI가 있으면 목록을 한 번에 뽑습니다.
wp plugin list --fields=name,status,version,update몇 년째 업데이트가 없는 플러그인은 PHP 8 대응이 안 되어 있을 가능성이 높습니다. 대체 플러그인을 찾거나 기능을 덜어 내는 결정을 업그레이드 전에 합니다.
업체에 어떤 답을 받아야 합니까?
- 목표 버전
- 받을 답
- 올릴 PHP 버전과 그 버전의 보안 지원 종료일
- 시험 환경
- 받을 답
- 운영 서버 복제본에서 새 버전으로 돌려 본 날짜와 오류 로그 결과
- 수정 범위
- 받을 답
- 수정한 파일 목록과 본체 업데이트, 스킨, 플러그인 구분
- 기능 시험
- 받을 답
- 로그인, 글쓰기, 결제, 관리자 화면 등 시험한 기능 목록
- 되돌림
- 받을 답
- 문제가 생겼을 때 이전 버전으로 돌아가는 방법과 걸리는 시간
| 확인 항목 | 받을 답 |
|---|---|
| 목표 버전 | 올릴 PHP 버전과 그 버전의 보안 지원 종료일 |
| 시험 환경 | 운영 서버 복제본에서 새 버전으로 돌려 본 날짜와 오류 로그 결과 |
| 수정 범위 | 수정한 파일 목록과 본체 업데이트, 스킨, 플러그인 구분 |
| 기능 시험 | 로그인, 글쓰기, 결제, 관리자 화면 등 시험한 기능 목록 |
| 되돌림 | 문제가 생겼을 때 이전 버전으로 돌아가는 방법과 걸리는 시간 |
요청 문구 예시입니다.
> PHP 업그레이드 목표 버전과 보안 지원 종료일, 시험 서버 점검 결과(오류 로그 포함), 수정 파일 목록, 시험한 기능 목록, 되돌림 절차를 작업 전에 서면으로 회신 부탁드립니다.
참고: PHP 지원 버전 (https://www.php.net/supported-versions.php) / PHP 지원 종료 버전 (https://www.php.net/eol.php) / PHP 8.0 호환성 변경 (https://www.php.net/manual/en/migration80.incompatible.php) / PHP 8.1 폐기 예고 기능 (https://www.php.net/manual/en/migration81.deprecated.php) / PHP 8.2 폐기 예고 기능 (https://www.php.net/manual/en/migration82.deprecated.php) / PHP 7.0 제거된 확장 (https://www.php.net/manual/en/migration70.removed-exts-sapis.php) / 그누보드 5.4.16 릴리스 노트 (https://github.com/gnuboard/gnuboard5/releases/tag/v5.4.16) / 그누보드 5.6.43 릴리스 노트 (https://github.com/gnuboard/gnuboard5/releases/tag/v5.6.43) / 워드프레스 요구 사항 (https://wordpress.org/about/requirements/)