그누보드4에서 그누보드5로 이전 시 데이터베이스 설정(dbconfig.php) 가이드

• 목록
• 스크랩

그누보드4에서 그누보드5로 이전 시 데이터베이스 설정(dbconfig.php) 가이드

그누보드4에서 그누보드5로 마이그레이션할 때 변경된 dbconfig.php 파일의 위치와 설정 방법을 확인하고 데이터베이스 접속 오류를 예방할 수 있습니다.

그누보드5 dbconfig.php 설정 가이드

그누보드5는 그누보드4와 비교하여 dbconfig.php 파일의 저장 위치와 내용이 대폭 변경되었습니다. 원활한 데이터베이스 연동을 위해 올바른 위치에 파일을 생성하고 필요한 설정값을 입력해야 합니다.

dbconfig.php 파일 위치

• 그누보드5에서 dbconfig.php 파일은 루트 경로가 아닌 data 하부(디렉토리)에 위치해야 합니다.

주요 설정 및 템플릿

data/dbconfig.php 파일에는 데이터베이스 접속 정보와 테이블 접두사무, 주요 테이블 상수가 정의되어야 합니다. 파일 생성 시 아래의 기본 구조와 상수 정의를 포함하여 설정합니다.

<?php
if (!defined('_GNUBOARD_')) exit;
define('G5_MYSQL_HOST', '디비주소');
define('G5_MYSQL_USER', '디비아이디');
define('G5_MYSQL_PASSWORD', '디비비밀번호');
define('G5_MYSQL_DB', '디비네임');
define('G5_MYSQL_SET_MODE', false);
define('G5_TABLE_PREFIX', 'g5_');

$g5['write_prefix'] = G5_TABLE_PREFIX.'write_'; // 게시판 테이블명 접두사
$g5['config_table'] = G5_TABLE_PREFIX.'config'; // 기본환경 설정 테이블
$g5['member_table'] = G5_TABLE_PREFIX.'member'; // 회원 테이블
// 기타 주요 테이블 상수 정의 포함
?>

그누보드5 테이블 접두사 및 상수 정의

그누보드5에서 데이터베이스 테이블 접두사와 주요 테이블 상수는 data/dbconfig.php 파일 내에서 G5_TABLE_PREFIX 상수와 $g5 배열을 통해 정의됩니다.

테이블 접두사 및 주요 테이블 상수 설정 예시

define('G5_TABLE_PREFIX', 'g5_');
$g5['write_prefix'] = G5_TABLE_PREFIX.'write_'; // 게시판 테이블명 접두사
$g5['auth_table'] = G5_TABLE_PREFIX.'auth'; // 관리권한 설정 테이블
$g5['config_table'] = G5_TABLE_PREFIX.'config'; // 기본환경 설정 테이블
$g5['group_table'] = G5_TABLE_PREFIX.'group'; // 게시판 그룹 테이블
$g5['group_member_table'] = G5_TABLE_PREFIX.'group_member'; // 게시판 그룹+회원 테이블
$g5['board_table'] = G5_TABLE_PREFIX.'board'; // 게시판 설정 테이블
$g5['board_file_table'] = G5_TABLE_PREFIX.'board_file'; // 게시판 첨부파일 테이블
$g5['board_good_table'] = G5_TABLE_PREFIX.'board_good'; // 게시물 추천,비추천 테이블

위와 같이 설정하여 회원, 게시판 및 기본 환경 설정에 필요한 각 테이블들이 올바른 접두사(g5_)와 매핑되도록 구성합니다.

상황별 선택 및 행동 가이드

내 상황	우선할 판단	다음 행동
그누보드4에서 그누보드5로 이전 작업을 시작하려는 경우	그누보드5의 dbconfig.php 파일은 루트가 아닌 data 디렉토리 하부에 생성해야 함을 확인	data/dbconfig.php 파일을 생성하고 G5용 접속 상수 및 테이블 접두사 정의 입력
이전 중 DB 접속 오류가 발생하는 경우	dbconfig.php 파일 내 호스트, 아이디, 비밀번호, DB명 설정값 재확인	오타 여부를 점검하고 그누보드5 환경에 맞는 상수 정의 반영 상태 확인

실전 FAQ

Q. dbconfig.php 파일을 생성한 후 사이트 접속 시 테이블 관련 오류가 발생하면 어떻게 하나요?

• 예외 및 대안: 그누보드5는 data/dbconfig.php 파일에 게시판, 회원 등 주요 테이블 상수가 정의되어 있어야 합니다. 누락된 상수($g5['content_table'] 등)가 있는지 확인하고 템플릿에 맞춰 추가해야 합니다.

Q. 외부 데이터베이스를 연결할 때 dbconfig.php 설정 시 주의할 점은 무엇인가요?

• 실행 중 막히는 지점: 웹호스팅 환경(예: 카페24 등)에 따라 외부 DB 접속을 위한 IP 허용 설정이 선행되어야 하며, G5_MYSQL_HOST 주소가 올바르게 입력되었는지 점검해야 합니다.

참고자료

기타 참고자료

• happyjung.com — G5 그누보드4 를 그누보드5로 이전하기 #2/6 (dbconfig.php 추가) > 기술자료 | 해피정닷컴
• sir.kr — 그누보드 외부접속 DB사용하기 - SIR - 개발자 커뮤니티