그누보드 게시판에 파일을 첨부할 수 없어요
그누보드 게시판의 첨부 기능과 PHP 업로드 제한이 함께 작동하는 환경에서 파일이 저장되지 않을 때 확인하는 시작 Guide입니다.
빠른 답변
그누보드 파일 첨부 실패는 게시판 설정, PHP 업로드 오류 코드, 최종 저장 경로를 분리해 확인해야 합니다. 업로드 크기 제한과 저장 디렉터리 권한을 같은 문제로 보지 않고 브라우저 요청·PHP 임시 파일·최종 파일을 순서대로 비교합니다.
- 적용 범위
- 이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
- 출처 확인일
- 2026-07-31
- 최종 검토
- 2026-07-31
- 수정일
- 2026-08-04
- 정정 이력
- 2026-07-29 이후 기록 없음
- 대상
- 사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
이 가이드가 맞는 경우
- 파일 업로드가 완료되지 않음
상황별 다음 단계
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 발생한 URL 또는 기능, 오류 원문, 발생 시각을 기록합니다.
- 최근 배포·설정·도메인·플러그인·호스팅 변경이 있었다면 변경 시각과 범위를 함께 기록합니다.
- 비밀번호·인증 토큰·세션 쿠키·주문자 정보·결제 정보를 문의 자료에 포함하지 않습니다.
알아둘 점
그누보드 게시판의 첨부 기능과 PHP 업로드 제한이 함께 작동하는 환경에서 파일이 저장되지 않을 때 확인하는 시작 Guide입니다. 오류 원문과 발생 환경이 일치하지 않으면 원인을 단정하지 않습니다.
먼저 기록할 것
- 화면·브라우저 개발자 도구·서버 로그 중 어디에서 오류를 확인했는지 기록합니다.
- 오류 문구·상태 코드·요청 주소·발생 시각을 가능한 한 원문 그대로 보존합니다.
- 최근 배포·설정·도메인·플러그인·호스팅 변경 여부를 기록합니다.
- 문의 자료에서는 비밀번호·토큰·쿠키·고객 정보·결제 정보를 제거합니다.
상황별 다음 단계
- 게시판 설정에서 첨부 파일 업로드가 비활성화되어 있으면 그누보드5 게시판 첨부 파일 업로드가 비활성화됨을 확인합니다.
- PHP가 임시 파일을 최종 파일로 완료하지 못하면 PHP 파일 업로드가 완료되지 않음을 확인합니다.
- 업로드 파일 또는 요청 크기가 PHP 제한을 초과하면 UPLOAD_ERR_INI_SIZE 또는 UPLOAD_ERR_FORM_SIZE을 확인합니다.
확인 순서
- 문제를 재현하는 URL 또는 기능을 한 가지로 고정합니다.
- 위 Problem의 관찰값과 현재 화면·로그가 일치하는지 비교합니다.
- 한 번에 하나의 설정이나 코드만 확인하고, 변경 전 값을 보관합니다.
- 수정 후 같은 브라우저·주소·기능에서 다시 확인합니다.
그누보드·PHP에서 구분할 값
| 관찰값 | 판정 기준 | 다음 확인 |
|---|---|---|
| 요청이 Network에 보이지 않음 | 브라우저 검증, 폼 구성, 프록시·방화벽 단계에서 서버에 도달하지 않은 상태입니다. | 요청 주소와 브라우저 오류를 먼저 확인합니다. |
요청은 도착하지만 UPLOAD_ERR_*가 기록됨 | PHP 임시 파일 생성 또는 요청 크기 제한 단계에서 실패한 것입니다. | upload_max_filesize, post_max_size, upload_tmp_dir과 오류 코드를 비교합니다. |
| 임시 업로드는 성공하지만 게시글에 파일이 없음 | 최종 저장 경로의 존재·쓰기 권한·디스크 용량을 확인해야 합니다. | 그누보드 첨부 경로와 서버 로그의 저장 실패를 비교합니다. |
운영 서버에서 권한을 일괄적으로 넓히지 말고, 현재 PHP 실행 계정과 대상 디렉터리의 권한·소유자를 기록한 뒤 최소 범위로 수정합니다.
수정 후 재확인
- 같은 게시판, 같은 계정, 같은 크기의 파일로 업로드를 반복합니다.
- 브라우저 응답 코드와 PHP 업로드 오류 코드가 정상인지 확인합니다.
- 게시글을 다시 열어 파일 다운로드와 이미지 표시를 각각 확인합니다.
- 실패 시각·파일 크기·저장 경로·로그를 기록해 이전 시도와 비교합니다.
관련 점검표: 그누보드 파일 업로드 실패 점검표, 그누보드 파일 업로드 운영 확인표
오진하지 않기
이 Guide의 제목이나 플랫폼 이름만으로 원인을 확정하지 않습니다. Problem 문서의 조건과 실제 관찰값이 다르면 설정을 변경하지 말고 오류 원문과 환경을 다시 기록합니다.
참고 자료
SIR · 공식 자료 · 확인 범위: 공식 문서가 오류의 의미와 확인 범위를 설명합니다. · 확인일: 2026-07-31
The PHP Group · 공식 자료 · 확인 범위: 공식 문서가 오류의 의미와 확인 범위를 설명합니다. · 확인일: 2026-07-31
The PHP Group · 공식 자료 · 확인 범위: 공식 문서가 오류의 의미와 확인 범위를 설명합니다. · 확인일: 2026-07-31