<aside>

</aside>

안녕하세요! 드디어 FastAPI 강의 3부: 파일 업로드 및 다운로드의 시작, 14강입니다! 🥳

1부와 2부에서는 API의 기본적인 구조, 요청 처리, 응답 생성, 데이터 검증, 의존성 주입, 미들웨어, CORS, 예외 처리, 상태 코드 제어 등 웹 API의 핵심적인 기능들을 탄탄하게 다졌습니다. 정말 많은 것을 배우셨어요! 👏

이제 3부에서는 웹 서비스에서 빼놓을 수 없는 파일 처리에 대해 집중적으로 알아봅니다. 사용자가 프로필 사진을 올리거나, 문서 파일을 첨부하거나, 서버에서 생성된 보고서 파일을 다운로드하는 등의 기능을 어떻게 구현할 수 있을까요?

이번 14강에서는 그 첫걸음으로, 클라이언트가 서버로 파일을 업로드하는 것을 FastAPI에서 어떻게 처리하는지 배웁니다. 이미지, 문서, 동영상 등 다양한 종류의 파일을 안전하고 효율적으로 받는 방법을 알아볼 거예요! 🖼️📄⬆️

파일과 함께하는 API의 세계로 떠나볼 준비, 되셨나요?

📚 챕터 소개

이번 14강에서는 클라이언트(주로 웹 브라우저의 <form> 태그나 JavaScript Workspace API)로부터 서버로 파일을 전송받는 파일 업로드 기능을 FastAPI에서 구현하는 방법을 배웁니다.

HTTP를 통해 파일을 업로드할 때는 주로 multipart/form-data 인코딩 타입이 사용되는데, FastAPI는 이 형식을 쉽게 처리할 수 있도록 지원합니다. 다만, 이를 위해서는 python-multipart 라이브러리를 먼저 설치해야 합니다.

FastAPI에서는 경로 작동 함수의 파라미터 타입 힌트로 bytes 또는 UploadFile을 사용하여 업로드된 파일을 받을 수 있습니다. bytes는 파일 전체 내용을 메모리에 로드하므로 작은 파일에만 적합하며, 대부분의 경우에는 UploadFile 타입을 사용하는 것이 권장됩니다. UploadFile은 메모리와 디스크를 효율적으로 사용하는 스풀링(spooling) 방식을 사용하고 비동기(async) 인터페이스를 제공하여 대용량 파일도 효과적으로 처리할 수 있습니다.

이 강의에서는 File 및 UploadFile을 사용하여 파일을 받고, 파일 이름(filename)이나 콘텐츠 타입(content_type) 같은 메타데이터에 접근하며, 파일 내용을 읽거나 서버에 저장하는 방법(특히 비동기 방식)을 실습합니다. 또한 파일 업로드 시 고려해야 할 기본적인 보안 사항에 대해서도 간략히 언급합니다.

🎯 챕터 목표

이 강의를 마치면 여러분은 다음을 할 수 있게 됩니다:

HTTP 파일 업로드 시 multipart/form-data 인코딩 방식이 사용됨을 이해합니다.
FastAPI 파일 업로드 처리를 위해 python-multipart 라이브러리를 설치할 수 있습니다.
bytes 타입 힌트를 사용하여 작은 파일을 메모리로 직접 받을 수 있습니다.
UploadFile 타입 힌트를 사용하여 크기에 상관없이 효율적으로 파일을 받을 수 있습니다.
UploadFile 객체의 주요 속성(filename, content_type)과 비동기 메서드(read, close)를 사용할 수 있습니다.