DEVINFO 데빈포 그누보드 포럼 쉽게 찾는 그누보드 실전 정보
BOARD

강좌·기초

BOARD 강좌·기초

그누보드5 및 아미나 빌더 짧은 주소(Short URL) 설치 및 트러블슈팅 가이드

페이지 정보

profile_image
작성자 최고관리자
댓글 0건 조회 0회 작성일 26-11-01 15:25

본문

그누보드5 및 아미나 빌더 짧은 주소(Short URL) 설치 및 트러블슈팅 가이드

그누보드5와 아미나 빌더 환경에서 짧은 주소(Short URL) 기능을 적용할 때 필요한 파일 업로드, 코드 수정 방법과 500 에러 및 링크 오류를 해결하는 방법을 확인합니다.

그누보드5와 아미나 빌더 짧은 주소(Short URL) 파일 업로드 시 주의사항

그누보드5와 아미나 빌더 환경에서 짧은 주소 기능을 적용할 때 파일 업로드 과정에서 빌더 사용 여부에 따라 처리 방식이 달라집니다.

공통 업로드 파일

  • 그누보드5 / lib / shorturl.lib.php
  • 그누보드5 /.htaccess

빌더 환경별 업로드 및 주의할 점

  • 순정 그누보드5: 그누보드5 / bbs / page.php 파일이 없으므로 해당 파일도 함께 업로드합니다.
  • 아미나 빌더: bbs/page.php 파일이 이미 존재하므로 bbs/page.php를 덮어쓰지 말고 .htaccess와 lib/shorturl.lib.php 파일만 각각 수정하여 반영해야 합니다.

그누보드5 및 아미나 빌더 짧은 주소 적용 후 500 에러 조치 방법

그누보드5와 아미나 빌더 환경에서 짧은 주소(Short URL) 기능을 적용한 후 500 Internal Server Error가 발생할 경우, 아파치(Apache) 서버 환경의 .htaccess 파일 설정에서 다음 항목을 확인하고 수정해야 합니다.

1. Options +FollowSymLinks 주석 처리

서버 환경에 따라 Options +FollowSymLinks 설정으로 인해 500 에러가 발생할 수 있습니다. .htaccess 파일 내 해당 줄을 주석 처리합니다.

  • 수정 위치: .htaccess 파일
  • 변경 전: Options +FollowSymLinks
  • 변경 후: #Options +FollowSymLinks

2. RewriteBase 및 RewriteCond 경로 수정 (하위 폴더 설치 시)

그누보드가 최상위 루트가 아닌 하위 폴더(예: /폴더명/그누보드5)에 설치된 경우 경로 설정 오류로 500 에러가 발생할 수 있습니다.

  • 수정 위치: .htaccess 파일
  • RewriteBase 변경: RewriteBase /를 RewriteBase /폴더명/으로 변경합니다.
  • RewriteCond 변경: RewriteCond %{REQUEST_URI} ^/archive/ [NC]를 RewriteCond %{REQUEST_URI} ^/폴더명/archive/ [NC]로 변경합니다.

그누보드5 common.lib.php 짧은 주소 연동 수정 구간 및 내용

그누보드5 및 아미나 빌더 환경에서 lib/common.lib.php 파일을 수정하여 짧은 주소 함수(shorturl())를 연동하고 URL을 변환하려면 파일 내 여러 구간의 코드를 변경해야 합니다.

1. URL 변환 기본 함수 적용 (약 96줄)

  • 대상 코드:
    $url = str_replace("&", "&", $url);
  • 변경 내용:
    //$url = str_replace("&", "&", $url);
$url = shorturl(str_replace("&", "&", $url)); // shorturl.lib.php 짧은주소

2. 경고 메시지 함수 내 URL 처리 추가 (버전별 구간)

  • 그누보드 5~5.2 및 아미나 빌더 (약 157줄):
    if (!$msg) $msg = '올바른 방법으로 이용해 주십시오.';
if ($url) $url = shorturl($url); // shorturl.lib.php 짧은주소
  • 그누보드 5.3.1 기준 (약 156~157줄):
    $msg = $msg? strip_tags($msg, '<br>'): '올바른 방법으로 이용해 주십시오.';
if ($url) $url = shorturl($url); // shorturl.lib.php 짧은주소

3. 복수 URL 변수 처리 구간 (약 187줄)

  • 대상 코드:
    if (!$msg) {
$msg = '올바른 방법으로 이용해 주십시오.';
alert($msg);
}
  • 변경 내용 (하단에 추가):
    $url1 = shorturl($url1); // shorturl.lib.php 짧은주소
$url2 = shorturl($url2); // shorturl.lib.php 짧은주소
$url3 = shorturl($url3); // shorturl.lib.php 짧은주소

