DEV WIKI
백엔드 · 문제 해결 가이드

파일 업로드가 완료되지 않아요

PHP 기반 사이트에서 이미지·첨부 파일 업로드가 실패할 때 파일 크기·POST 크기·임시 디렉터리·권한을 구분하는 가이드입니다.

빠른 답변

PHP 업로드가 완료되지 않으면 파일 하나의 크기, POST 전체 크기, 파일 개수, 임시 디렉터리와 저장 경로 권한을 순서대로 확인해야 합니다. 원본 파일을 공유하거나 제한값을 무제한으로 변경하지 않습니다.

적용 범위
이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
출처 확인일
2026-07-27
최종 검토
2026-08-29
수정일
2026-08-29
대상
사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
오류·수정 제보 (새 창에서 열림)

이 가이드가 맞는 경우

  • 파일 업로드가 완료되지 않음

상황별 다음 단계

호스팅사·개발자에게 전달할 내용

변경 전 기록

  • URL, 발생 시각, 파일 확장자, 대략적인 크기, 업로드 파일 개수, 화면 문구를 전달합니다.
  • 원본 파일, 고객 문서, 이미지 메타데이터, 접근 토큰은 전달하지 않습니다.

알아둘 점

“이미지 업로드 안 돼요”, “첨부파일 업로드 실패”로 검색하는 상황에서 사용합니다. 이 가이드는 PHP가 multipart 요청을 처리하는 환경에 적용하며, 카페24·그누보드·WordPress의 관리자 화면 위치는 서로 다를 수 있습니다.

먼저 기록할 것

  1. 파일 내용 대신 확장자·대략적인 크기·개수·발생 시각을 기록합니다.
  2. Network의 업로드 요청 URL·HTTP 상태·응답 문구와 화면의 오류를 비교합니다.
  3. PHP의 upload_max_filesize, post_max_size, max_file_uploads와 임시 디렉터리·저장 경로의 쓰기 가능 여부를 확인합니다.
  4. 설정값을 바꾸기 전 현재 값·적용된 PHP 실행 환경·변경 권한을 기록합니다.
관찰값다음 문서
파일 업로드 요청은 실행됐지만 저장·완료 결과가 없음PHP 파일 업로드가 완료되지 않음
UPLOAD_ERR_INI_SIZE·1 또는 UPLOAD_ERR_FORM_SIZE·2가 확인됨PHP 업로드 크기 제한 오류

문의·예약과 함께 파일을 보냈다면 문의·예약 신청 결과를 확인할 수 없어요에서 폼 제출 결과도 별도로 확인합니다.

WordPress 미디어 라이브러리에서 이미지가 올라가지 않는다면 워드프레스 이미지 업로드 오류 점검표에서 사이트 건강의 미디어 처리 정보와 uploads 디렉터리 상태를 확인합니다.

카페24 관리자에서 상품 이미지, 디자인 파일업로더 또는 게시판 첨부가 실패했다면 카페24 이미지·파일 업로드 오류 확인표에서 화면별 크기·확장자·개수 제한을 먼저 구분합니다. 관리자 업로더의 제한과 PHP 설정은 같은 조건이 아닙니다.

수정 후 재확인

  1. 비민감한 테스트 파일 1개로 업로드를 재현하고 요청 상태·응답·저장 결과를 기록합니다.
  2. 파일 크기·개수·확장자를 한 번에 하나씩 바꿔 어느 조건에서 실패하는지 비교합니다.
  3. 정상 업로드 뒤 관리자 화면과 실제 저장 경로에서 같은 파일을 확인합니다.

같은 상황의 가이드

참고 자료

Description of core php.ini directives - PHP Manual (새 창에서 열림)

The PHP Group · 공식 자료 · 확인 범위: guide-branch-php-file-upload · 확인일: 2026-07-27