그누보드5 SE

GNUBOARD5 Second Edition — gnuboard5 기반 second edition.

특징

• 파일 하나로 반응형 + 다크모드 — PC/모바일 마크업 분리 없이 단일 파일, @media 와 CSS variable + data-theme 으로 처리
• PHP 8.x 호환 (PDO named placeholder)
• utf8mb4 + InnoDB (이모지 지원, MySQL strict mode 호환)
• nullable date/datetime (0000-00-00 폐기)
• 클린 URL 라우팅 (/board/{table}/{wr_id}, /shop/item/{it_id} 등)
• 사용자 모듈 — app/modules/<name>/index.php 두면 /<name> 으로 자동 라우팅 (Next.js app router 풍)
• 설치 마법사 모더나이즈 (진행 단계, 다크모드)
• DB 마이그레이션 도구 — /admin/db_migrate 에서 utf8mb3 → utf8mb4, zero-date → NULL 일괄 변환

요구사항

• PHP 8.0+
• MySQL 5.7+ 또는 MariaDB 10.2+
• Apache + mod_rewrite (또는 nginx 동등 설정)

설치

git clone https://github.com/gnuboard/g5se.git
cd g5se
mkdir -p data && chmod 707 data
mysql -u root -e "CREATE DATABASE g5se CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci"

브라우저로 /install/ 접근 → 마법사 따라 진행.

사용자 모듈 (app/modules/)

파일 하나만 두면 자동으로 라우팅되는 폴더 기반 모듈 시스템. Next.js app router 의 핵심 컨벤션을 PHP/gnuboard 맥락으로 단순화했습니다.

URL ↔ 파일시스템 매핑

파일	URL
app/modules/fortune/index.php	/fortune
app/modules/games/dice/index.php	/games/dice
app/modules/blog/[slug]/index.php	/blog/anything ($_GET['slug'] 자동 주입)

규칙

• 진입점은 항상 index.php. 다른 .php 파일은 직접 호출 불가
• 폴더명 segment: ^[a-zA-Z0-9_-]+$ 만 허용 (path traversal · NUL · backslash 차단)
• [name] 폴더는 dynamic segment — URL capture 가 $_GET[name] + $_REQUEST[name] 에 주입
• system route (/login, /board/..., /shop/... 등) 가 항상 우선 — 사용자 모듈은 기존 경로 덮어쓰기 불가
• 페이지 안에선 include_once('./_common.php') 그대로 동작 (front controller 가 CWD 를 app/ 로 고정)

chrome — modern shell 적용

테마(theme/basic) 와 같은 톤으로 가려면 theme/basic/index.php 의 패턴 그대로 인클루드:

<?php
include_once('./_common.php');

require_once(G5_THEME_PATH.'/modern/_head.inc.php');
include_once('./head.sub.php');
?>
<div class="m-shell">
    <?php require G5_THEME_PATH.'/modern/_nav.inc.php'; ?>
    <main class="m-container">
        <!-- 페이지 본문 -->
    </main>
    <?php require G5_THEME_PATH.'/modern/_footer.inc.php'; ?>
</div>
<?php include_once('./tail.sub.php');

다크모드 자동 대응을 위해 카드·텍스트는 --m-* 토큰 (var(--m-surface), var(--m-text), var(--m-text-muted), var(--m-shadow), var(--m-radius-lg)) 사용 권장.

모듈 데이터 — data/modules/

모듈이 SQLite · 캐시 · 업로드 등 자체 데이터를 둬야 하면 data/modules/<name>/ 아래에:

$dir = G5_DATA_PATH.'/modules/<name>';
if (!is_dir($dir)) mkdir($dir, 0755, true);
$db = new PDO('sqlite:'.$dir.'/store.sqlite');

.htaccess 가 data/modules/ 전체를 직접 URL 접근 차단 (403) 합니다 — 모듈 DB·내부 파일이 노출되지 않음.

활성 / 비활성

• 활성 = app/modules/<name>/index.php 존재
• 비활성 = 폴더명에 점(.) 포함시켜 라우팅 regex 매칭 회피 (예: app/modules/fortune.off/index.php). 코드는 보존되고 URL 만 사라짐
• 완전 제거 = 폴더 삭제

별도 관리자 UI · DB · config 없음. 파일시스템이 단일 진실.

라이센스

MIT License — LICENSE 파일 참조.

문서

• MODERNIZATION.md — 모더나이즈 작업 기록
• CLAUDE.md — AI 보조 도구용 가이드라인

---

기반: gnuboard5