화면이 열리지 않을 때
| 증상 | 먼저 확인할 것 | 대처 |
|---|---|---|
| vendor/autoload.php 없음 | 완성 배포 ZIP인지, 상위 폴더 배치 | vendor를 포함한 배포본을 다시 올림 |
| 홈은 열리지만 /login은 404 | 웹 루트와 rewrite 설정 | www/.htaccess와 Apache mod_rewrite 확인 |
| 하얀 화면 또는 500 | PHP 버전·필수 확장·오류 로그 | storage/logs/error.log와 호스팅 PHP 로그의 첫 오류 확인 |
| DB 접속 실패 | DB 호스트·이름·계정·권한 | 호스팅 관리 화면의 접속 정보와 비교 |
| 설치·설정 저장 실패 | config/storage 쓰기 권한 | PHP 실행 계정에 필요한 폴더만 쓰기 권한 부여 |
로그인과 가입
- 메일 인증이 오지 않으면 알림·발송의 메일 설정과 테스트 메일 결과, 수신함·스팸함을 확인합니다. 문자로 이메일 인증을 대신하지 않습니다.
- 반복 비밀번호 실패로 잠겼다면 제한 시간이 지난 뒤 올바른 계정으로 시도합니다. Turnstile을 쓰는 사이트는 사이트 키와 호스트 이름도 확인합니다.
- 소셜 로그인 오류는 개발자 콘솔의 콜백 HTTPS 주소와 실제 사이트 주소가 정확히 같은지 확인합니다.
- 회원가입 버튼이 없으면 일반·소셜 가입 허용 정책과 필수 약관 공개 상태를 확인합니다.
저장·업로드 문제
폼의 오류 메시지가 가리키는 칸부터 수정합니다. 파일은 GNUCMS의 크기·확장자 제한뿐 아니라 PHP upload_max_filesize, post_max_size, 호스팅 저장 공간 제한도 받습니다. 이미지 축소본이 생성되지 않으면 gd 지원과 storage의 쓰기 권한을 확인합니다.
요청을 확인할 수 없다는 메시지는 오래 열린 폼의 세션·CSRF가 원인일 수 있습니다. 새 화면을 열어 다시 입력합니다. 결제나 문자 발송 버튼은 결과를 먼저 확인하고 중복 클릭하지 않습니다.
개발자에게 전달할 정보
- 발생한 화면 경로, 시각, 화면에 보이는 오류 문구와 직전 작업을 기록합니다.
- PHP 버전, GNUCMS 제품 버전, 사용자 테마·확장 사용 여부를 함께 전달합니다.
- 비밀번호·API 키·config 전체·실제 고객 연락처는 공개 질문이나 화면 캡처에 포함하지 않습니다.
- 운영 debug는 false로 유지하고 서버 로그에서 원인을 확인합니다.
개발자 참고 소스
문서 파일 갱신 26-10-07 08:34:40