<aside>

</aside>

와! 14강 파일 업로드에 이어, 드디어 15강: 파일 다운로드 응답입니다! 🥳

지난 시간에는 클라이언트가 서버로 파일을 보내는 '업로드' 방법을 배웠죠? 사용자가 이미지를 올리거나 문서를 첨부하는 등의 기능을 구현하는 방법을 익혔습니다. ⬆️

이번 시간에는 그 반대 방향, 즉 서버에 저장된 파일을 클라이언트가 가져갈 수 있도록 '다운로드' 응답을 보내는 방법을 배울 차례입니다! 💾⬇️ 서버에서 생성된 보고서 파일(예: PDF)이나 사용자가 이전에 업로드했던 파일을 다시 제공해야 하는 경우가 많겠죠?

FastAPI에서는 이 과정을 아주 세련되게 처리할 수 있는 방법을 제공합니다. 바로 FileResponse 인데요, 이 친구를 사용하면 서버의 파일을 효율적으로 클라이언트에게 스트리밍 방식으로 전달할 수 있습니다.

이번 강의를 통해 파일 다운로드 기능을 여러분의 API에 추가하는 방법을 확실히 알아봅시다! 준비되셨나요? 😉

📚 챕터 소개

이번 15강에서는 FastAPI를 사용하여 서버에 있는 로컬 파일을 클라이언트에게 응답으로 보내는 방법을 배웁니다. 이 기능을 통해 사용자는 웹 브라우저 등에서 파일을 직접 다운로드할 수 있습니다.

핵심은 FastAPI의 FileResponse 클래스를 사용하는 것입니다. FileResponse는 지정된 경로의 파일을 비동기적으로 읽어 스트리밍 방식으로 응답하므로, 파일 전체를 메모리에 로드하지 않아 매우 효율적입니다. 특히 대용량 파일을 처리할 때 메모리 사용량을 크게 줄일 수 있습니다.

이 강의에서는 FileResponse를 사용하여 파일을 응답하는 기본적인 방법과 함께, 응답 헤더를 설정하여 브라우저가 파일을 어떻게 처리할지 제어하는 방법(media_type, filename)을 실습합니다. 예를 들어, Content-Disposition 헤더를 설정하여 브라우저가 파일을 화면에 표시하는 대신 '다른 이름으로 저장' 대화상자를 띄우도록 할 수 있습니다.

더 나아가, 대용량 파일을 다루거나 파일 내용을 동적으로 생성하여 스트리밍해야 할 때 유용한 StreamingResponse에 대해서도 간략히 소개하고, 파일 경로 처리 시 발생할 수 있는 **보안 문제(경로 조작)**를 방지하기 위한 실무 팁도 함께 알아봅니다.

🎯 챕터 목표

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

서버의 로컬 파일을 클라이언트에게 응답으로 보내는 파일 다운로드의 개념을 이해합니다.
FastAPI의 FileResponse를 사용하여 특정 경로의 파일을 효율적으로 응답할 수 있습니다.
FileResponse 사용 시 media_type 파라미터를 설정하여 응답의 MIME 타입을 지정할 수 있습니다.
FileResponse 사용 시 filename 파라미터를 설정하여 클라이언트에게 제안할 다운로드 파일 이름(Content-Disposition 헤더)을 지정할 수 있습니다.
FileResponse가 비동기 스트리밍 방식으로 동작하여 메모리 효율적임을 이해합니다.