그누보드4에서 5로 이전 시 게시판 첨부파일(wrfile) 데이터 구조 갱신 가이드

• 목록
• 스크랩

그누보드4에서 5로 이전 시 게시판 첨부파일(wr_file) 데이터 구조 갱신 가이드

그누보드4에서 5로 마이그레이션 시 첨부파일 관리 방식 변경으로 인해 발생하는 게시판 테이블의 wr_file 필드 불일치 문제를 해결하고, 데이터를 일괄 갱신하는 방법을 안내합니다.

그누보드4에서 5로 이전 시 wr_file 갱신 필요성

그누보드5는 게시글에 포함된 첨부파일의 개수를 관리하기 위해 게시판 테이블 내에 wr_file이라는 별도의 필드를 사용합니다. 그누보드4에서 5로 데이터를 이전할 때, 이 필드 값이 실제 첨부파일 개수와 일치하지 않으면 다음과 같은 문제가 발생할 수 있습니다.

• 첨부파일 아이콘 미표시: 게시글 목록이나 본문에서 첨부파일이 존재함에도 아이콘이 나타나지 않음
• 파일 출력 오류: 첨부파일이 정상적으로 출력되지 않거나 엑스박스(X) 형태로 표시됨

따라서 마이그레이션 후에는 데이터베이스의 wr_file 값을 실제 첨부파일 데이터와 일치시키는 보정 작업이 필수적입니다.

게시판 첨부파일 정보(wr_file) 일괄 갱신 방법

데이터베이스 구조 변경에 따른 불일치를 해결하기 위해 별도의 PHP 스크립트를 사용하여 일괄 갱신을 수행해야 합니다.

1. 작업 전 주의사항

• DB 백업 필수: 스크립트 실행 전 반드시 데이터베이스 전체를 백업하십시오. 잘못된 실행으로 인한 데이터 손실을 방지하기 위함입니다.
• 스크립트 출처 유지: 제공된 변환 스크립트 상단에 명시된 제작자 정보와 출처 표기를 유지해야 합니다.

2. 실행 절차

1. 스크립트 파일 생성: 관련 기술 자료에서 제공하는 PHP 코드를 복사하여 별도의 파일(예: update_wr_file.php)로 저장합니다.
2. 업로드: 생성한 파일을 그누보드5가 설치된 서버의 /bbs 또는 /adm 디렉토리에 업로드합니다.
3. 실행: 웹 브라우저를 통해 해당 파일에 접속하여 실행합니다. 화면의 안내에 따라 그누보드4의 경로를 확인하고 wr_file 갱신 버튼을 클릭하여 작업을 진행합니다.
4. 결과 확인: 스크립트 실행 후 게시판 테이블의 wr_file 필드 값이 실제 첨부파일 개수와 일치하는지 데이터베이스를 통해 확인합니다.

3. 추가 점검 사항

스크립트 실행 후에도 첨부파일이 보이지 않는다면 다음을 확인하십시오.

• 파일 경로 확인: 그누보드4의 data/file/ 폴더 내 파일들이 그누보드5의 data/file/ 폴더로 정상적으로 복사되었는지 확인합니다.
• 권한 설정: 서버 환경에 따라 파일 읽기 권한이 올바르게 설정되어 있는지 점검합니다.

게시판 첨부파일(wr_file) 정보 일괄 갱신 방법

Q1에서 설명한 필요성에 따라, 제공된 PHP 스크립트를 사용하여 게시판 테이블의 wr_file 필드를 일괄 보정하는 절차는 다음과 같습니다.

1. 작업 전 필수 준비 사항

• DB 백업: 데이터베이스 구조를 변경하는 작업이므로, 반드시 사전에 데이터베이스 전체 백업을 수행하십시오.
• 스크립트 준비: 기술 자료(S5)에서 제공하는 PHP 코드를 복사하여 별도의 파일로 생성합니다.

2. 스크립트 실행 절차

1. 파일 업로드: 생성한 스크립트 파일을 그누보드 설치 경로의 /bbs 또는 /adm 폴더에 업로드합니다.
2. 스크립트 실행: 웹 브라우저로 해당 파일에 접속합니다.
3. 경로 확인 및 실행: 화면의 입력창에 그누보드4 디렉토리 경로를 확인하고, wr_file 버튼을 클릭하여 일괄 갱신을 진행합니다.

3. 주의사항 및 확인

• 출처 유지: 변환 프로그램 소스 상단 및 화면 하단에 명시된 제작자(로빈아빠, freeimage.kr) 정보를 유지해야 합니다.
• 결과 확인: 스크립트 실행 후, 게시판 테이블(g5_write_{bo_table})의 wr_file 필드 값이 실제 첨부파일 개수와 일치하는지 데이터베이스를 통해 확인하십시오.
• 환경 확인: DB 접속 정보(dbconfig.php)가 올바른지 확인해야 하며, 접속 오류 발생 시 스크립트가 정상적으로 작동하지 않습니다.

게시판 첨부파일(wr_file) 데이터 구조 갱신 시 주의사항

데이터베이스를 직접 수정하는 작업이므로 아래 주의사항을 반드시 준수하여 데이터 손실을 방지하십시오.

1. 작업 전 필수 조치

• DB 전체 백업: 데이터베이스 구조를 수정하는 스크립트를 실행하기 전에는 반드시 데이터베이스 전체를 백업하십시오. 오류 발생 시 즉시 복구할 수 있는 유일한 안전장치입니다.
• 환경 확인: 스크립트는 그누보드5 환경에서 실행해야 하며, 실행 전 common.php 파일이 정상적으로 로드되는지 확인하십시오.

