Artikel ini mengambil pandangan yang mendalam tentang cara menggunakan FastAPI untuk melaksanakan fungsi muat turun fail selepas memproses permintaan pos. Kami akan memperkenalkan dua strategi utama secara terperinci: satu adalah untuk mengembalikan fail secara langsung melalui `fileResponse` dan menggunakan pengepala` kandungan `untuk memaksa penyemak imbas untuk memuat turun; Yang lain adalah untuk menghasilkan pautan muat turun melalui permintaan asynchronous JavaScript untuk mengatasi senario generasi fail dan pelbagai pengguna dinamik. Artikel ini merangkumi pemilihan jenis tindak balas FastAPI, pemprosesan data, mekanisme pembersihan fail dan kaedah integrasi depan, yang bertujuan untuk menyediakan tutorial dengan struktur yang jelas dan kepraktisan yang kuat.

Dalam pembangunan aplikasi web moden, adalah keperluan umum untuk backend untuk menerima data yang dikemukakan oleh pengguna (biasanya melalui permintaan pos), memprosesnya, menjana fail dan menyediakannya untuk dimuat turun. Sebagai contoh, perkhidmatan teks-ke-ucapan menerima teks dan menghasilkan fail MP3, atau perkhidmatan pemprosesan data menjana fail laporan. Fastapi, sebagai rangka kerja web Python berprestasi tinggi, menyediakan alat yang berkuasa untuk melaksanakan fungsi ini dengan elegan.

1. Konsep Teras Muat turun Fail di Fastapi

Inti pengendalian muat turun fail FastAPI terletak pada jenis tindak balas dan tetapan header HTTP. Ia melibatkan perkara berikut:

• FileResponse : Kelas respons yang disediakan oleh FastAPI (berdasarkan Starlette), digunakan untuk mengembalikan kandungan fail secara langsung dari laluan fail. Ia secara automatik mengendalikan bacaan fail, tetapan jenis kandungan, dan beberapa tajuk HTTP.
• StreamingResponse : Apabila fail terlalu besar untuk dimuatkan ke dalam memori sekaligus, StreamingResponse boleh digunakan untuk menghantar kandungan fail dalam ketulan.
• Maklum balas : Kelas tindak balas yang paling serba boleh, semua kandungan dan tajuk boleh disesuaikan.
• Header Kandungan Kandungan : Ini adalah tajuk penting dalam respons HTTP, yang mengarahkan pelayar bagaimana mengendalikan kandungan tindak balas.
  • lampiran; filename = "your_file.mp3": memberitahu penyemak imbas untuk memuat turun kandungan sebagai lampiran dan menentukan nama fail yang dimuat turun.
  • INLINE: Memberitahu penyemak imbas untuk cuba memaparkan kandungan dalam tetingkap penyemak imbas jika penyemak imbas menyokong jenis media.

2. Strategi 1: Kembali ke fail muat turun terus selepas permintaan pos

Strategi ini sesuai untuk mengembalikan fail yang dihasilkan terus kepada klien sebagai respons selepas permintaan pos diproses, mencetuskan muat turun penyemak imbas.

2.1 Pelaksanaan sisi pelayan

Di FastAPI, kita boleh menggunakan FileResponse untuk mengembalikan fail. Kuncinya adalah untuk menetapkan tajuk kandungan kandungan dengan betul untuk memastikan penyemak imbas mencetuskan muat turun dan bukannya cuba melihat pratonton.

 Dari Fastapi Import Fastapi, Permintaan, Borang, Latar Belakang
dari fastapi.templating import jinja2templates
dari fastapi.Sespons Import FileResponse, Response, StreamingResponse
Import OS
Dari GTTS Import GTTS # diandaikan untuk digunakan dalam aplikasi teks-ke-ucapan = fastapi ()
templat = jinja2templates (direktori = "templat")

# Simulasi fungsi teks-ke-ucapan def def text_to_speech (bahasa: str, teks: str, output_path: str)-> Tiada:
    tts = gtts (teks = teks, lang = bahasa, lambat = palsu)
    tts.save (output_path)

@app.get ('/')
async def utama (permintaan: permintaan):
    Template kembali

