UPLOAD_ERR_INI_SIZE 또는 UPLOAD_ERR_FORM_SIZE

확인

1. PHP 애플리케이션 또는 로그에서 파일 배열의 error 값이 UPLOAD_ERR_INI_SIZE 또는 1인지, UPLOAD_ERR_FORM_SIZE 또는 2인지 확인합니다.
2. 오류 코드가 1이면 현재 upload_max_filesize 값과 파일의 대략적인 크기를 비교합니다.
3. 오류 코드가 2이면 폼의 MAX_FILE_SIZE 입력값이 있는지와 현재 값을 확인합니다.
4. 한 파일만 실패하는지, 같은 요청의 모든 파일이 실패하는지와 파일 개수를 기록합니다. 원본 파일과 실제 파일명은 기록하지 않습니다.

UPLOAD_ERR_INI_SIZE는 php.ini의 upload_max_filesize 제한 초과를, UPLOAD_ERR_FORM_SIZE는 HTML 폼의 MAX_FILE_SIZE 제한 초과를 뜻합니다.

주의

제한값을 무제한으로 바꾸지 않으며, php.ini 제한과 HTML 폼 제한을 동시에 변경하지 않습니다. 업로드된 원본 파일, 고객 문서, 이미지 메타데이터를 로그·이슈·문의 자료에 포함하지 마세요.

출처

• PHP Manual: Predefined Constants (새 창에서 열림)

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

1. PHP 애플리케이션 또는 로그에서 파일 배열의 error 값이 UPLOAD_ERR_INI_SIZE 또는 1인지, UPLOAD_ERR_FORM_SIZE 또는 2인지 확인합니다.
2. 오류 코드가 1이면 현재 upload_max_filesize 값과 파일의 대략적인 크기를 비교합니다.
3. 오류 코드가 2이면 폼의 MAX_FILE_SIZE 입력값이 있는지와 현재 값을 확인합니다.
4. 한 파일만 실패하는지, 같은 요청의 모든 파일이 실패하는지와 파일 개수를 기록합니다. 원본 파일과 실제 파일명은 기록하지 않습니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.