2. 스크립트 실행 및 관리

• 파일 업로드 위치: Q2의 절차에 따라 /bbs 또는 /adm 폴더에 업로드하여 실행합니다.
• 출처 유지: 배포된 스크립트 상단에 명시된 제작자 정보 및 출처 관련 내용을 임의로 삭제하지 마십시오.
• 보안 주의: 스크립트 실행이 완료된 후에는 해당 파일을 서버에서 즉시 삭제하여 외부 접근을 차단하십시오.

3. 실행 후 데이터 검증

• 값 확인: 스크립트 실행 후 게시판 테이블(g5_write_{bo_table})의 wr_file 필드 값이 실제 g5_board_file 테이블에 저장된 해당 게시글의 첨부파일 개수와 일치하는지 확인하십시오.
• 오류 로그 확인: 실행 중 DB 접속 오류나 쿼리 오류가 발생하지 않는지 화면에 출력되는 메시지를 확인하십시오.

첨부파일 표시 오류 점검 가이드

데이터 구조 갱신 스크립트를 실행했음에도 게시판에서 첨부파일이 보이지 않는다면, 데이터베이스 정보 외의 환경적 요인을 순차적으로 점검해야 합니다.

1. 파일 및 폴더 권한 확인

그누보드5는 data 폴더 내의 파일과 하위 폴더에 대해 적절한 읽기/쓰기 권한을 필요로 합니다.

• 권한 설정: data 폴더와 그 하위의 모든 폴더 및 파일이 웹 서버에서 읽을 수 있는 상태인지 확인하십시오. 일부 환경에서는 707 퍼미션이 필요할 수 있습니다.
• 적용 방법: 쉘(Shell) 접속이 가능하다면 chmod -R 707 data 명령어를 통해 일괄 적용할 수 있습니다.

2. 파일 경로 및 복사 상태 확인

데이터베이스의 wr_file 값은 갱신되었더라도, 실제 물리적인 파일이 서버에 존재하지 않으면 파일은 표시되지 않습니다.

• 파일 복사: 그누보드4의 /data/file/ 내 모든 폴더가 그누보드5의 /data/file/ 경로로 정확히 복사되었는지 확인하십시오.
• 경로 확인: 게시판별로 생성된 폴더 내에 실제 파일이 존재하는지 파일 관리자나 FTP를 통해 직접 확인하십시오.

3. 브라우저 캐시 및 서버 캐시

• 브라우저 캐시: 브라우저에 이전 정보가 남아있을 수 있으므로, F5 키를 눌러 새로고침하거나 브라우저 방문 기록 및 캐시를 삭제한 후 다시 확인하십시오.
• 썸네일 캐시: 썸네일 관련 표시 오류가 의심된다면, 기존 썸네일 파일을 삭제하여 재생성을 유도해 볼 수 있습니다.

4. 소유권 확인

파일의 권한(퍼미션)뿐만 아니라, 파일의 소유권(Owner)이 웹 서버 실행 계정과 일치하는지 확인하십시오. 소유권이 잘못 설정되어 있으면 웹 서버가 파일을 읽지 못해 엑박(이미지 깨짐)이나 파일 미표시 현상이 발생할 수 있습니다.

상황별 판단 및 행동 가이드

내 상황	우선할 판단	다음 행동
그누보드 4→5 이전 직후	데이터베이스 구조 불일치 확인	전체 DB 백업 후 보정 스크립트 실행
스크립트 실행 완료	wr_file 필드 값 검증	게시판 테이블의 wr_file 값과 실제 파일 개수 대조
첨부파일이 여전히 안 보임	파일 권한 및 경로 확인	data/file/ 폴더 퍼미션(707) 및 파일 복사 상태 점검

실전 FAQ

Q: 스크립트 실행 시 DB 접속 오류가 발생하면 어떻게 하나요? A: 스크립트가 참조하는 dbconfig.php 경로가 올바른지 확인하십시오. 스크립트 내 $g4_path 변수가 그누보드 설치 경로를 정확히 가리키고 있는지 점검해야 합니다.

Q: 스크립트 실행 후에도 첨부파일이 보이지 않는다면 무엇을 확인해야 하나요? A: 물리적 파일이 data/file/ 하위로 정상 복사되었는지 확인하십시오. 또한, 서버 환경에 따라 data 폴더 및 하위 파일의 권한(퍼미션)이 707로 설정되어 있는지 확인이 필요합니다.

Q: 스크립트 실행 후 파일을 삭제해야 하나요? A: 네, 보안을 위해 데이터 보정 작업이 완료된 후에는 서버에 업로드한 스크립트 파일을 즉시 삭제하여 외부 접근을 차단하십시오.

함께 보면 좋은 글

• 그누보드 첨부파일 다운로드 포인트 차감 로직 분석 및 동작 원리
• 그누보드 첨부파일 다운로드 시 게시글 자동 추천 기능 구현
• 그누보드 게시판 목록에서 첨부파일 이미지 여부에 따른 아이콘 구분 출력하기

참고자료

기타 참고자료

• sir.kr — 그누보드4에서 5로 마이그레이션후 첨부파일 안보이는현상 - SIR - 개발자 커뮤니티
• sir.kr — 그누보드4를 그누보드5로 업그레이드 하려면 - SIR - 개발자 커뮤니티
• happyjung.com — G5 그누보드4 → 그누보드5 이전하기 #6/6 (게시판테이블에 추가된 필드 wr_file 일괄 갱신) > 기술자료 | 해피정닷컴