그누보드4 디렉토리 구조 및 설정 파일 위치 변경 방법

• 목록
• 스크랩

그누보드4 디렉토리 구조 및 설정 파일 위치 변경 방법

웹방화벽 등의 환경에 맞춰 그누보드4의 공통 폴더명과 설정 파일 위치를 변경할 때 필요한 사전 백업, 상대 경로 설정, 주요 파일 수정 방법을 안내합니다.

그누보드4 디렉토리 구조 및 설정 파일 수정 전 준비 사항

그누보드4 사이트를 운영하면서 웹방화벽 솔루션 등의 환경에 맞춰 공통 폴더명을 변경하거나 설정 파일의 위치를 조정하기 전에는 원본 파일 전체를 반드시 백업해야 합니다.

백업 및 대비 요령

• 원본 전체 백업: FTP 클라이언트나 서버의 파일 관리자를 사용하여 그누보드 설치 디렉토리 전체를 로컬 PC로 다운로드하여 백업합니다.
• 즉시 복구 대비: 수정 과정에서 화면 깨짐이나 오류 등 문제가 발생했을 때, 백업해 둔 원본 파일을 다시 서버에 업로드하여 즉시 원래 상태로 복구할 수 있도록 대비해야 합니다.

common.php 파일의 g4path 상대 경로 설정 방법

추가 생성된 폴더나 일반 페이지에서 그누보드 기능을 사용하기 위해서는 _common.php 파일을 생성하고, 실제 그누보드 설치 폴더의 위치에 맞춰 $g4_path 변수의 상대 경로를 정확히 지정해야 합니다.

설정 예시

<?php
$g4_path = "."; // common.php 의 상대 경로
/* 경로 마지막에 . 또는 .. 다음에 / 를 적지 않습니다.
$g4_path=".."; // 그누보드가 한단계 위쪽에 있는 경우
$g4_path="../.."; // 그누보드가 두단계 위쪽에 있는 경우
$g4_path="../gnuboard"; // 그누보드가 한단계 위 gnuboard 폴더에 있는 경우
*/
include_once("$g4_path/common.php");
?>

주의사항 및 다음 행동

• 경로 마지막에 . 또는 .. 다음에 /를 적지 않도록 주의합니다. 경로 오타가 발생하면 파일 인클루드 오류가 발생하므로, 설정 후 반드시 경로를 재확인하십시오.
• 본 가이드는 그누보드4(G4) 환경을 기준으로 작성되었으므로 그누보드5(G5) 환경에서는 그대로 적용하지 않도록 주의합니다.

헤더 및 푸터 파일 경로 수정 방법

그누보드4 사이트에서 웹방화벽 솔루션 등의 환경에 맞춰 공통 폴더명을 변경하거나 설정 파일의 위치를 조정할 때는 헤더 및 푸터 파일에서 공통 폴더의 경로를 변경하여 올바른 파일이 호출되도록 수정해야 합니다.

수정 대상 파일

• head.php 및 head.sub.php: 상단 타이틀 및 그룹별 헤더 인클루드 경로를 수정합니다.
• tail.php: 하단 푸터 인클루드 경로를 수정합니다.

경로 수정 예시

푸터 파일 등에서 경로를 불러올 때는 아래와 같은 방식을 참고하여 변경된 공통 폴더 경로를 반영합니다. 서버 환경에 따라 절대 경로($_SERVER["DOCUMENT_ROOT"] 사용) 또는 상대 경로(../ 등) 중 적절한 방식을 선택하여 적용하십시오.

<?php include_once $_SERVER["DOCUMENT_ROOT"]."/v3/common/footer.php"; ?>

적용 후 확인 사항

파일 수정 후 웹사이트에 접속하여 헤더, 푸터, 그리고 공통 라이브러리 및 게시판 기능이 정상적으로 로드되는지 확인해야 합니다. 만약 화면이 깨지거나 오류가 발생한다면 수정 전 백업해 둔 원본 파일로 즉시 복원해야 합니다.

함께 보면 좋은 글

• 그누보드5 헤더 파일(head.php) 위치 확인 및 수정 방법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드4 디렉토리 구조 및 설정 파일 위치 변경 방법