PHP 파일 업로드가 완료되지 않음
빠른 답변
- 이 오류는 무엇인가요?
- PHP 기반 사이트에서 파일 업로드가 완료되지 않을 때 파일 업로드 허용, 임시 디렉터리, 크기와 개수 제한을 구분해 확인하는 문서입니다.
- 가장 흔한 원인은 무엇인가요?
- PHP 파일 업로드가 완료되지 않으면 먼저 PHP의 file_uploads 허용 여부, upload_tmp_dir 쓰기 가능 여부, upload_max_filesize, post_max_size, max_file_uploads 제한을 현재 환경에서 구분해 확인해야 합니다. 파일 하나의 크기 제한과 POST 전체 크기 제한은 같은 값이 아닙니다.
- 무엇을 먼저 확인해야 하나요?
- 업로드하려던 파일의 이름 대신 확장자, 대략적인 크기, 파일 개수와 발생 시각만 기록합니다.
현재 증상
- 파일 업로드가 완료되지 않음
먼저 확인할 항목
업로드하려던 파일의 이름 대신 확장자, 대략적인 크기, 파일 개수와 발생 시각만 기록합니다.
PHP 실행 환경에서 file_uploads, upload_tmp_dir, upload_max_filesize, post_max_size, max_file_uploads의 현재 값을 확인합니다.
임시 디렉터리를 지정했다면 PHP를 실행하는 사용자가 쓸 수 있는지 담당자에게 확인합니다.
피해야 할 조치
주의
- 크기 제한을 무제한으로 바꾸거나 임시 디렉터리 권한을 넓히기 전에 현재 값과 영향 범위를 기록합니다.
- 업로드한 원본 파일, 고객 문서, 이미지의 메타데이터를 외부 점검 자료에 공유하지 않습니다.
환경별 원인과 조치
적용 범위
이 문서는 PHP가 처리하는 파일 업로드에서 파일 선택 뒤 완료 결과를 확인하지 못하는 상황을 다룹니다. 브라우저 확장자 제한, 웹 서버 요청 제한, 애플리케이션별 검증, 저장소 권한은 이 문서의 PHP 설정만으로 확정할 수 없습니다.
PHP는 HTTP 파일 업로드 허용 여부, 임시 저장 디렉터리, 파일 하나의 최대 크기, POST 전체 크기, 한 요청의 파일 개수를 각각 설정합니다. upload_max_filesize와 post_max_size는 다른 제한이며, PHP 매뉴얼은 post_max_size가 더 커야 한다고 설명합니다.
변경 없이 확인할 항목
- 실패한 파일의 실제 이름과 내용 대신 확장자, 대략적인 크기, 파일 개수, 발생 시각만 기록합니다.
- PHP 환경에서
file_uploads가 업로드를 허용하는 상태인지 확인합니다. upload_max_filesize,post_max_size,max_file_uploads의 현재 값과 업로드 시도 조건을 비교합니다.upload_tmp_dir을 지정했다면 PHP 실행 사용자가 쓸 수 있는지 담당자에게 확인합니다.
이 항목은 읽기 전용 확인입니다. 제한값이나 디렉터리 권한을 바로 바꾸면 파일 저장, 서버 자원, 보안 정책에 영향을 줄 수 있으므로 변경 전 값과 되돌릴 방법을 기록해야 합니다.
다음 문서와 전달 자료
PHP 런타임의 일반 설정 범위는 PHP 문서에서 확인합니다. 업로드가 문의 또는 예약 폼의 한 부분이라면, 파일 제한과 별개로 문의·예약 신청 결과를 확인할 수 없어요에서 제출 결과를 구분하세요.
담당자에게는 발생 시각, URL, 파일 확장자·대략적인 크기·개수, 화면 문구, 현재 PHP 설정 값만 전달합니다. 원본 파일, 고객 정보, 접근 토큰은 전달하지 않습니다.
참고 자료
The PHP Group · 공식 자료 · 확인 범위: PHP는 file_uploads, upload_tmp_dir, upload_max_filesize, max_file_uploads 설정을 제공합니다., upload_tmp_dir은 PHP 실행 사용자가 쓸 수 있어야 합니다., post_max_size는 upload_max_filesize보다 커야 합니다. · 확인일: 2026-07-27