개발자를 위한 파일 형식 빠른 참조

웹 애플리케이션 개발에서는 파일 검증, MIME 타입 판정, 업로드 제한 설계 등 파일 형식에 관한 지식이 자주 필요합니다. 이 글에서는 개발 현장에서 자주 다루는 파일 형식을 목록으로 정리합니다. 북마크해두면 언제든 참조할 수 있는 빠른 참고자료로 활용하세요.

이미지 형식

문서 형식

아카이브 형식

텍스트·데이터 형식

MIME 타입 유효성 검사

파일 업로드 기능을 구현할 때 확장자뿐만 아니라 MIME 타입도 검증하는 것이 중요합니다. 다만, MIME 타입은 클라이언트 측에서 위조할 수 있으므로 서버 측에서의 매직바이트(파일 헤더) 체크도 병행하세요.

// PHP でのマジックバイトによる判定
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mimeType = $finfo->file($_FILES['upload']['tmp_name']);

$allowedTypes = [
    'image/png',
    'image/jpeg',
    'image/webp',
    'application/pdf',
];

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

// Node.js での file-type ライブラリを使った判定
import { fileTypeFromFile } from 'file-type';

const type = await fileTypeFromFile('upload.png');
console.log(type);
// { ext: 'png', mime: 'image/png' }

테스트용 파일 다운로드

각 형식의 검증 처리 및 업로드 기능 테스트를 위해 DevLab의 테스트 파일을 활용하시기 바랍니다.

• 이미지 파일 — PNG, JPG, WebP, GIF 다양한 크기
• PDF 파일 — 다양한 크기의 PDF 테스트 파일
• ZIP 파일 — 아카이브 처리 테스트용
• CSV 파일 — 데이터 임포트 테스트
• JSON 파일 — API 테스트용
• 텍스트 파일 — 텍스트 처리 테스트용
• 손상된 파일 — 에러 핸들링 테스트

요약

파일 형식에 대한 올바른 이해는 안전하고 견고한 업로드 기능을 구현하기 위한 기초입니다. 파일 확장자만이 아니라 MIME 타입과 매직 바이트 모두로 검증하여 적절한 검증을 수행하세요. 이 참고 자료를 북마크하여 개발 시 언제든지 참조할 수 있도록 하기를 권장합니다.

❓ 자주 묻는 질문

파일 업로드 시 MIME 타입을 검증해야 하는 이유는?

확장자는 쉽게 위장할 수 있어 확장자만 검사해서는 보안이 충분하지 않습니다. 서버 측에서 finfo나 mime_content_type()으로 MIME 타입을 검증하고, 매직 바이트(파일 헤더) 검사도 함께 사용하면 부정한 파일 업로드를 막을 수 있습니다.

SVG 파일 업로드를 허용할 때 주의할 점은?

SVG는 XML 기반 형식이므로 XSS(크로스 사이트 스크립팅) 위험이 있습니다. 사용자가 업로드한 SVG를 그대로 표시하는 것은 위험합니다. 반드시 새니타이즈 처리를 하여 script 태그나 이벤트 핸들러 같은 위험 요소를 제거한 뒤 사용하세요.

Office 문서(docx, xlsx, pptx)의 내부 구조는 어떻게 되어 있나요?

docx, xlsx, pptx 등의 Office 문서는 ZIP 형식 안에 XML 파일을 담은 구조입니다. MIME 타입은 각각 application/vnd.openxmlformats-officedocument 계열의 긴 문자열이며, 검증 시 이 정확한 MIME 타입을 화이트리스트에 포함해야 합니다.