Conas a dhéileálann tú le sonraí foirme agus uachtar comhad?

Question

Accepted Answer

Dhéileálann FastAPI le sonraí foirme HTML **form data** (`Form`) agus **uachtar comhad** (`File`/`UploadFile`) — ar leathleathanach ó choirp JSON, toisc go n-úsáideann siad cineálacha ábhair dhifriúla (`multipart/form-data`). Dearbhaítear an dá rud le cineálacha paraiméadair speisialta.

## Réimsí foirme

```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}
```

Usáid `Form()` chun réimsí foirme HTML a fháil (m.sh. foirm logánú). Nóta: is féidir le bealach `Form()` nó `File()` a úsáid ach ní féidir JSON body **ná** sonraí foirme a úsáid araon, toisc gur cineálacha ábhair dhifriúla a bhí iontu. (Éilíonn sé `python-multipart` a bheith suiteáilte.)

## Uachtar comhad

```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` an cineál a bhíonn tugtha do bharrógaireacht — is gné spooled file a bhí ann (téann comhaid mhóra go diosca, ní gach rud sa chuimhne), le modhanna asynchronous (`read`, `write`, `seek`) agus meiteashonraí. Úsáid é ar bharrachas `bytes` do aon rud seachas comhaid bheag.

## Ilchomhaid agus foirm + comhad le chéile

```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
    ...
```

## Bailiú uachtar (slándáil!)

```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
```

## Cén fáth a bhfuil sé tábhachtach

Is gá a bheith páirteach i ndéileáil le sonraí foirme agus uachtar comhad — foirmeacha logánú, uachtar pictiúr próifíl, solathar doiciméad, agus APIanna próiseála comhaid ar fad a bheith ag lorg sé, agus oibríonn sé go difriúil ó na coiribh JSON a úsáideann FastAPI de réir réamhshocrú.

Tá sé riachtanach a thuiscint `Form()` do réimsí foirme agus go háirithe **`UploadFile`** do uachtar (an cur chuige a bhíonn tugtha do bharrógaireacht, toisc go spools sé comhaid mhóra go diosca seachas gach rud a lochtú sa chuimhne — tábhachtach chun comhaid mhóra a láimhseáil gan RAM a chaitheamh amach).

Tá an **freagracht slándála** go comhionann tábhachtach a thagann le huachtar: ó bharr gur ionchur iontaofa nach ea comhaid uachtar, is gá a bhailíochtú a gcineál agus a bhfad, ainmneacha comhaid a ghlan, agus a bheith cúramach conas atá siad stóráilte/freastalaíonn ag seachaint leochaileachtaí.

Is eolas praiticiúil é a thuiscint conas réimsí foirme a fháil, uachtar comhaid aonair agus iolra a láimhseáil, foirmeacha a chur le comhaid, agus uachtar a bhailíochtú go sábháilte chun APIanna fíor-dhomhanda a thógáil a nglacann siad ábhar a chuir úsáideoirí isteach.