@app.post ('/text2speech')
async def convert_and_download (
    Permintaan: Permintaan,
    Mesej: str = form (...),
    Bahasa: str = form (...),
    latar belakang_tasks: latar belakang
):
    "" "
    Mengendalikan permintaan teks-ke-ucapan dan mengembalikan fail MP3 yang dihasilkan untuk dimuat turun.
    "" "
    temp_dir = "./temp"
    os.makedirs (temp_dir, exist_ok = true) # Pastikan direktori sementara wujud filePath = os.path.join (temp_dir, "selamat datang.mp3")

    # Tetapkan Header Kandungan Kandungan untuk memaksa muat turun FileName = os.path.BaseName (FilePath)
    headers = {'content-disposition': f'attachment; filename = "{filename}" '}

    # Tambahkan laluan fail ke tugas latar belakang dan padamkannya setelah respons dihantar latar belakang_tasks.add_task (os.remove, filePath)

    # Kembali FileResponse
    Kembali FileResponse (filePath, headers = headers, media_type = "audio/mp3")

Analisis Kod:

• Borang (...) : Fastapi menggunakan suntikan kebergantungan bentuk untuk mengekstrak parameter dari data bentuk dan secara automatik mengesahkannya. Borang (...) menunjukkan bahawa parameter ini diperlukan.
• FileResponse (filePath, headers = headers, media_type = "audio/mp3") : Ini adalah teras fail yang kembali.
  • FilePath: Laluan fail yang akan dimuat turun.
  • Headers: Kamus yang mengandungi tajuk kandungan kandungan, mengarahkan penyemak imbas untuk memuat turun fail.
  • Media_Type: Jenis mime fail, seperti audio/mp3.
• Latar Belakang : Selepas muat turun fail selesai, biasanya kita perlu membersihkan fail sementara yang dihasilkan pada pelayan. Latar Belakang membolehkan kami melakukan tugas -tugas yang tidak segerak selepas menghantar respons tanpa menyekat permintaan utama. latar belakang_tasks.add_task (os.remove, filePath) akan memadam fail selepas ia berjaya dihantar kepada pelanggan.

2.2 Alternatif: Respons dan StreamingResponse

• Gunakan tindak balas untuk mengembalikan data fail dalam memori : Jika kandungan fail telah dimuatkan sepenuhnya ke dalam memori (contohnya, failnya kecil atau telah diproses semula), anda boleh menggunakan respons secara langsung untuk mengembalikan aliran byte.

   @app.post ('/text2speech_in_memory')
  async def convert_and_download_in_memory (
      Mesej: str = form (...),
      Bahasa: str = form (...)
  ):
      # Simulasi kandungan fail yang dihasilkan ke dalam memori # Dalam aplikasi sebenar, mungkin IO.Bytesio Object Temp_dir = "./Temp"
      os.makedirs (temp_dir, exist_ok = true)
      filePath = os.path.join (temp_dir, "selamat datang_in_memory.mp3")
      text_to_speech (bahasa, mesej, filePath) # menjana fail ke cakera dengan terbuka (filePath, "rb") sebagai f:
          Kandungan = F.READ () # Baca kandungan fail ke dalam ingatan os.remove (filePath) # padamkan fail sementara dengan segera kerana kandungannya sudah dalam filename memori = "welcome_in_memory.mp3"
      headers = {'content-disposition': f'attachment; filename = "{filename}" '}
      Tindak Balas Kembali (Kandungan, Headers = Headers, Media_Type = 'Audio/mp3')