4. 버퍼 출력값 필터링 및 라이브러리 포함 (파일 하단)

  • HTML 출력 버퍼 처리 (약 2513줄):
    $buffer = preg_replace('#(</head>[^<]*<body[^>]*>)#', "$javascript{$nl}$1", $buffer);
return shorturl($buffer, true); // shorturl.lib.php 짧은주소
//return $buffer;
  • 라이브러리 파일 인클루드 (파일 제일 하단):
    include_once(G5_LIB_PATH.'/shorturl.lib.php'); // shorturl.lib.php 짧은주소
?>

아미나 빌더 짧은 주소 적용 시 추가 설정 및 변경 항목

아미나 빌더 환경에서 짧은 주소(Short URL) 기능을 적용할 때, 순정 그누보드5와 달리 추가로 확인하고 수정해야 하는 파일 및 설정값이 존재합니다.

1. .htaccess 파일 수정

  • 항목 위치: 아미나 빌더 환경의 .htaccess 파일 104라인
  • 변경 내용: pid를 hid로 변경합니다.

2. lib/shorturl.lib.php 파일 수정

  • 항목 위치: 아미나 빌더 환경의 lib/shorturl.lib.php 파일 241라인
  • 변경 내용: pid를 hid로 변경합니다.

3. 파일 업로드 시 주의사항

  • 순정 그누보드5와 달리 아미나 빌더는 bbs/page.php 파일이 이미 존재하므로, 해당 파일을 덮어쓰지 말고 .htaccess와 lib/shorturl.lib.php 파일만 각각 수정하여 적용해야 합니다.

PHP 7.x 환경에서 CONTENTSDIR 상수 관련 에러 대처 방법

PHP 7.x 이상 환경에서 관리자 페이지 접속 시 _CONTENTS_DIR - assumed 'G5_CONTENTS_DIR' (this will throw an Error in a future version of PHP) in.../lib/shorturl.lib.php on line 78 같은 에러가 발생하는 경우, shorturl.lib.php 파일 상단에 누락된 상수를 직접 정의하여 해결할 수 있습니다.

조치 방법

  1. 에러가 발생하는 파일인 lib/shorturl.lib.php를 엽니다.
  2. 파일 상단의 <?php if (!defined('_GNUBOARD_')) exit; 바로 아래에 다음 상수 정의 코드를 추가합니다.
define('G5_BBS_DIR', '');
define('G5_SHOP_DIR', '');
define('G5_CONTENTS_DIR', '');
define('G5_ADMIN_DIR', '');

그누보드5 및 아미나 빌더 짧은 주소(Short URL) 적용 가이드

1. 내 상황 확인

  • 서버 환경: Apache 서버 기반(.htaccess 파일 사용 가능 여부 확인)
  • 설치 환경: 순정 그누보드5 또는 아미나 빌더 적용 여부

2. 선택 기준 및 다음 행동

  • 파일 업로드:
    • 순정 그누보드5: bbs/page.php, lib/shorturl.lib.php, .htaccess 업로드
    • 아미나 빌더: bbs/page.php는 덮어쓰지 말고, lib/shorturl.lib.php와 .htaccess 파일만 수정하여 적용
  • 코드 수정: lib/common.lib.php 내 URL 변환 함수(shorturl()) 연동 및 bbs/board.php, view.php의 링크 경로를 G5_BBS_URL 기반으로 수정
  • 오류 대응:
    • 500 에러 발생 시: .htaccess 내 Options +FollowSymLinks 주석 처리 및 하위 폴더 설치 시 RewriteBase 경로 수정
    • PHP 7.x 에러 발생 시: shorturl.lib.php 상단에 누락된 상수(G5_BBS_DIR 등) 정의 추가

실전 FAQ

Q. 아미나 빌더 사용 시 주의할 점은 무엇인가요?

  • 아미나 빌더는 bbs/page.php가 이미 존재하므로 덮어쓰지 않아야 합니다. 또한 .htaccess와 lib/shorturl.lib.php 파일 내 104라인, 241라인 등에서 pid를 hid로 변경해야 정상 작동합니다.

Q. 하위 폴더에 설치된 경우 500 에러가 발생합니다.

  • .htaccess 파일에서 RewriteBase /를 RewriteBase /폴더명/으로 수정하고, RewriteCond 경로에도 해당 폴더명을 포함해야 합니다.

Q. PHP 7.x 환경에서 관리자 페이지 접속 시 에러가 납니다.

  • lib/shorturl.lib.php 파일 상단(<?php if (!defined('_GNUBOARD_')) exit; 아래)에 define('G5_BBS_DIR', ''); 등 누락된 상수 4종을 정의하여 해결할 수 있습니다.

함께 보면 좋은 글

참고자료

기타 참고자료

댓글목록

등록된 댓글이 없습니다.