그누보드 PHP Fatal error: Cannot redeclare 에러 원인과 해결 방법

• 목록
• 스크랩

그누보드 PHP Fatal error: Cannot redeclare 에러 원인과 해결 방법

그누보드를 운영하거나 코드를 수정할 때 발생하는 'Cannot redeclare' 에러의 원인을 파악하고, 중복 호출 제거 및 include_once 적용을 통해 안전하게 해결하는 방법을 안내합니다.

PHP Fatal error: Cannot redeclare 에러 발생 원인

PHP Fatal error: Cannot redeclare 에러는 동일한 함수를 포함하고 있는 PHP 파일이 한 번 이상 로드되어, PHP가 이미 정의된 함수를 다시 정의하려고 시도할 때 발생합니다.

주로 동일한 파일이 여러 번 include 또는 require 되면서 나타납니다. 함수가 포함된 파일이 중복 호출되면 PHP는 해당 함수가 이미 존재한다는 메시지와 함께 실행을 중단합니다.

에러 메시지 구조

화면이나 로그에 출력되는 에러 메시지는 다음과 같은 형태를 가집니다.

Fatal error: Cannot redeclare 메소드명() (previously declared in /디렉토리/파일명.php:에러코드라인) in /디렉토리/파일명.php on line 에러코드라인

PHP Fatal error: Cannot redeclare 에러 해결을 위한 중복 include 제거 방법

그누보드를 운영하거나 직접 수정하는 과정에서 Fatal error: Cannot redeclare 에러가 발생했을 때, 코드 내에서 불필요하게 반복되는 파일 호출을 정리하여 원천적으로 중복 선언을 막을 수 있습니다.

1. 에러 메시지 확인 위치

에러 메시지에 표시된 파일 경로와 라인 번호를 확인합니다.

Fatal error: Cannot redeclare 메소드명() (previously declared in /디렉토리/파일명.php:에러코드라인) in /디렉토리/파일명.php on line 에러코드라인

2. 중복 호출 검사 및 제거 절차

• 에러 메시지에 표시된 파일 경로를 확인하여, 해당 파일이 코드 내에서 불필요하게 여러 번 호출(include 또는 require)되고 있는지 검사합니다.
• 코드 내에서 중복 호출되는 부분을 찾아 제거합니다.
• 만약 반복 호출이 구조상 필요하다면 include 대신 include_once를 사용하여 이미 로드된 파일의 재로드를 방지할 수 있습니다.

// 수정 전
include('파일명.php');

// 수정 후
include_once('파일명.php');

3. 적용 후 확인 및 복구

적용 및 복구 절차는 Q4 (#Q4)를 참고하십시오.

include 대신 include_once를 사용한 코드 수정 방법

PHP 실행 시 동일한 파일이 여러 번 로드되면서 발생하는 Fatal error: Cannot redeclare 에러를 해결하기 위해, 파일을 호출하는 코드를 include 대신 include_once로 변경할 수 있습니다. include_once를 사용하면 해당 파일이 이미 로드되었을 경우 다시 로드하지 않으므로 함수 중복 선언 문제를 방지할 수 있습니다.

코드 수정 예시

// 수정 전
include('파일명.php');

// 수정 후
include_once('파일명.php');

적용 후 확인 및 복구 방법

적용 및 복구 절차는 Q4 (#Q4)를 참고하십시오. include_once와 require_once는 파일이 이미 로드되었는지 확인하여 중복 로드를 방지하며, 오류 발생 시 스크립트 중단 여부에 따라 require_once를 선택할 수 있습니다.

적용 후 확인 방법

수정 사항을 저장한 후, 에러가 발생하던 페이지를 새로고침하여 Fatal error 메시지가 사라지고 페이지가 정상적으로 표시되는지 확인합니다.

복구 방법

만약 수정 후 의도치 않은 동작이 발생한다면, 적용했던 include_once를 다시 include로 되돌려 원래 상태로 복구하십시오.

상황별 판단 및 대응 가이드

내 상황	선택 기준	다음 행동
화면에 Cannot redeclare 에러가 출력됨	에러 메시지에 명시된 파일 경로와 라인 번호 확인	코드 내에서 해당 파일이 불필요하게 중복 호출(include/require)되는지 검사
동일한 파일의 반복 호출이 구조상 필요한 경우	이미 로드된 파일의 재로드를 방지해야 함	호출 코드를 include_once로 변경하여 중복 정의 방지
include_once 적용 후 의도치 않은 동작 발생	설정 변경에 따른 예외 상황 발생	적용했던 include_once를 다시 원래의 include로 되돌려 복구

실전 FAQ

Q. 파일을 여러 번 불러와도 에러가 안 날 때가 있는데, 어떤 때 문제가 되나요?

• 함수나 클래스 선언이 없는 파일은 여러 번 불러와도 문제가 없으나, 함수나 클래스가 정의된 파일이 중복 로드되면 PHP가 이미 정의된 요소를 다시 선언하려 하면서 Fatal error가 발생합니다.

Q. include_once로 바꿨는데도 계속 에러가 사라지지 않습니다.

• 서로 다른 경로 표기법(상대경로와 절대경로)을 혼용하면 PHP가 서로 다른 파일로 인식하여 중복 로드될 수 있습니다. 에러 메시지에 표시된 정확한 파일 경로를 기준으로 모든 호출부가 동일한 경로 방식을 사용하고 있는지 점검하십시오.

함께 보면 좋은 글

• 그누보드 관리자 페이지 Fatal error: Cannot redeclare getfilesize() 해결 방법

참고자료

기타 참고자료

• mercury-seed.com — PHP Fatal error: Cannot redeclare 에러 해결 방법
• m.blog.naver.com — include, include once, require, require once : 네이버 블로그
• codingeverybody.kr — PHP include와 require – 차이점 이해하기와 사용법 알아보기 - 코딩에브리바디