安裝
pip install fastapi[all]
pip install unicorn
基本使用(不能同時支持,get, post方法等要分開寫)
from fastapi import FastAPI
app = FastAPI()
@app.get('/') # 點get就支持get請求
def read_root():
return {"hello":'world'}
if __name__ == '__main__':
import uvicorn
uvicorn.run(app,host='127.0.0.1',port=8080)
模版渲染
fastapi本身是沒有模版渲染功能的,需要你借助於第三方的模版工具
該框架默認情況下也是借助於jinja2來做模版渲染(flask也是使用jinja2, 如果用過flask, 默認是裝過jinja2)
# 安裝
pip install jinja2
# 基本使用
from starlette.requests import Request
from fastapi import FastAPI
from starlette.templating import Jinja2Templates
app = FastAPI()
# 掛載模版文件夾
tmp = Jinja2Templates(directory='templates')
@app.get('/')
async def get_tmp(request:Request): # async加了就支持異步 把Request賦值給request
return tmp.TemplateResponse('index.html',
{'request':request, # 一定要返回request
'args':'hello world' # 額外的參數可有可無
}
)
@app.get('/{item_id}/') # url后綴
async def get_item(request:Request,item_id):
return tmp.TemplateResponse('index.html',
{'request':request,
'kw':item_id
})
if __name__ == '__main__':
import uvicorn
uvicorn.run(app,host='127.0.0.1',port=8080)
# index.html文件內容
{# index.html #}
<body>
<h1>index頁面</h1>
<h1>{{ args }}</h1>
<h1>{{ kw }}</h1>
</body>
form表單數據交互
注意: 如果要使用request.form()支持表單“解析”,則為必需 python-multipart 。
# 安裝
pip install python-multipart
from starlette.requests import Request
from fastapi import FastAPI,Form
from starlette.templating import Jinja2Templates
app = FastAPI()
tmp = Jinja2Templates(directory='templates')
@app.get('/') # 接受get請求
async def get_user(request:Request):
return tmp.TemplateResponse('form.html',{'request':request})
@app.post('/user/') # 接受post請求
async def get_user(request:Request,
username:str=Form(...), # 直接去請求體里面獲取username鍵對應的值並自動轉化成字符串類型
pwd:int=Form(...) # 直接去請求體里面獲取pwd鍵對應的值並自動轉化成整型
):
print(username,type(username))
print(pwd,type(pwd))
return tmp.TemplateResponse('form.html',{
'request':request,
'username':username,
'pwd':pwd
})
if __name__ == '__main__':
import uvicorn
uvicorn.run(app,host='127.0.0.1',port=8080)
# form.html文件內容
{# form.html #}
<body>
<form action="/user/" method="post">
<p>username<input type="text" name="username"></p>
<p>password<input type="password" name="pwd"></p>
<input type="submit">
</form>
<h1>{{ username }}</h1>
<h1>{{ pwd }}</h1>
</body>
上傳文件
from starlette.requests import Request
from fastapi import FastAPI, Form, File, UploadFile
from starlette.templating import Jinja2Templates
from typing import List
app = FastAPI()
# 掛載模板文件夾
tmp = Jinja2Templates(directory='templates')
@app.get('/') # 接受get請求
async def get_file(request: Request):
return tmp.TemplateResponse('file.html', {'request': request})
# 單個文件
@app.post('/file/') # 接受post請求
async def get_user(request: Request,
file: bytes = File(...), # # 把文件對象轉為bytes類型,這種類型的文件無法保存
file_obj: UploadFile = File(...), # UploadFile轉為文件對象,可以保存文件到本地
info: str = Form(...) # 獲取普通鍵值對
):
# 保存上傳的文件
contents = await file_obj.read()
with open("static/file/" + file_obj.filename, "wb") as f:
f.write(contents)
return tmp.TemplateResponse('index.html', {
'request': request,
'file_size': len(file),
'file_name': file_obj.filename,
'info':info,
'file_content_type':file_obj.content_type
})
# 多個文件
@app.post('/files/')
async def get_files(request:Request,
files_list:List[bytes] = File(...), # [文件1的二進制數據,文件2的二進制數據]
files_obj_list:List[UploadFile]=File(...) # [file_obj1,file_obj2,....] # 文件框里可以同時上傳多個文件
):
# 保存上傳的多個文件
for file in files_obj_list:
contents = await file.read()
filename = file.filename
with open("static/file/" + filename, "wb") as f:
f.write(contents)
return tmp.TemplateResponse('index.html',
{'request':request,
'file_sizes':[len(file) for file in files_list],
'file_names':[file_obj.filename for file_obj in files_obj_list]
}
)
if __name__ == '__main__':
import uvicorn
uvicorn.run(app, host='127.0.0.1', port=8080)
# html頁面文件內容,有倆html文件
{# file.html #}
<body>
<h1>單個文件</h1>
<form action="/file/" method="post" enctype="multipart/form-data">
<input type="file" name="file">
<input type="file" name="file_obj">
<input type="text" name="info">
<input type="submit">
</form>
<h1>多份個文件</h1>
<form action="/files/" method="post" enctype="multipart/form-data">
<input type="file" name="files_list" multiple> {# multiple參數支持一次性傳多個文件 #}
<input type="file" name="files_obj_list" multiple>
<input type="submit">
</form>
</body>
{# index.html #}
<body>
<h2>單個文件</h2>
<h1>{{ file_size }}</h1>
<h1>{{ file_name }}</h1>
<h1>{{ info }}</h1>
<h1>{{ file_content_type }}</h1>
<h2>多個文件</h2>
<h1>{{ file_sizes }}</h1>
<h1>{{ file_names }}</h1>
</body>
</html>
靜態文件配置
需要安裝aiofiles模塊
# 安裝
pip install aiofiles
from starlette.staticfiles import StaticFiles
# 掛載靜態文件夾
app.mount('/static',StaticFiles(directory='static'),name='static') # mount掛載 第一個參數為應用的前綴,第二個為路徑,第三個為別名
# 前端
<link rel="stylesheet" href="{{ url_for('static',path='/css/111.css') }}"> {# url_for后的第一個參數為別名 #}
<script src="{{ url_for('static',path='/js/111.js') }}"></script>
示例文件下載:https://files.cnblogs.com/files/sanduzxcvbnm/project_statis_html_2.7z
