您可以使用定义要由客户端上传的文件File。

　　信息

　　要接收上传的文件，请先安装python-multipart。

　　例如pip install python-multipart。

　　这是因为上载的文件作为“表单数据”发送。

　　1、导入 File

　　导入File和UploadFile来自fastapi：

　　from fastapi import FastAPI, File, UploadFile

　　app = FastAPI()

　　@app.post("/files/")

　　async def create_file(file: bytes = File(...)):

　　return {"file_size": len(file)}

　　@app.post("/uploadfile/")

　　async def create_upload_file(file: UploadFile = File(...)):

　　return {"filename": file.filename}

　　2、定义File参数

　　以与您相同的方式创建文件参数Body或Form：

　　from fastapi import FastAPI, File, UploadFile

　　app = FastAPI()

　　@app.post("/files/")

　　async def create_file(file: bytes = File(...)):

　　return {"file_size": len(file)}

　　@app.post("/uploadfile/")

　　async def create_upload_file(file: UploadFile = File(...)):

　　return {"filename": file.filename}

　　信息

　　File是直接从继承的类Form。

　　但请记住，当你输入Query，Path，File和其他人fastapi，那些实际上是返回特殊类的功能。

　　声明

　　要声明文件正文，您需要使用File，因为否则参数将被解释为查询参数或正文(JSON)参数。

　　这些文件将作为“表单数据”上传。

　　如果您将路径操作函数参数的类型声明为bytes，则FastAPI将为您读取文件，并且您将以形式接收内容bytes。

　　请记住，这意味着全部内容将存储在内存中。对于小文件，这将很好地工作。

　　但是在某些情况下，您可能会受益于使用UploadFile。

　　3、File 参数与 UploadFile

　　定义File类型为的参数UploadFile：

　　from fastapi import FastAPI, File, UploadFile

　　app = FastAPI()

　　@app.post("/files/")

　　async def create_file(file: bytes = File(...)):

　　return {"file_size": len(file)}

　　@app.post("/uploadfile/")

　　async def create_upload_file(file: UploadFile = File(...)):

　　return {"filename": file.filename}

　　使用UploadFile具有以下优点bytes：

　　它使用“假脱机”文件：

　　存储在内存中的文件大小上限为最大，超过此限制后，文件将存储在磁盘中。

　　这意味着它可以很好地用于大型文件，例如图像，视频，大型二进制文件等，而不会占用所有内存。

　　您可以从上传的文件中获取元数据。

　　它具有类似文件的 async界面。

　　它公开了一个实际的PythonSpooledTemporaryFile对象，您可以将其直接传递给需要类似文件的对象的其他库。

　　3.1、UploadFile

　　UploadFile 具有以下属性：

　　filename：str具有上载的原始文件名的A (例如myimage.jpg)。

　　content_type：str具有内容类型(MIME类型/媒体类型)(例如image/jpeg)的A。

　　file：一个SpooledTemporaryFile(类似文件的对象)。这是实际的Python文件，您可以将其直接传递给需要“类文件”对象的其他函数或库。

　　UploadFile具有以下async方法。它们都调用了下面的相应文件方法(使用internal SpooledTemporaryFile)。

　　write(data)：将data(str或bytes)写入文件。

　　read(size)：读取文件的size(int)字节/字符。

　　seek(offset)：转到文件中的字节位置offset(int)。

　　1、例如，await myfile.seek(0)将转到文件的开头。

　　2、如果您只运行await myfile.read()一次然后需要再次读取内容，则此功能特别有用。

　　close()：关闭文件。

　　由于所有这些方法都是async方法，因此您需要“等待”它们。

　　例如，在async 路径操作函数内部，您可以使用以下命令获取内容：

　　contents = await myfile.read()

　　如果您在普通的def 路径操作功能之内，则可以UploadFile.file直接访问，例如：

　　contents = myfile.file.read()

　　async 技术细节

　　使用async方法时，FastAPI在线程池中运行文件方法并等待它们。

　　Starlette技术细节

　　FastAPI的UploadFile继承直接从Starlette的UploadFile，但增加了一些必要的部分，使其兼容Pydantic和FastAPI的其他部分。

　　4、什么是“表格数据”

　　HTML表单()将数据发送到服务器的方式通常对该数据使用“特殊”编码，这与JSON不同。

　　FastAPI将确保从正确的位置而不是JSON读取数据。

　　技术细节枣庄妇科医院哪家好 http://mobile.zzdffkyy.com/

　　表单中的数据application/x-www-form-urlencoded不包含文件时，通常使用“媒体类型”进行编码。

　　但是，当表单包含文件时，它将被编码为multipart/form-data。如果使用File，FastAPI将知道它必须从正文的正确部分获取文件。

　　如果您想了解有关这些编码和表单字段的更多信息，请访问MDN Web文档POST。

　　警告

　　您可以在路径操作中声明多个File和Form参数，但也不能声明希望以JSON形式接收的字段，因为请求的主体将使用而不是进行编码。Bodymultipart/form-dataapplication/json

　　这不是FastAPI的限制，它是HTTP协议的一部分。

　　5、多个文件上传

　　可以同时上传多个文件。

　　它们将与使用“表单数据”发送的同一“表单字段”相关联。

　　要使用它，请声明Listofbytes或UploadFile：

　　from typing import List

　　from fastapi import FastAPI, File, UploadFile

　　from fastapi.responses import HTMLResponse

　　app = FastAPI()

　　@app.post("/files/")

　　async def create_files(files: List[bytes] = File(...)):

　　return {"file_sizes": [len(file) for file in files]}

　　@app.post("/uploadfiles/")

　　async def create_upload_files(files: List[UploadFile] = File(...)):

　　return {"filenames": [file.filename for file in files]}

　　@app.get("/")

　　async def main():

　　content = """

　　"""

　　return HTMLResponse(content=content)

　　您将收到所申报的，一个list的bytes或UploadFile。

　　笔记

　　请注意，自2019年4月14日起，Swagger UI不支持在同一表单字段中上传多个文件。

　　不过，使用标准的OpenAPI ，FastAPI已经与它兼容。

　　因此，只要Swagger UI支持多文件上传或任何其他支持OpenAPI的工具，它们都将与FastAPI兼容。

　　技术细节

　　您也可以使用from starlette.responses import HTMLResponse。

　　FastAPI提供相同starlette.responses的fastapi.responses，就像为你的方便，开发人员。但是大多数可用的响应直接来自Starlette。