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

웹 애플리케이션 개발에서는 파일 검증, 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의 테스트 파일을 활용하시기 바랍니다.

• <a href="/ja/files/images/">이미지 파일</a> — PNG, JPG, WebP, GIF 다양한 크기
• <a href="/ja/files/pdf/">PDF 파일</a> — 다양한 크기의 PDF 테스트 파일
• <a href="/ja/files/zip/">ZIP 파일</a> — 아카이브 처리 테스트용
• <a href="/ja/files/csv/">CSV 파일</a> — 데이터 임포트 테스트
• <a href="/ja/files/json/">JSON 파일</a> — API 테스트용
• <a href="/ja/files/txt/">텍스트 파일</a> — 텍스트 처리 테스트용
• <a href="/ja/files/broken/">손상된 파일</a> — 에러 핸들링 테스트

요약

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