Form data மற்றும் file uploads-ஐ எவ்வாறு கையாள்வது?

Question

Accepted Answer

FastAPI HTML **form data** (`Form`) மற்றும் **file uploads** (`File`/`UploadFile`) ஆகியவற்றைக் கையாளுகிறது — JSON bodies-இலிருந்து வேறுபட்டது, ஏனெனில் அவை வெவ்வேறு content types-ஐப் (`multipart/form-data`) பயன்படுத்துகின்றன. இரண்டும் சிறப்பு parameter types-உடன் அறிவிக்கப்படுகின்றன.

## Form fields

```python
from fastapi import Form

@app.post("/login")
def login(username: str = Form(), password: str = Form()):   # form fields, not JSON
    # data comes as application/x-www-form-urlencoded or multipart/form-data
    return {"username": username}
```

HTML form fields-ஐப் பெற `Form()`-ஐப் பயன்படுத்துங்கள் (எ.கா. ஒரு login form). குறிப்பு: ஒரு route ஒரு JSON body **அல்லது** form data-ஐப் பயன்படுத்தலாம், இரண்டையும் அல்ல, ஏனெனில் அவை வெவ்வேறு content types. (`python-multipart` நிறுவப்பட்டிருக்க வேண்டும்.)

## File uploads

```python
from fastapi import File, UploadFile

@app.post("/upload")
async def upload(file: UploadFile):                  # a single file
    contents = await file.read()                      # read the file's bytes
    file.filename                                      # original name
    file.content_type                                  # MIME type
    # save it:
    with open(f"uploads/{file.filename}", "wb") as f:
        f.write(contents)
    return {"filename": file.filename, "size": len(contents)}
```

`UploadFile` பரிந்துரைக்கப்படும் type — இது ஒரு spooled file (பெரிய files memory-இல் அல்ல, disk-க்குச் செல்கின்றன), async methods (`read`, `write`, `seek`) மற்றும் metadata-உடன். சிறிய files தவிர வேறு எதற்கும் raw `bytes`-க்கு மேலாக இதைப் பயன்படுத்துங்கள்.

## பல files மற்றும் form + file ஒன்றாக

```python
@app.post("/upload-many")
async def upload_many(files: list[UploadFile]):       # multiple files
    return [f.filename for f in files]

@app.post("/profile")
async def profile(name: str = Form(), avatar: UploadFile = File()):
    # combine form fields AND a file upload in one multipart request
    ...
```

## uploads-ஐ validate செய்யுங்கள் (security!)

```python
if file.content_type not in ["image/jpeg", "image/png"]:   # check type
    raise HTTPException(400, "Invalid file type")
# also: limit file SIZE, sanitize filenames, scan content — uploads are untrusted input
```

## இது ஏன் முக்கியம்

Form data மற்றும் file uploads-ஐ கையாள்வது ஒரு பொதுவான, நடைமுறைத் தேவை — login forms, profile picture uploads, document submissions, மற்றும் file-processing APIs அனைத்திற்கும் இது தேவை, மேலும் இது FastAPI default-ஆகப் பயன்படுத்தும் JSON bodies-இலிருந்து வேறுபட்டு செயல்படுகிறது.

form fields-க்கான `Form()` மற்றும் குறிப்பாக uploads-க்கான **`UploadFile`** (பரிந்துரைக்கப்படும் அணுகுமுறை, ஏனெனில் இது எல்லாவற்றையும் memory-இல் ஏற்றுவதற்குப் பதிலாக பெரிய files-ஐ disk-க்கு spool செய்கிறது — RAM-ஐ தீர்த்துவிடாமல் பெரிய files-ஐ கையாள்வதற்கு முக்கியம்) ஆகியவற்றைப் புரிந்துகொள்வது இந்த அம்சங்களுக்கு அவசியம்.

அதே அளவு முக்கியம் uploads-உடன் வரும் **security பொறுப்பு**: upload செய்யப்பட்ட files untrusted input என்பதால், அவற்றின் type மற்றும் size-ஐ validate செய்வது, filenames-ஐ sanitize செய்வது, மற்றும் அவற்றை எப்படி store/serve செய்கிறீர்கள் என்பதில் கவனமாக இருப்பது vulnerabilities-ஐத் தவிர்க்க அவசியம்.

form fields-ஐப் பெறுவது, single மற்றும் பல file uploads-ஐக் கையாள்வது, forms-ஐ files-உடன் இணைப்பது, மற்றும் uploads-ஐ பாதுகாப்பாக validate செய்வது எப்படி என்பதை அறிந்திருப்பது user-submitted content-ஐ ஏற்கும் real-world APIs-ஐ உருவாக்குவதற்கான நடைமுறை அறிவாகும்.