PHP 8.2의 보안 지원이 2026년 12월 31일에 끝납니다. 지금 시점으로 두 달이 남았습니다. 지원이 끝나면 새로 발견되는 취약점이 더 이상 수정되지 않습니다. 이번 10월 21일에 나온 PHP 긴급 보안 릴리스에도 8.2.35가 포함됐듯이, 지금은 아직 수정을 받지만 연말 이후에는 그렇지 않습니다. 이 글은 8.2를 쓰고 있다면 연말까지 무엇을 어떻게 해야 하는지 로드맵으로 정리한 것입니다. 내용은 2026년 10월 26일 기준입니다.

버전별 지원 일정

php.net 지원 버전 표 기준입니다. 각 버전은 2년의 활성 지원 뒤 2년의 보안 지원을 받습니다.

  • 8.1: 지원 종료. 표에 더는 올라 있지 않습니다.
  • 8.2: 활성 지원은 2024-12-31에 끝났고, 보안 지원이 2026-12-31까지입니다.
  • 8.3: 활성 지원은 2025-12-31에 끝났고, 보안 지원은 2027-12-31까지입니다.
  • 8.4: 활성 지원 2026-12-31까지, 보안 지원 2028-12-31까지입니다.
  • 8.5: 2025-11-20 출시, 활성 지원 2027-12-31까지, 보안 지원 2029-12-31까지입니다.

목표 버전은 어떻게 고르나

  • 안정성 우선이면 8.3이나 8.4입니다. 8.3은 이미 활성 지원이 끝나 보안 지원만 남았다는 점은 고려하세요. 지금 올려서 2027년 말까지 쓰고 다시 올리게 됩니다.
  • 한 번에 오래 쓰려면 8.4(보안 지원 2028년 말)나 8.5(2029년 말)입니다. 프레임워크와 패키지가 해당 버전을 지원하는지 먼저 확인해야 합니다. 사용 중인 Laravel, Composer 패키지의 지원 PHP 범위는 composer.json의 require와 각 패키지 문서에서 볼 수 있습니다.
  • 호스팅 서비스를 쓴다면 관리 화면에서 선택할 수 있는 PHP 버전이 목표의 상한입니다. 지원이 끝나는 버전을 계속 제공하는지는 호스팅 업체에 문의해야 합니다.

점검과 전환 순서

  1. 목록 만들기: 운영 중인 모든 사이트와 서비스가 어떤 PHP로 돌아가는지 정리합니다. 웹 서버, 크론, 큐 워커, CLI 도구도 각각 다른 버전일 수 있습니다. 컨테이너는 이미지 안에서 php -v로 확인합니다.
  2. 의존성 확인: composer.json의 php 제약과 composer.lock의 패키지가 목표 버전에서 설치되는지 봅니다. composer install을 목표 버전의 컨테이너에서 실행해 보는 것이 가장 정확합니다.
  3. 새 버전에서 시험 돌리기: 기존 시험을 목표 버전의 격리된 환경에서 전부 실행하고 기준선과 비교합니다. 시험이 없는 사이트는 로그인, 결제, 파일 업로드, 메일 같은 핵심 경로를 체크리스트로 만들어 직접 확인합니다.
  4. 경고 메시지 확인: 마이너 버전 업그레이드에서도 deprecation(앞으로 없어질 기능을 쓴다는 경고)이 늘어납니다. 로그에 쌓이는 경고를 모아 코드를 고칠지 결정합니다.
  5. 운영 전환: 이전 이미지나 설정을 롤백용으로 보존하고, 전환 전후에 응답 코드와 주요 화면을 비교합니다. 사이트 하나씩 옮기고 문제가 있으면 바로 되돌립니다.
  6. PHP 설정 이전: php.ini와 conf.d 설정은 새 버전에 자동으로 따라오지 않습니다. 업로드 한도, 메모리, 세션 설정, 보안 설정을 새 환경에 옮겼는지 확인하세요.

오래된 코드에서 자주 만나는 문제

  • 화면 앞에 섞여 나오는 경고 문구: 예전 프레임워크(CodeIgniter 3 계열 등)는 실행 중에 오류 표시를 켜는 경우가 있습니다. 새 PHP에서 deprecation 경고가 응답 본문 앞에 출력되면 헤더가 이미 나간 뒤라서 리다이렉트가 깨지거나 상태 코드가 달라집니다. 서버 설정에서 오류 표시를 끄고(풀 단위 설정은 코드가 덮어쓰지 못합니다) 로그로만 남기게 하면 해결됩니다.
  • 데이터베이스 확장 함수: 오래된 mysql_* 함수는 이미 오래전에 사라졌고, mysqli나 PDO로 바꿔야 합니다. 같은 함수라도 동작이 조금씩 달라진 경우가 있어 코드 단위 확인이 필요합니다.
  • 확장 모듈 누락: 새 환경에 intl, gd, zip, mbstring 같은 확장이 설치되어 있는지 phpinfo 대신 php -m으로 확인합니다.

권장 일정

  • 11월 중순까지: 목록 작성과 의존성 점검
  • 11월 말까지: 새 버전에서 시험과 코드 수정
  • 12월 첫 주부터: 사이트별 순차 전환, 문제 시 즉시 롤백
  • 12월 25일 전: 전환 완료. 연말 연휴에는 변경을 피합니다.

PHP 버전이 많거나 오래된 코드를 새 버전으로 옮겨야 하는데 일정과 인력이 빠듯하다면, 포르본허가 점검부터 시험, 전환, 롤백 계획까지 언제든 도와드릴 수 있습니다. 아래 문의 양식에 상황을 간단히 남겨 주세요.

참고 자료