• Gunakan StreamingResponse untuk memproses fail besar : StreamingResponse adalah pilihan yang lebih baik untuk fail besar yang tidak dapat dimuatkan ke dalam memori sekaligus. Ia menghantar fail dalam ketulan sebagai aliran data untuk mengelakkan limpahan memori.

   @app.post ('/text2speech_streaming')
  async def convert_and_download_streaming (
      Mesej: str = form (...),
      Bahasa: str = form (...),
      latar belakang_tasks: latar belakang
  ):
      temp_dir = "./temp"
      os.makedirs (temp_dir, exist_ok = true)
      filePath = os.path.join (temp_dir, "welcome_streaming.mp3")
      text_to_speech (bahasa, mesej, filePath)
  
      def iterfile ():
          dengan terbuka (filePath, "rb") sebagai f:
              Hasil dari F # Baca kandungan fail dalam Chunks Filename = os.path.BaseName (FilePath)
      headers = {'content-disposition': f'attachment; filename = "{filename}" '}
      latar belakang_tasks.add_task (os.remove, filePath) # Juga memadam fail di latar belakang streamingResponse (iterfile (), headers = headers, media_type = "audio/mp3")

  NOTA : FileResponse juga melaksanakan pemindahan chunked di bawah tudung (saiz bahagian lalai 64KB), yang mencukupi untuk kebanyakan kes. StreamingResponse memberikan fleksibiliti yang lebih besar untuk mengawal logik chunking.

2.3 Borang HTML Front-end

Untuk muat turun langsung, bahagian depan yang paling mudah adalah menggunakan borang HTML standard.

 

   
      <tirtle> Tukar teks ke ucapan 
   
   
      <h1> Teks ke Ucapan dan Muat turun </h1>
      <form method="post" action="/text2speech">
         Mesej: <input type="text" name="message" value="Ini adalah mesej sampel"> <br>
         Bahasa: <input type="text" name="language" value="en"> <br>
         <input type="hantar" value="hantar dan muat turun">
      </form>
   
</tirtle>

3. Strategi 2: Permintaan Asynchronous dan Muat turun Pautan Generasi

Apabila muat turun langsung tidak berkenaan (contohnya, pengguna dikehendaki mengesahkan muat turun, fail tersebut dihasilkan secara dinamik dan memerlukan akses serentak oleh beberapa pengguna, atau interaksi klien yang lebih kompleks diperlukan), anda boleh mendapatkan pautan muat turun terlebih dahulu melalui permintaan tak segerak, dan kemudian muat turun pelanggan melalui pautan.

Pendekatan ini biasanya melibatkan:

1. Pelanggan mengemukakan data melalui permintaan pos.
2. Pelayan memproses data, menghasilkan fail, dan menghasilkan pengenal unik (seperti UUID) untuk fail.
3. Pelayan mengaitkan laluan fail dengan pengenal (contohnya, disimpan dalam kamus atau pangkalan data) dan mengembalikan URL muat turun yang mengandungi pengenal tersebut.
4. Selepas pelanggan menerima URL, ia secara dinamik mencipta pautan muat turun atau secara langsung mencetuskan muat turun.

3.1 Pelaksanaan sisi pelayan

 Dari Fastapi Import Fastapi, Permintaan, Borang, Latar Belakang
dari fastapi.templating import jinja2templates
dari fastapi.Sespons Import FileResponse
import uuid
Import OS
Dari GTTS Import GTTS # diandaikan untuk digunakan dalam aplikasi teks-ke-ucapan = fastapi ()
templat = jinja2templates (direktori = "templat")

# Simulasi penyimpanan fail, pangkalan data atau cache yang diedarkan hendaklah digunakan dalam aplikasi sebenar files_cache = {} # store {file_id: filePath}

def text_to_speech (bahasa: str, teks: str, output_path: str) -> Tiada:
    tts = gtts (teks = teks, lang = bahasa, lambat = palsu)
    tts.save (output_path)

DEF REAVE_FILE_AND_CACHE_ENTRY (filePath: str, file_id: str):
    "" "Tugas Latar Belakang: Padam fail dan penyertaan cache bersih" ""
    jika os.path.exists (filePath):
        OS.Remove (FilePath)
    jika file_id dalam files_cache:
        del files_cache [file_id]

@app.get ('/')
async def main_async (permintaan: permintaan):
    Template kembali

