PHP 8.x 환경 그누보드 common.lib.php Undefined array key 경고 해결 방법

• 목록
• 스크랩

PHP 8.x 환경 그누보드 common.lib.php Undefined array key 경고 해결 방법

PHP 8 이상 버전으로 업그레이드한 후 그누보드 실행 시 발생하는 Undefined array key 경고의 원인을 파악하고, get_list 함수 수정 및 Null 병합 연산자 활용을 통해 안전하게 오류를 해결하는 방법을 알아봅니다.

PHP 8.x 버전 get_list 함수 Undefined array key 경고 해결 방법

PHP 8 이상 버전에서는 배열에 존재하지 않는 키로 접근할 때 발생하는 Undefined array key 경고 처리가 더욱 엄격해졌습니다. 그누보드 환경에서 common.lib.php 파일의 get_list 함수 호출 시 이 경고가 발생하는 원인은 전달된 배열에 필요한 키가 정의되어 있지 않기 때문입니다.

해결 방법

get_list 함수 내부에 기본값 배열($defaults)을 정의하고 array_merge 함수를 사용하여 누락된 키를 방지하도록 코드를 수정합니다.

function get_list($write_row, $board, $skin_url, $subject_len=40) {
 global $g5, $config, $g5_object;
 global $qstr, $page;
 if (empty($write_row) ||!is_array($write_row)) return array();
 
 // PHP 8+ Undefined array key 경고 방지를 위한 기본값 병합
 $defaults = array(
 'wr_id' => 0,
 'wr_subject' => '',
 'wr_content' => '',
 'wr_comment' => 0,
 'wr_datetime' => G5_TIME_YMDHIS,
 'wr_last' => G5_TIME_YMDHIS,
 'wr_homepage' => '',
 'wr_name' => '',
 // 필요한 추가 기본값 정의
 );
 
 $write_row = array_merge($defaults, $write_row);

함수 내부에서 $write_row = array_merge($defaults, $write_row); 코드를 추가하여 배열 키 누락으로 인한 경고를 차단할 수 있습니다.

PHP 8.x 버전 배열 키 경고 해결 방법

PHP 8.x 이상 환경에서는 존재하지 않는 배열 키나 $_SERVER['HTTP_REFERER'] 같은 서버 환경 변수에 접근할 때 Undefined array key 경고가 더욱 엄격하게 발생합니다. 이를 안전하게 예방하고 처리하기 위해서는 명시적인 검사나 기본값 처리를 적용해야 합니다.

1. Null 병합 연산자(??) 및 isset()을 통한 배열 키 확인

외부 입력값이나 항상 존재한다고 보장할 수 없는 배열 및 서버 변수에 접근할 때는 Null 병합 연산자(??)나 isset() 함수를 사용하여 값이 없을 때 대체할 기본값을 지정합니다.

• 적용 예시 (Null 병합 연산자):

  $comp_uids = explode(',', $result['comp_uids']?? '');
  $mb_nick = $member['mb_nick']?? '';

• 적용 예시 ($_SERVER['HTTP_REFERER'] 접근):외부 링크가 없거나 주소창에 직접 URL을 입력해 접속하는 경우 $_SERVER['HTTP_REFERER'] 값이 존재하지 않아 경고가 발생할 수 있습니다.

  if (!$url3) $url3 = clean_xss_tags($_SERVER['HTTP_REFERER']?? '');

• 적용 예시 (isset 조건문):

  if (isset($_GET['fname']) && isset($_GET['age'])) {
  // 처리 로직
  }

2. get_list 함수 등 라이브러리 내부 기본값 병합

그누보드 등의 common.lib.php 내 get_list 함수와 같이 배열 인자를 다루는 곳에서 키가 누락되어 경고가 발생할 때는 함수 내부에서 기본값 배열($defaults)을 정의하고 array_merge를 사용하여 누락된 키를 방지할 수 있습니다.

• 수정 패턴 예시:

  function get_list($write_row, $board, $skin_url, $subject_len=40) {
  global $g5, $config, $g5_object;
  global $qstr, $page;
  if (empty($write_row) ||!is_array($write_row)) return array();
  
  // PHP 8+ Undefined array key 경고 방지를 위한 기본값 병합
  $defaults = array(
  'wr_id' => 0,
  'wr_subject' => '',
  'wr_content' => '',
  'wr_comment' => 0,
  'wr_datetime' => G5_TIME_YMDHIS,
  'wr_last' => G5_TIME_YMDHIS,
  'wr_homepage' => '',
  'wr_name' => ''
  );
  $write_row = array_merge($defaults, $write_row);

에러 억제 기호 및 설정 변경의 문제점과 권장 대안

PHP 8 이상에서 발생하는 Undefined array key 경고를 해결하기 위해 에러 억제 기호(@)를 붙이거나 error_reporting 설정에서 E_WARNING을 제외하여 경고를 숨기는 방식은 근본적인 해결책이 아닙니다.

주요 문제점

• 에러 억제 기호(@): 정의되지 않은 배열 키 변수 앞에 @를 붙여 경고를 건너뛰는 방식은 올바른 방법이 아닙니다. PHP 8.0부터는 에러 억제 기능과 관련된 동작(예: 커스텀 에러 핸들러로 전달되는 severity 값)에 변화가 있어 향후 버전에서 문제가 될 수 있습니다.
• error_reporting 및 common.php 수정: php.ini나 그누보드 /common.php 파일에서 E_WARNING 레벨을 임의로 삭제하여 모든 오류 메시지를 감추는 방식은 다른 중요한 경고까지 숨기게 되므로 불편함과 잠재적 위험을 초래합니다.

권장되는 근본적 대안

• 배열 키 존재 여부 확인: PHP 8은 이전 버전보다 타입 처리와 배열 접근에 더 엄격하므로, 코드를 최신 버전에 맞게 업데이트하여 isset()이나 array_key_exists() 같은 함수로 사전에 배열 키 존재 여부를 확인하는 것이 바람직합니다.
• 기본값 병합 방식 적용: 예를 들어 get_list 함수 등에서는 내부에 기본값 배열($defaults)을 정의하고 array_merge를 사용하여 누락된 키를 방지하는 방식으로 코드를 수정해야 합니다.

PHP 8.x 버전 get_list 함수 경고 해결

• 내 상황: PHP 8 이상 환경의 그누보드에서 common.lib.php 내 get_list 함수 호출 시 Undefined array key 경고 발생
• 선택 기준: 존재하지 않는 배열 키 접근을 방지하기 위해 함수 내부에 기본값 배열($defaults)을 선언하고 array_merge를 적용
• 다음 행동: get_list 함수 내부 상단에 기본값 배열을 정의한 뒤 $write_row = array_merge($defaults, $write_row); 코드를 추가하여 경고 해결 확인

실전 FAQ

Q. 에러 억제 기호(@)를 붙여서 경고를 숨겨도 되나요?

• 답변: 변수 앞에 @를 붙이거나 설정을 변경해 경고를 숨기는 것은 근본적인 해결책이 아니며, PHP 8.0부터는 에러 억제 관련 동작이 변경되어 향후 문제가 될 수 있으므로 isset(), ?? 연산자 또는 기본값 병합 방식을 사용하는 것이 바람직합니다.

Q. common.lib.php 외에 $_SERVER 변수 접근 시 발생하는 경고는 어떻게 처리하나요?

• 답변: $_SERVER['HTTP_REFERER']처럼 항상 존재하지 않는 값에 접근할 때는 Null 병합 연산자(??)를 사용하여 $url3 = clean_xss_tags($_SERVER['HTTP_REFERER']?? '');와 같이 기본값을 지정해야 합니다.

참고자료

기타 참고자료

• sir.kr — php8.5 에서 common.lib.php PHP message: PHP Warning: Undefined array ke 오류 - SIR - 개발자 커뮤니티
• m.blog.naver.com — PHP8.x 에서 "Undefined array key" 오류 발생시 처리방법 : 네이버 블로그
• sir.kr — PHP8.x 에서 "Warning: Undefined array key ..." 를 만나면 - SIR - 개발자 커뮤니티
• sir.kr — 그누보드5가 현재 php8.2~ 이상 버전 지원을 안하나요? - SIR - 개발자 커뮤니티
• trytoso.tistory.com — PHP7에서 PHP8로 올리면서 터진 오류 모음과 해결 방법