この記事では、POST リクエストの処理後に FastAPI を使用してファイル ダウンロード機能を?qū)g裝する方法について詳しく説明します。 2 つの主な戦略を詳しく紹介します。1 つは、`FileResponse` を通じてファイルを直接返し、`Content-Disposition` ヘッダーを使用してブラウザにダウンロードを強制することです。もう 1 つは、動的なファイル生成とマルチユーザー シナリオに対処するために、JavaScript 非同期リクエストを通じてダウンロード リンクを生成することです。この記事では、FastAPI 応答タイプの選択、フォーム データ処理、ファイル クリーニング メカニズム、およびフロントエンド統(tǒng)合方法について説明し、明確な構(gòu)造と強力な実用性を備えたチュートリアルを提供することを目的としています。

最新の Web アプリケーション開発では、バックエンドがユーザーによって送信されたデータを (通常は POST リクエストを通じて) 受信し、処理し、ファイルを生成してダウンロード用に提供することが一般的な要件です。たとえば、テキスト読み上げサービスはテキストを受信して?? MP3 ファイルを生成し、データ処理サービスはレポート ファイルを生成します。 FastAPI は、高性能 Python Web フレームワークとして、この機能をエレガントに実裝するための強力なツールを提供します。

1. FastAPI でのファイルダウンロードの中心的な概念

FastAPI によるファイル ダウンロードの処理の中核は、応答タイプと HTTP ヘッダー設(shè)定にあります。主に次の點が含まれます。

• FileResponse : FastAPI (Starlette に基づく) によって提供される応答クラス。ファイル パスからファイル コンテンツを直接返すために使用されます。ファイルの読み取り、Content-Type 設(shè)定、および一部の HTTP ヘッダーが自動的に処理されます。
• StreamingResponse : ファイルが大きすぎて一度にメモリにロードできない場合、StreamingResponse を使用してファイルのコンテンツをチャンクで送信できます。
• レスポンス: 最も汎用性の高いレスポンス クラスで、すべてのコンテンツとヘッダーをカスタマイズできます。
• Content-Disposition ヘッダー: これは HTTP 応答の重要なヘッダーであり、ブラウザーに応答コンテンツの処理方法を指示します。
  • 付屬品。 filename="your_file.mp3": コンテンツを添付ファイルとしてダウンロードするようにブラウザに指示し、ダウンロードされるファイル名を指定します。
  • inline: ブラウザーがメディア タイプをサポートしている場合、ブラウザー ウィンドウにコンテンツを表示するようブラウザーに指示します。

2. 戦略 1: POST リクエストの直後にファイルのダウンロードに戻る

この戦略は、POST リクエストの処理後に生成されたファイルを応答としてクライアントに直接返し、ブラウザーのダウンロードをトリガーする場合に適しています。

2.1 サーバー側(cè)の実裝

FastAPI では、FileResponse を使用してファイルを返すことができます。重要なのは、Content-Disposition ヘッダーを正しく設(shè)定して、ブラウザーがプレビューを試行するのではなくダウンロードを確実にトリガーすることです。

 fastapi からのインポート FastAPI、リクエスト、フォーム、バックグラウンドタスク
fastapi.template から Jinja2Templates をインポート
fastapi.responses から FileResponse、Response、StreamingResponse をインポート
OSをインポートする
from gtts import gTTS # 音聲合成アプリでの使用を想定 = FastAPI()
テンプレート = Jinja2Templates(ディレクトリ="テンプレート")

# テキスト読み上げ関數(shù)をシミュレートします def text_to_speech(言語: str, テキスト: str, 出力パス: str) -> なし:
    tts = gTTS(text=テキスト、lang=言語、slow=False)
    tts.save(出力パス)

@app.get('/')
async def main(リクエスト: リクエスト):
    return templates.TemplateResponse("index.html", {"リクエスト": request})

@app.post('/text2speech')
非同期デフォルトのconvert_and_download(
    リクエスト: リクエスト、
    メッセージ: str = Form(...),
    言語: str = Form(...)、
    background_tasks: バックグラウンドタスク
):
    「」
    テキスト読み上げリクエストを処理し、結(jié)果の MP3 ファイルをダウンロード用に返します。
    「」
    temp_dir = "./temp"
    os.makedirs(temp_dir,exist_ok=True) # 一時ディレクトリが存在することを確認します filepath = os.path.join(temp_dir, "welcome.mp3") # 実際のアプリケーションでは、一意のファイル名が生成される必要があります # 音聲合成を?qū)g行します text_to_speech( language, message, filepath)

    # Content-Disposition ヘッダーを設(shè)定してダウンロードを強制する filename = os.path.basename(filepath)
    headers = {'Content-Disposition': f'attachment;ファイル名="{ファイル名}"'}

    # ファイルパスをバックグラウンドタスクに追加し、応答が送信された後に削除しますbackground_tasks.add_task(os.remove, filepath)

    # ファイルレスポンスを返す
    return FileResponse(ファイルパス、ヘッダー=ヘッダー、media_type="audio/mp3")

