설치하기 API 와 DB 확인하기
페이지 정보
본문
파일을 올렸으면 새 화면을 켜기 전에 주문 창구(API)가 열렸는지 먼저 확인합니다. 여기가 되면 설치의 절반은 끝난 셈입니다.
1. 상태 주소 열기
브라우저 주소창에 내 사이트 주소 뒤에 /api/v1/status 를 붙여 엽니다.
https://example.com/api/v1/status
https://example.com/community/api/v1/status (하위 폴더 설치라면)
글자가 가득한 화면이 나오면 정상입니다. 그중 이 세 곳을 찾아보세요.
| 찾을 곳 | 정상일 때 | 뜻 |
|---|---|---|
"success" |
true |
API 가 대답했습니다 |
"database" 안의 "ok" |
true |
DB 에 연결됐습니다 |
"schema" 안의 "ok" |
true |
새 기능에 필요한 표(테이블)가 모두 있습니다 |
새 기능에 필요한 표는 API 가 처음 불릴 때 스스로 만듭니다. 그래서 대부분은 이 주소를 여는 것만으로
schema가true가 됩니다.
2. schema 가 false 라면
그누보드에 최고관리자로 로그인한 뒤, 이 주소를 엽니다.
https://example.com/adm/dbupgrade.php
그누보드의 DB 업그레이드가 돌면서 필요한 표를 만듭니다. 다시 /api/v1/status 를 열어 schema 가 true 인지 확인하세요.
그래도 안 되면 마지막 방법으로 nextjs-install/tables.sql 을 phpMyAdmin 에서 직접 실행합니다. 파일 안의 표 이름은 g5_ 로 시작합니다. 내 사이트의 표 이름 앞부분(prefix)이 다르면 먼저 바꿔서 실행하세요.
3. 설치 점검 페이지 (선택)
최고관리자로 로그인한 상태에서 이 주소를 열면, 필요한 파일 · PHP 설정 · 표 · 웹서버 설정을 한 화면에서 점검해 줍니다.
https://example.com/nextjs-install/check.php
빨간 줄이 있으면 그 줄의 안내를 따르세요. 설치가 끝나면 이 파일은 지워도 됩니다. (외부에 드러나는 파일을 줄이는 편이 안전합니다.)
이럴 땐
| 보이는 것 | 이유 | 해결 |
|---|---|---|
| 404 (페이지를 찾을 수 없음) | api 폴더 위치가 틀렸거나, nginx 에 규칙이 없음 |
3편 "서버에 올리기"의 위치 확인, nginx 는 다음 글의 nginx 부분 |
database 가 false |
그누보드 자체의 DB 연결 문제 | 그누보드 첫 화면이 열리는지부터 확인 |
| 하얀 화면 / 500 오류 | PHP 버전이 낮거나 오류 | 점검 페이지의 PHP 항목, 호스팅의 PHP 버전 설정 확인 (7.4 이상) |
확인표
- ☐
/api/v1/status에서success,database.ok,schema.ok가 모두true다 - ☐ (선택) 점검 페이지에 빨간 줄이 없다
댓글목록
등록된 댓글이 없습니다.