@app.post ('/penjana_download_link')
async def penjana_download_link (
    Mesej: str = form (...),
    Bahasa: str = form (...)
):
    "" "
    Mengendalikan permintaan teks-ke-ucapan, menjana fail, dan mengembalikan pautan muat turun.
    "" "
    temp_dir = "./temp"
    os.makedirs (temp_dir, exist_ok = true)

    # Menjana nama fail dan ID yang unik
    file_id = str (uuid.uuid4 ())
    filePath = os.path.join (temp_dir, f "audio_ {file_id} .mp3")

    text_to_speech (bahasa, mesej, filePath)

    #Sepasi laluan fail dengan id dan simpannya dalam files_cache cache [file_id] = filePath

    # Kembalikan pautan muat turun muat turun_url = f '/muat turun_file/{file_id}' # lebih selamat menggunakan parameter laluan kembali {"fileurl": muat turun_url}

@app.get ('/muat turun_file/{file_id}')
async def download_generated_file (
    file_id: str,
    latar belakang_tasks: latar belakang
):
    "" "
    Sediakan muat turun fail berdasarkan ID fail.
    "" "
    filePath = files_cache.get (file_id)

    jika tidak filePath atau tidak os.path.exists (filePath):
        # Fail tidak wujud atau telah tamat tempoh tindak balas pulangan (status_code = 404, kandungan = "fail tidak dijumpai atau tamat tempoh.")

    FileName = os.path.BaseName (FilePath)
    headers = {'content-disposition': f'attachment; filename = "{filename}" '}

    # Selepas fail dimuat turun, bersihkan fail dan cache latar belakang_tasks.add_task (REIVANE_FILE_AND_CACHE_ENTRY, filePath, file_id)

    Kembali FileResponse (filePath, headers = headers, media_type = 'audio/mp3')

Analisis Kod:

• files_cache : Pemetaan kamus mudah dihasilkan file_ids ke laluan fail sebenar. Dalam persekitaran pengeluaran, ini harus menjadi penyimpanan yang berterusan (seperti pangkalan data atau redis) dan melaksanakan mekanisme tamat tempoh.
• Generate_download_link Route : Terima permintaan pos, menjana fail dan unik file_id, simpan file_id dan filePath dalam files_cache, dan kembali respons json yang mengandungi muat turun_url.
• muat turun_generated_file/{file_id} Route : Ini adalah laluan permintaan GET yang menerima file_id sebagai parameter laluan. Ia melihat laluan fail yang sepadan dari files_cache dan kemudian mengembalikan fail menggunakan fileResponse.
• Tugas Latar Belakang Buangan
• Pertimbangan Keselamatan : Dalam contoh, FileId diluluskan sebagai parameter laluan. Dalam aplikasi praktikal, jika FileId mengandungi maklumat sensitif, anda harus mengelakkannya mendedahkannya dalam URL dan mempertimbangkan menggunakan badan permintaan pos, tajuk HTTP, atau pengurusan sesi yang selamat. Juga, pastikan anda menggunakan protokol HTTPS.

3.2 HTML dan JavaScript Front-End

Pelanggan menggunakan API FETCH JavaScript untuk menghantar data borang secara asynchronously, dapatkan pautan muat turun, dan kemudian kemas kini pautan muat turun pada halaman.

 

   
      <tirtle> Tukar teks ke ucapan (async) 
   
   
      <h1> muat turun teks-ke-ucapan dan asynchronous </h1>
      <form id="myForm">
         Mesej: <input type="text" name="message" value="Ini adalah mesej sampel"> <br>
         Bahasa: <input type="text" name="language" value="en"> <br>
         <input type="butang" value="Menjana pautan muat turun" onclick="hantarForm ()">
      </form>

      <p> <a id="muat turun" href="" style="paparan: none;"> muat turun fail </a> </p>

      <script type="text/javascript">
         fungsi hantarForm () {
             var formElement = document.getElementById (&#39;myForm&#39;);
             var data = formData baru (formElement); // Dapatkan borang data ambil (&#39;/Generate_download_link&#39;, {
                   Kaedah: &#39;pos&#39;,
                   badan: data, // hantar data borang})
                 .THEN (response => response.json ()) // parse json response.then (data => {
                   jika (data.fileUrl) {
                     var downloadLink = document.getElementById ("muat turun");
                     muat turunLink.href = data.fileUrl; // Tetapkan pautan muat turun muat turun.style.display = &#39;block&#39;; // Paparkan pautan muat turun muat turun.innerHtml = "Klik untuk memuat turun fail mp3 yang dihasilkan";
                   } else {
                     Console.error ("URL muat turun tidak diperoleh dari pelayan.");
                   }
                 })
                 .catch (error => {
                   Console.error ("Permintaan gagal:", ralat);
                   Alert ("Gagal menjana fail, sila cuba sebentar lagi.");
                 });
         }
      </script>
   
