# 그누보드5

그누보드5는 PHP와 MySQL 또는 MariaDB 기반의 오픈소스 CMS입니다. 게시판과 회원 관리 기능을 제공하며 쇼핑몰 솔루션 영카트를 포함합니다.

## 버전 확인

현재 소스 코드의 버전은 [`version.php`](version.php)에서 확인할 수 있습니다.

## 다운로드 및 설치

### 설치 환경

#### 기본 요구사항

- PHP 5.2.17 이상
  - 최소 요구 버전은 PHP 5.2.17이며 PHP 7.2 이상을 권장합니다.
- MySQL 5.0 이상 또는 MySQL 5.0 이상의 기능을 지원하는 MariaDB
- Linux 호환 운영체제

#### 필수 라이브러리

- GD Library 2.0 이상
- iconv

#### 추가로 필요한 모듈 및 프로그램

- 글을 SNS로 복사하는 기능 사용 시
  - cURL
  - JSON
- 영카트5 모바일 결제 사용 시
  - SOAP
  - OpenSSL

> SIR에서 직접 제작한 그누보드5 및 호환 프로그램은 Linux에서만 개발하고 테스트했습니다. 다른 운영체제에서의 정상 동작은 보장하지 않습니다.

설치 환경에 관한 자세한 내용은 [그누보드5 공식 매뉴얼](https://sir.kr/manuals/g5/1)을 확인하십시오.

### Git을 이용하는 방법

Git을 사용할 수 있는 서버에서는 [GitHub 저장소](https://github.com/gnuboard/gnuboard5)를 복제하여 설치할 수 있습니다.

```bash
git clone https://github.com/gnuboard/gnuboard5.git
cd gnuboard5
```

복제한 `gnuboard5` 디렉터리를 웹 서버의 서비스 경로로 사용하거나, 서비스 경로 안에 소스 전체를 배치합니다. 이후 아래의 공통 설치 절차를 진행합니다.

### 압축파일을 이용하는 방법

1. 다음 중 한 곳에서 설치할 버전의 압축파일을 내려받습니다.
   - [GitHub Releases](https://github.com/gnuboard/gnuboard5/releases)에서 원하는 버전을 선택하고 `Source code (zip)`을 내려받습니다. `*.patch.zip` 파일은 기존 설치본을 업데이트하기 위한 패치이므로 신규 설치에는 사용하지 않습니다.
   - [SIR 그누보드5 다운로드](https://sir.kr/boards/g5_pds)에서 원하는 버전의 배포본을 내려받습니다.
2. 내려받은 압축파일을 풉니다.
3. 압축을 푼 디렉터리의 파일과 하위 디렉터리를 FTP, SFTP 등의 방법으로 웹 서버의 서비스 경로에 업로드합니다.
4. 업로드가 끝나면 아래의 공통 설치 절차를 진행합니다.

### 공통 설치 절차

1. 브라우저에서 소스를 배치한 주소로 접속하여 설치 화면을 엽니다.
2. `data` 디렉터리를 만들라는 안내가 표시되면 `config.php`가 있는 디렉터리에 `data`를 만들고 웹 서버가 쓸 수 있도록 권한을 설정합니다. 공식 매뉴얼에서는 `707` 권한을 예시로 사용합니다.
3. 라이선스 내용을 확인하고 동의한 뒤 설치를 계속합니다.
4. MySQL 또는 MariaDB 접속 정보와 최고관리자 정보를 입력합니다.
5. 설치 완료 화면을 확인한 뒤 생성한 최고관리자 계정으로 로그인합니다.

> 기존 사이트에 재설치하면 데이터가 삭제될 수 있습니다. 진행하기 전에 파일과 데이터베이스를 백업하십시오.

### 기존 설치 업데이트

소스 코드를 업데이트한 뒤 데이터베이스 변경이 포함된 버전은 관리자 메뉴의 **환경설정 → DB업그레이드**에서 변경 내용을 확인하고 명시적으로 실행합니다.

운영 절차와 마이그레이션 작성 규칙은 [데이터베이스 마이그레이션 문서](docs/database-migrations.md)를 확인하십시오.

## 문서 및 지원

- [5.6.39 보안 업데이트 및 필수 DB업그레이드 안내](docs/release-5.6.39.md)

- [5.6.37 SIRK 전용 카카오페이 연동 종료 및 기존 거래 지원](docs/sirk-kakaopay-retirement.md)
- [그누보드5 공식 페이지](https://sir.kr/main/g5/)
- [그누보드5 공식 매뉴얼](https://sir.kr/manuals/g5/1)
- [그누보드5 Q&A](https://sir.kr/questions?s_tag=%EA%B7%B8%EB%88%84%EB%B3%B4%EB%93%9C5)

보안 취약점 신고 방법은 [`SECURITY.md`](SECURITY.md)를 확인하십시오.

## 라이선스

라이선스 전문과 적용 조건은 [`LICENSE.txt`](LICENSE.txt)를 확인하십시오.