최근 PHP 7.4 보안 이슈로 인해 PHP 5.5에서 8.4로 바로 버전업 하려고 합니다. 절차 조언 부탁드립니다.
안녕하세요. 현재 PHP 5.5 환경에서 운영 중인 그누보드 사이트를 최신 PHP 8.4 환경으로 업그레이드하려고 합니다. 워낙 버전 차이가 크다 보니 어떤 순서로 작업을 진행해야 안전할지 몰라 선배님들께 조언을 구합니다.
1. 현재 운영 환경
-
현재 그누보드/영카트 버전: (예: 5.2.x 또는 5.3.x 등 정확한 버전 기재)
-
현재 PHP / DB 버전: PHP 5.5 / (MySQL5.x)
-
호스팅 환경: (카페24 10G 광아우토반 FullSSD 일반형)
2. 궁금한 점
-
PHP 버전을 5.5에서 8.4로 바로 올리면서 최신 그누보드 패치 파일을 덮어씌워도 되는지, 아니면 중간 버전(예: PHP 7.4)을 거쳐서 순차적으로 올려야 하는지 궁금합니다.
-
DB와 전체 소스를 백업한 이후, 테스트 서버에서 진행할 때 가장 먼저 확인해야 할 핵심 체크리스트가 있을까요?
-
오래된 구형 스킨이나 테마를 PHP 8.4 환경에 맞게 수정할 때 자주 발생하는 오류나 주의사항이 있다면 노하우를 배우고 싶습니다.
안전하게 마이그레이션할 수 있는 팁이 있다면 가감 없이 조언 부탁드립니다. 감사합니다!
답변 8개 / 댓글 3개
0. "AI로 8.4에서 돌아가게 하면 보안 지원이 되나요?"
지금 쓰시는 옛 판 그누보드를 고쳐서 8.4에서 돌리면 돌아가긴 합니다. 하지만 그누보드 보안 패치는 "최신 판 원본 파일"로 나옵니다. 옛 판 파일을 고쳐 쓰면 새 패치가 나와도 덮어쓸 수 없고, 하나하나 손으로 옮겨야 합니다. 그래서 보안 지원을 계속 받으려면 그누보드 자체를 최신 5.6.52로 올리시고, 고친 것은 theme·skin·extend 폴더 안에만 두세요. bbs/·lib/ 같은 코어 파일을 안 고쳐야 다음 패치를 그대로 덮을 수 있습니다.
1. 중간에 PHP 7.4를 거쳐야 하나요?
안 거치셔도 됩니다. PHP 판을 올린다고 DB가 바뀌지는 않고, 바뀌는 건 코드뿐이라 중간 판을 거쳐도 얻는 게 없습니다. 다만 "최신 패치 파일을 덮어씌우기"보다는 새 폴더에 5.6.52를 깨끗이 깔고, data 폴더와 쓰시던 스킨·테마만 옮긴 뒤, 관리자 > 환경설정 > DB업그레이드에서 "전체 실행"을 누르는 쪽을 권합니다. 5.6.37부터는 빠진 컬럼을 이 화면에서 채우는 방식이고, 옛 DB에도 조건부로 돌아가게 되어 있습니다(깃허브 gnuboard5 저장소 docs/database-migrations.md).
2. 테스트 서버에서 가장 먼저 볼 것 — 회원 로그인
판 번호 칸이 예시 그대로라 확실치 않은데, 5.3 이하라면 이게 첫 번째입니다.
- 옛 판 config.php 에 G5_STRING_ENCRYPT_FUNCTION 이 'sql_password' 로 되어 있으면, 회원 비밀번호가 MySQL PASSWORD() 방식(* 로 시작하는 41자)으로 저장돼 있습니다.
- 예전엔 로그인할 때 이걸 새 방식으로 바꿔 주는 코드가 있었는데, 5.6.37부터 빠졌습니다. 오늘 나온 5.6.52도 같습니다(lib/common.lib.php 의 login_password_check() 가 check_password() 만 부름. 깃허브에서 v5.6.36 과 v5.6.37 태그를 비교해 보시면 바로 보입니다).
- 그래서 올린 직후 최고관리자를 포함해 회원 전원이 로그인이 안 되고, DB업그레이드 화면에도 못 들어갑니다.
코어를 안 고치고 extend 폴더에 파일 하나만 두시면 됩니다. 옛 방식으로 비밀번호가 맞으면 새 방식으로 바꿔 저장하고 로그인시킵니다.
extend/legacy_password.extend.php
<?php
if (!defined('_GNUBOARD_')) exit;
// 5.3 이하에서 가입한 회원(MySQL PASSWORD() 해시)이 처음 로그인할 때 새 방식으로 바꿔 저장
add_replace('login_check_need_not_password', 'legacy_mysql_password_login', 10, 5);
function legacy_mysql_password_login($need_not, $mb_id, $mb_password, $mb, $is_social_login)
{
global $g5;
if ($need_not || empty($mb['mb_id']) || $mb_password === '') return $need_not;
$hash = $mb['mb_password'];
if (strlen($hash) !== 41 || $hash[0] !== '*') return $need_not; // 옛 해시가 아니면 그냥 통과
// MySQL PASSWORD() 와 같은 값 = '*' + SHA1(SHA1(비번)) 대문자 (MySQL 8 엔 PASSWORD() 가 없어 PHP 로 계산)
$legacy = '*' . strtoupper(sha1(sha1($mb_password, true)));
if (!hash_equals($hash, $legacy)) return $need_not;
$new = create_hash($mb_password);
sql_query(" update {$g5['member_table']}
set mb_password = '" . sql_real_escape_string($new) . "'
where mb_id = '" . sql_real_escape_string($mb['mb_id']) . "' ");
return true; // 비밀번호 확인 끝 → 뒤의 차단·탈퇴 검사는 그대로 진행
}
맞는 비밀번호는 통과하면서 새 방식으로 바뀌고, 틀린 비밀번호는 거절되고, 이미 새 방식인 회원은 건드리지 않는 것까지 원본 함수로 확인했습니다. 남은 옛 해시가 0이 될 때까지 두시면 됩니다.
SELECT COUNT(*) FROM g5_member WHERE LENGTH(mb_password) = 41 AND mb_password LIKE '*%';
그다음 체크리스트:
- 새 config.php 의 G5_DOMAIN 을 실제 주소로 채우기 (비어 있으면 5.6.37부터 비밀번호 찾기·가입 인증 메일이 안 나갑니다)
- 로그인 → 글쓰기 → 첨부 → 비밀번호 찾기 메일 → (영카트면) 주문·결제 순으로 눌러 보기
- 테스트 서버는 오류를 화면 대신 로그로 모아 보면 빠릅니다
3. 구형 스킨·테마에서 PHP 8.x 로 자주 깨지는 것
php -l 은 문법만 잡아서, 아래 중 실행해야 터지는 것들은 못 잡습니다. 스킨·테마 폴더에서 이 말들을 찾아보시면 대부분 걸립니다.
- $str{0} 처럼 중괄호로 글자 꺼내기 → 8.0부터 치명 오류. $str[0] 으로
- each(), create_function() → 8.0에서 없어짐. foreach, function() {} 으로
- count() 에 배열 아닌 값(null·문자열) → 8.0부터 오류로 멈춤. is_array() 확인 뒤 count
- 없는 배열 키 읽기($row['wr_x'] 등) → 8.0부터 경고가 화면에 찍힘. isset() 이나 ?? '' 로
- mysql_query 같은 mysql_* 직접 호출 → sql_query() 로
- "${변수}" 꼴 문자열, 매개변수 기본값 null 인데 형식만 적은 것 → 8.2·8.4 에서 경고(멈추진 않음)
찾기 예: grep -rnE "each\(|create_function|mysql_|count\(|\\$[A-Za-z_]+\{" skin theme
정리하면 순서는 이렇습니다.
DB·파일 백업 → 테스트 자리에 5.6.52 새로 + data·스킨·테마 복사 + extend 파일 + G5_DOMAIN → 관리자 로그인 → DB업그레이드 전체 실행 → 스킨 오류 고치기 → 기능 눌러 보기 → 운영 서버 PHP 8.4 전환 후 같은 순서
사이트 크기에 따라 맡기시면 보통 하루~사흘 일입니다.
판올림 전에 확인할 것들은 여기 따로 정리해 두었습니다: https://sangsangin.co.kr/blog/board.php?id=49
꿈의세계님 말씀처럼 컨버터를 추천드립니다.
제가 지금 딱 그렇게 하고 있습니다.
심지어 저는 빌더도 사용했더 안맞는 필드가 많아서 더더욱 고생했습니다.
저는 이렇게 했습니다.
일단 그냥 php8.5와 그누 최신버전을 설치한 후
그누 최신 버전의 디비 스키마 백업
이전 버전의 디비 스키마 백업
두 디비 스키마를 비교해서 최신버전에 새로 생긴 필드들만 추가하는 스크립트 만들기 (g5_config, 게시판의 seo 관련 필드들..)
자료 백업 후 최신버전 필드와 매칭시키는 컨버터 만들기 (빌더에서 쓰이던 필드를 wr_* 필드들로 대체하는)
다음 오류나는 부분들 (주로 error.log에서 확인 가능) 처리할 수 있는 함수 만들기
(원소스 수정없이 extend에서 운용가능, 대표적으로 로그인에 쓰이는 암호 처리)
그럼 일단 최신 php 8.x, 그누 최신, 구버전 db파일로 운영이 가능은 합니다.
그후 안정화가 확인되면 구버진 db의 필요없는 필드들은 확인해가며 삭제해도 됩니다.(남겨두셔도 무방)
그렇게 되면 그누보드의 원소스를 수정없이 운영이 가능하므로 보안부분 패치는 계속 진행하셔도 됩니다.
8.x로 올리기 위해서는 많은 부분들이 변경이 된 부분들이 많습니다.
그래서 현제로서는 방법은
8.x에 대한 컨버터를 별도를 만들어서 적용 하고 작업을 하는 것을 추천 합니다.
일단 xampp와 같은 것으로 8.4를 설치를 하시고 그리고 거기에 기존 홈페이지 데이터 및 DB를 넣어서 적요을 하시고 그리고 안되는 부분들이 있으면 이것을 컨버터 형태로 파일을 만들어서 적용 하는 것을 추천 합니다.
이게 제일 간단하게 할 수 있습니다.
그리고 직접 작업이 어려우시면 AI를 활용해서 만들어 달라고 하면 잘 만들어 주기는 합니다
저 같은 경우에는 8.x 로 호완성 문제 때문에 컨버터를 만들어서 적용을 한 적이 있습니다.
참고 하세요
답변에 대한 댓글 3개
또한 저 같은 경우에는 관리자페이지도 커스텀을 해서 사용 중이라 여러므로 건드려야 하는 부분들이 많아서 부득이하게 이렇게 하고 있습니다
더불어서 저 같은 경우에는 서버도 같이 관리를 해야 하기 때문에 서버에 대한 보안 문제도 AI를 통해서 보안 업데이트를 지속적으로 하고 있는 상황입니다
그래서 지금으로서는 최신버전으로 올려서 작업을 새로 하는게 좋다고 생각을 합니다
답변을 작성하려면 로그인이 필요합니다.