웹 양식 파일 검증 구현 체크리스트

파일 업로드 기능의 구현에는 보안상 주의할 점이 많고 놓치기 쉬운 함정도 많습니다. 본 문서에서는 프로덕션 환경에서 안전하게 작동하는 파일 업로드를 구현하기 위한 체크리스트를 설명합니다.

체크리스트 개요

1. 파일 크기 검증

• 업로드 상한을 바이트 단위로 정의하고 있습니다(MB와 MiB의 혼동 없음).
• PHP의 경우, upload_max_filesize와 post_max_size 둘 다 설정하고 있습니다.
• Nginx의 경우, client_max_body_size에 multipart 오버헤드분을 추가하고 있습니다.
• $_FILES['file']['error']가 UPLOAD_ERR_INI_SIZE / UPLOAD_ERR_FORM_SIZE인 경우의 에러 처리가 있습니다.
• 최소 파일 크기 검사가 있습니다(0바이트 파일 제외).

 $maxBytes) {
        throw new \RuntimeException(sprintf(
            'ファイルサイズ（%s）が上限（%s）を超えています',
            number_format($file['size']),
            number_format($maxBytes)
        ));
    }
}

2. 파일 형식 검증（MIME 타입）

• 클라이언트에서 보낸 Content-Type($_FILES['file']['type'])을 신뢰하지 않습니다.
• finfo / mime_content_type()으로 서버 측 MIME 타입 검증을 수행하고 있습니다.
• 허용하는 MIME 타입의 화이트리스트를 정의하고 있습니다.

file($file['tmp_name']);

if (!in_array($mimeType, $allowed, true)) {
    throw new \RuntimeException('許可されていないファイル形式です: ' . $mimeType);
}

3. 파일 확장자 검증

• 확장자의 화이트리스트를 정의하고 있습니다(블랙리스트가 아닌 화이트리스트).
• 이중 확장자(shell.php.jpg)를 감지하고 거부하고 있습니다.
• 대소문자를 정규화하여 검증하고 있습니다(.JPG와 .jpg를 동일시).

 2) {
    throw new \RuntimeException('不正なファイル名です');
}

$ext = strtolower(pathinfo($originalName, PATHINFO_EXTENSION));
if (!in_array($ext, $allowed, true)) {
    throw new \RuntimeException('許可されていない拡張子です: ' . $ext);
}

4. 매직 바이트(파일 서명) 검증

• 중요한 파일(실행 파일 제외 등)에서 매직 바이트를 검증하고 있습니다.