자료·레퍼런스

• 목록
• 스크랩

그누보드4 디렉토리 구조 변경 개요

그누보드4 사이트를 운영할 때 웹방화벽 솔루션 등의 환경에 맞춰 공통 폴더명을 변경하거나 설정 파일의 위치를 조정해야 할 때가 있습니다. 일반적으로 inc 폴더명을 common 등으로 변경하고 관련 파일의 경로를 수정하여 연동할 수 있습니다.

변경 전 사전 백업 및 준비

디렉토리 구조와 설정 파일을 수정하기 전, 원본 파일 전체를 반드시 백업해야 합니다. 문제가 발생했을 때 즉시 원래 상태로 복구할 수 있도록 대비하는 것이 안전합니다.

공통 설정 파일 및 _common.php 구성

추가 생성된 폴더나 일반 페이지에서 그누보드 기능을 사용하기 위해 _common.php 파일을 생성하여 상대 경로를 지정합니다.

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

주요 파일 경로 수정 방법

헤더 및 푸터 파일에서 공통 폴더의 경로를 변경하여 올바른 파일이 호출되도록 수정합니다.

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

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

적용 후 동작 확인 및 복구

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

주의사항

본 가이드는 그누보드4(G4) 환경을 기준으로 작성되었습니다. 그누보드5(G5)는 디렉토리 구조와 설정 방식이 다르므로, G5 환경에서는 해당 코드를 그대로 적용하지 않도록 주의해야 합니다. 또한 _common.php 파일 내의 $g4_path 변수는 실제 그누보드 설치 폴더의 상대 경로에 맞춰 정확히 지정해야 합니다.

함께 보면 좋은 글

• php.ini 설정과 웹 서버 옵션 조정을 통한 파일 업로드 용량 제한 변경 방법
• 그누보드4 게시글 삭제 시 생성된 썸네일 파일 자동 삭제 처리 방법