Web GuidePHP 업데이트 오류PHP 업그레이드 후 에러홈페이지 흰 화면
PHP 업데이트 후 오류 대처법
버전을 올렸더니 화면이 하얗게 떴습니다.
대부분은 되돌릴 필요 없이 그 자리에서 해결되는 오류입니다.
01먼저 할 일
오류 화면을 보자마자 되돌리면 원인을 알 수 없습니다. 무슨 오류인지부터 확인해야 다음에 또 겪지 않습니다.
STEP 01
오류 로그 열기
서버의 에러 로그에 원인과 파일 위치가 찍혀 있습니다.
STEP 02
메시지 기록
오류 문구와 파일 경로를 그대로 복사해 둡니다.
STEP 03
범위 확인
전체가 안 되는지 특정 기능만 안 되는지 봅니다.
STEP 04
업체 전달
로그 내용을 그대로 전달하면 해결이 빨라집니다.
02흔한 증상
업그레이드 직후 나오는 오류는 유형이 정해져 있습니다. 증상만 봐도 원인을 좁힐 수 있습니다.
흰 화면
치명적 오류. 로그에 원인 파일이 남아 있습니다.
500 오류
서버 설정이나 확장 모듈 문제인 경우가 많습니다.
경고 문구 노출
화면 위에 경고가 찍히는 것. 표시를 끄고 따로 수정합니다.
DB 연결 실패
구형 연결 함수가 제거되어 생깁니다.
한글 깨짐
인코딩 처리 함수의 동작 변화 때문입니다.
업로드 실패
파일 처리 방식이나 용량 설정이 바뀐 경우.
03화면에 오류가 보일 때
방문자에게 오류 문구가 보이는 것은 그 자체가 보안 문제입니다. 경로와 구조가 함께 노출됩니다.
화면 출력은 끄고 로그에만 남기도록 바꿉니다.
오류는 파일로 기록해 나중에 확인합니다.
서버 디렉터리 구조가 보이지 않게 합니다.
응답 헤더의 PHP 버전 표기를 끕니다.
자체 안내 페이지로 대체합니다.
설정 변경은 재시작해야 적용됩니다.
04되돌려야 할 때
모든 오류를 그 자리에서 고칠 수 있는 것은 아닙니다. 되돌릴 기준을 미리 정해 두면 판단이 빠릅니다.
결제가 막혔을 때 매출에 직접 영향이 있으면 즉시 되돌립니다.
회원 로그인 불가 서비스 자체가 멈춘 상태입니다.
데이터 손상 우려 저장이 비정상이면 바로 중단합니다.
원인 불명 장시간 정해 둔 시간을 넘기면 일단 되돌립니다.
되돌린 뒤 복사본에서 원인을 찾아 다시 시도합니다.
05다시 올리기 전에
한 번 실패했다고 버전을 포기하면 문제는 그대로 남습니다. 준비를 보강해 다시 올라가야 합니다.
1
원인 정리
어떤 파일의 무슨 구문이 문제였는지 기록합니다.
2
복사본 구성
운영 환경과 같은 조건의 테스트 환경을 만듭니다.
3
중간 버전 경유
한 번에 건너뛰지 말고 단계적으로 올립니다.
4
기능 목록 작성
테스트할 기능을 미리 적어 둡니다.
5
시간대 조정
방문이 가장 적은 시간에 재시도합니다.
6
대기 인력
적용 직후 확인할 담당자를 지정합니다.
CHECK POINT
□ 오류 로그를 열어 볼 수 있는가
□ 오류 메시지와 파일 경로를 기록했는가
□ 화면에 오류 문구가 노출되지 않게 막았는가
□ 전체 장애인지 일부 기능 장애인지 구분했는가
□ 되돌릴 기준을 미리 정해 두었는가
□ 백업으로 복구할 수 있는 상태인가
□ 원인을 기록으로 남겼는가
□ 재시도 전에 테스트 환경을 준비했는가
#PHP 업데이트 오류#PHP 버전 업그레이드#흰 화면#500 오류#에러 로그#롤백#서버 작업#유지보수#웹비스타#홈페이지 제작