コード分??析:

• Form(...) : FastAPI はフォーム依存関係注入を使用してフォーム データからパラメーターを抽出し、それらを自動的に検証します。 Form(...) は、このパラメータが必須であることを示します。
• FileResponse(filepath, headers=headers, media_type="audio/mp3") : これは、返されるファイルの中核です。
  • filepath: ダウンロードするファイルのパス。
  • headers: Content-Disposition ヘッダーを含む辭書。ブラウザーにファイルをダウンロードするように指示します。
  • media_type: ファイルの MIME タイプ (audio/mp3 など)。
• BackgroundTasks : ファイルのダウンロードが完了したら、通常、サーバー上に生成された一時ファイルをクリーンアップする必要があります。 BackgroundTasks を使用すると、メインのリクエストをブロックせずに、応答を送信した後に非同期タスクを?qū)g行できます。 background_tasks.add_task(os.remove, filepath) は、ファイルがクライアントに正常に送信された後、ファイルを削除します。

2.2 代替案: Response と StreamingResponse

• Response を使用してメモリ內(nèi)のファイル データを返す: ファイルの內(nèi)容がメモリに完全に読み込まれている場合 (たとえば、ファイルが小さいか、前処理されている場合)、Response を直接使用してバイト ストリームを返すことができます。

   @app.post('/text2speech_in_memory')
  async def Convert_and_download_in_memory(
      メッセージ: str = Form(...),
      言語: str = Form(...)
  ):
      # 生成されたファイルの內(nèi)容をメモリにシミュレートします # 実際のアプリケーションでは、io.BytesIO object temp_dir = "./temp" となる可能性があります
      os.makedirs(temp_dir、exist_ok=True)
      ファイルパス = os.path.join(temp_dir, "welcome_in_memory.mp3")
      text_to_speech( language, message, filepath) # open(filepath, "rb") を f としてディスクにファイルを生成します:
          content = f.read() # ファイルの內(nèi)容をメモリに読み込みます os.remove(filepath) # 內(nèi)容はすでにメモリ內(nèi)にあるため、一時ファイルをすぐに削除します filename = "welcome_in_memory.mp3"
      headers = {'Content-Disposition': f'attachment;ファイル名="{ファイル名}"'}
      return Response(content, headers=headers, media_type='audio/mp3')

• 大きなファイルを処理するには StreamingResponse を使用します。一度にメモリにロードできない大きなファイルには、StreamingResponse が適しています。メモリ オーバーフローを避けるために、ファイルをデータ ストリームとして分割して送信します。

   @app.post('/text2speech_streaming')
  非同期デフォルトconvert_and_download_streaming(
      メッセージ: str = Form(...),
      言語: str = Form(...)、
      background_tasks: バックグラウンドタスク
  ):
      temp_dir = "./temp"
      os.makedirs(temp_dir、exist_ok=True)
      ファイルパス = os.path.join(temp_dir, "welcome_streaming.mp3")
      text_to_speech(言語、メッセージ、ファイルパス)
  
      def iterfile():
          open(filepath, "rb") を f:
              yield from f # ファイルの內(nèi)容をチャンクで読み取る filename = os.path.basename(filepath)
      headers = {'Content-Disposition': f'attachment;ファイル名="{ファイル名}"'}
      background_tasks.add_task(os.remove, filepath) # バックグラウンドでファイルも削除します return StreamingResponse(iterfile(), headers=headers, media_type="audio/mp3")

  注: FileResponse は內(nèi)部でチャンク転送も実裝しています (デフォルトのチャンク サイズは 64KB)。ほとんどの場合はこれで十分です。 StreamingResponse により、チャンキング ロジックをより柔軟に制御できます。

2.3 フロントエンド HTML フォーム

直接ダウンロードの場合、最も単純なフロントエンドは標準の HTML フォームを使用することです。

 <!-- templates/index.html -->

   
      <title>テキストを音聲に変換</title>
   
   
      <h1>テキスト読み上げとダウンロード</h1>
      

以上がF(xiàn)astAPI を使用して POST リクエストを処理した後にファイルをダウンロードするための包括的なガイドの詳細內(nèi)容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。