PHP 사이트에서 파일 업로드가 실패해요

국내 호스팅과 PHP 사이트에서 업로드 크기 제한·임시 디렉터리·게시판 설정을 나눠 확인하는 시작 Guide입니다. 오류 원문과 발생 환경이 일치하지 않으면 원인을 단정하지 않습니다.

먼저 기록할 것

1. 화면·브라우저 개발자 도구·서버 로그 중 어디에서 오류를 확인했는지 기록합니다.
2. 오류 문구·상태 코드·요청 주소·발생 시각을 가능한 한 원문 그대로 보존합니다.
3. 최근 배포·설정·도메인·플러그인·호스팅 변경 여부를 기록합니다.
4. 문의 자료에서는 비밀번호·토큰·쿠키·고객 정보·결제 정보를 제거합니다.

상황별 다음 단계

1. UPLOAD_ERR_INI_SIZE 또는 UPLOAD_ERR_FORM_SIZE이면 UPLOAD_ERR_INI_SIZE 또는 UPLOAD_ERR_FORM_SIZE 문서를 확인합니다.
2. PHP 파일 업로드가 완료되지 않음이면 PHP 파일 업로드가 완료되지 않음 문서를 확인합니다.
3. 그누보드5 게시판 첨부 파일 업로드가 비활성화됨이면 그누보드5 게시판 첨부 파일 업로드가 비활성화됨 문서를 확인합니다.

확인 순서

1. 문제를 재현하는 URL 또는 기능을 한 가지로 고정합니다.
2. 위 Problem의 관찰값과 현재 화면·로그가 일치하는지 비교합니다.
3. 한 번에 하나의 설정이나 코드만 확인하고, 변경 전 값을 보관합니다.
4. 수정 후 같은 브라우저·주소·기능에서 다시 확인합니다.

PHP 업로드 실패 단계

관찰값	판정 기준	다음 확인
요청이 서버에 도착하지 않음	브라우저·프록시·방화벽 단계에서 차단된 상태입니다.	Network 상태 코드와 요청 크기를 확인합니다.
UPLOAD_ERR_INI_SIZE 또는 FORM_SIZE	PHP 또는 폼의 허용 크기를 넘은 상태입니다.	upload_max_filesize, post_max_size와 실제 파일 크기를 비교합니다.
임시 파일 오류	PHP 임시 디렉터리 경로·존재·쓰기 권한을 확인해야 합니다.	upload_tmp_dir과 PHP 실행 계정의 권한을 기록합니다.

운영 서버의 업로드 제한을 무조건 크게 올리거나 디렉터리 권한을 전체 공개로 바꾸지 않습니다. 현재 값과 실패 단계가 확인된 뒤 최소 범위로 변경합니다.

수정 후 재확인

1. 작은 파일·제한에 가까운 파일·실패했던 파일을 구분해 테스트합니다.
2. PHP 오류 코드와 응답 상태가 정상인지 확인합니다.
3. 임시 파일 생성부터 최종 저장·다운로드까지 각각 확인합니다.
4. 같은 URL·계정·파일 조건에서 반복해 실패가 재현되지 않는지 기록합니다.

관련 점검표: PHP 파일 업로드 운영 확인표

오진하지 않기

이 Guide의 제목이나 플랫폼 이름만으로 원인을 확정하지 않습니다. Problem 문서의 조건과 실제 관찰값이 다르면 설정을 변경하지 말고 오류 원문과 환경을 다시 기록합니다.