</tirtle>

Analisis Kod:

• FormData (FormElement) : Mudah mendapatkan nilai semua medan input dari bentuk HTML.
• ambil ('/Generate_download_link', {method: 'Post', Body: Data}) : Hantar permintaan postynchronous kepada backend FastAPI.
• .THEN (response => response.json ()) : Mengurangkan tindak balas JSON yang dikembalikan oleh pelayan ke objek JavaScript.
• .THEN (data => {...}) : Proses data yang dikembalikan oleh pelayan yang mengandungi FileUrl, dan kemas kini atribut HREF dari tag pada halaman untuk menunjuk ke pautan muat turun.

4. Langkah berjaga -jaga dan amalan terbaik

• Pembersihan fail sementara : Tidak kira strategi mana yang diterima pakai, adalah perlu untuk memastikan bahawa fail sementara yang dihasilkan di pelayan boleh dibersihkan dalam masa untuk mengelakkan kehabisan ruang cakera. Latar Belakang adalah penyelesaian yang elegan yang disediakan oleh FastAPI.
• Nama fail yang unik : Dalam senario multi-pengguna atau tinggi-koncurrency, adalah penting untuk menggunakan nama fail yang unik (seperti digabungkan dengan UUID) untuk setiap fail sementara yang dihasilkan untuk mengelakkan konflik fail dan kebocoran data.
• Konvensyen dan pengurusan negeri : Jika anda menggunakan kamus memori seperti files_cache untuk menguruskan ID dan laluan fail, dalam persekitaran yang mempunyai perselisihan yang tinggi dan pelbagai proses pekerja (seperti Gunicorn dengan pelbagai pekerja), anda perlu menggantikannya dengan storan yang dikongsi bersama (seperti REDIS, pangkalan data) untuk memastikan semua proses pekerja dapat mengakses maklumat yang betul.
• Keselamatan :
  • Sentiasa gunakan protokol HTTPS untuk mendapatkan pemindahan data.
  • Elakkan lulus maklumat sensitif dalam parameter pertanyaan URL.
  • Melaksanakan mekanisme pengesahan dan kebenaran yang sesuai untuk memastikan pengguna hanya boleh memuat turun fail yang mereka kebenaran untuk mengakses.
  • Pengesahan ketat dan sanitisasi input pengguna untuk mengelakkan serangan traversal jalan atau kelemahan keselamatan yang lain.
• Pengendalian ralat : Mekanisme pengendalian ralat yang mantap harus ditambah ke kedua -dua bahagian depan dan hujung belakang. Sebagai contoh, arahan mesra boleh diberikan apabila fail tidak wujud, generasi gagal atau terdapat masalah rangkaian.
• Pengalaman Pengguna : Pertimbangkan untuk menyediakan petunjuk pemuatan semasa penjanaan fail dan memuat turun untuk meningkatkan pengalaman pengguna.

Meringkaskan

FastAPI menyediakan mekanisme yang fleksibel dan berkuasa untuk mengendalikan muat turun fail selepas permintaan pos. Dengan menggabungkan fileResponse dengan tajuk kandungan kandungan, muat turun penyemak imbas boleh dicetuskan secara langsung. Untuk senario yang lebih kompleks, terutamanya apabila melibatkan generasi fail dinamik dan akses multi-pengguna, menggabungkan permintaan asynchronous JavaScript dan tugas latar belakang untuk menghasilkan pautan muat turun dan melaksanakan pengurusan fail adalah strategi yang lebih disyorkan. Memahami konsep teras dan amalan terbaik ini akan membantu pemaju membina keupayaan muat turun fail yang cekap, selamat, dan mesra pengguna.

Atas ialah kandungan terperinci Panduan Komprehensif untuk memuat turun fail setelah mengendalikan permintaan pos menggunakan fastapi. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!