性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)

天下武功,唯快不破。在软件开发中更是如此,“快”能从多方面提升用户体验。谈到Python,它似乎天生就和速度无关,你可能很熟悉Django、Flask这些框架,虽然开发效率的确不错,但是速度就一言难尽。那么在前后端分离开发的时代,有没有能拿得出手的Python Web框架呢?当然是有的,FastApi它来了。
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第1张图片
一、为什么是FastApi?

人们在介绍FastApi的时候通常会说“FastApi”是一个高性能的异步WEB框架。我相信没有哪个程序员会跟“高性能”过不去,这往往也是我们所追求的东西。fastapi具有并发性能强、能够快速上手、容错能力强、自动生成交互式文档的特点,这些都是我们选择它的理由。

二、到底有多快?

很多人介绍FastApi框架时,经常说其并发性能能够和NodeJS以及Go媲美,其实言过其实。在Go语言中文社区中梦想做小猿分别对Go、Flask、FastApi做了性能测试,迫于篇幅限制,我这里直接放结果:

FastAPI:500并发 30秒:Speed=955466 pages/min, 238685 bytes/sec

Flask:500并发 30秒:Speed=33706 pages/min, 96457 bytes/sec

Go:500并发 30秒:Speed=116962 pages/min, 278740 bytes/sec

可见Go还是很强大的,但是fastapi已经远远超过了同为python框架的 flask。

与PHP7对比:

分别用PHP7、FastAPI从mongodb数据库中取出相同的数据做成接口,相同参数得到相同的数据结果,速度如下:

FastApi用时43.06ms:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第2张图片
PHP7 用时43.73ms:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第3张图片
经过多次测试,成绩较为稳定,无需取平均值,由此看来,FastApi速度上相比于其他Python框架,是占有绝对优势的!

三、安装相关模块

FaseApi这么快,想必你已经迫不及待想要了解如何使用了。接下来我们讲讲如何开始第一个FastApi项目。

安装FastApi执行 pip install fastapi

由于FastApi还需要一个ASGI服务框架 uvicorn,需要执行pip install uvicorn来安装uvicorn。

注意Linux下一般会报错如下:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第4张图片
Centos 执行yum install python3-devel,Ubuntu 执行sudo apt-get install python3-dev,即可解决问题,非常简单!

四、Hello, API

现在就来快速上手吧:

第一个api:

创建文件zhiliao.py,码代码:

# -*- coding:utf-8 -*-
from fastapi import FastAPI
​
#创建一个FastApi实例
app = FastAPI()#创建访问路径,下面的函数用来处理"/"的GET请求
@app.get("/")
def read_root():
    return {"Hello": "Api"}

然后在zhiliao.py文件所在目录,执行uvicorn zhiliao:app --reload

其中,zhiliao是py文件名,冒号后面的app是我们在代码中创建的FastAPI实例,这一点类似Flask,其他参数等下会详细说到。

执行之后,得到反馈信息。
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第5张图片
可以看到Uvicorn running on [http://127.0.0.1:8000 [0m (Press CTRL+C to quit),打开浏览器:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第6张图片
这样就成功的创建了第一个接口服务,每次请求的同时我们也能能够看到,请求日志,方便调试。
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第7张图片
获取路径参数:

接着写如下代码:

#程序会获取路径hello后面的参数,传入函数hello作为参数
@app.get("/hello/{name}")
def hello(name):
    res = {}
    res['name'] = name
    return res

保存之后可以看到:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第8张图片
项目自动重新加载了,我们无需再执行uvicorn……,原因是我们刚刚启动实例时,加了–reload参数,这一点类似于Flask中的debug=True,不推荐在线上环境中开启,仅为了线下调试方便。

访问浏览器:http://127.0.0.1:8000/hello/知了,可以看到:
在这里插入图片描述
我们不难发现,res在程序中是一个字典,而fastapi将其自动转为了json格式,无需再使用json模块进行编码,这极大的便利了我们的开发。

问号传参与数据类型限制:

为了防止用户填写表单时不按套路来,我们最好对参数类型进行限制,上代码:

@app.get("/zhiliao")
def read_args(name:str, age:int):
    return {"name": name, "age":age }

浏览器访问http://127.0.0.1:8000/zhiliao?name=张三&age=23:
在这里插入图片描述
如果改成http://127.0.0.1:8000/zhiliao?name=张三&age='23’也即是字符23,会报错,提示数据类型错误。

{"detail":[{"loc":["query","age"],"msg":"value is not a valid integer","type":"type_error.integer"}]}

自动生成文档:

fastapi具有自动生成文档的能力:

交互文档:

访问:http://127.0.0.1:8000/docs,可以看到,上面我们写的三个接口都已经给出了文档。
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第9张图片
还可以继续用于测试,我们测试一下第三个接口,填写两个值,然后点击 execute:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第10张图片
可以看到,给出了非常详细的反馈信息:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第11张图片
API文档:

我们打开http://127.0.0.1:8000/redoc

可以看到详细的文档:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第12张图片
五、进阶篇:

1. 基础参数配置:

我们使用uvicorn 配合fastapi,它是一个基于 asyncio 开发的一个轻量级高效的 Web 服务器框架。

下面一条命令演示常用参数:

uvicorn zhiliao:app --host 127.0.0.1 --port 80

–host是绑定的地址,127.0.0.1为本地,如果是0.0.0.0,那么意味着它将暴露在公网中,所有人都可以访问,线上环境常用。

–port 80表示,使用80端口作为该服务的默认端口,无需在地址后加端口号,可以直接访问 http://127.0.0.1

2. 开启 HTTPS, 给你的网站加把小锁:

鲜有人在讲fastapi时提到开启HTTPS,大人,时代变了,http早已经被谷歌浏览器标记为不安全。不过,你还别说,网站上了https 还真是好看呢。

另外,如果我们的应用不开启https,那么将意味着只能被未开启ssl的网站调用,假设我们主站用的是https,那么我们必须开启HTTPS,否则会调用失败。

说了这么多,其实做起来很简单,执行uvicorn --help可以看到详细的配置文档,可以看到:

  --ssl-keyfile TEXT              SSL key file
  --ssl-certfile TEXT             SSL certificate file
  --ssl-version INTEGER           SSL version to use (see stdlib ssl module's)
                                  [default: 2]

有这么三个参数,第一个是证书的key文件,第二个是crt文件,第三个不用管是默认的。

只需执行:

uvicorn zhiliao:app --host 0.0.0.0 --port 8080 --ssl-keyfile /ssl/private.key --ssl-certfile /ssl/certificate.crt

这意味着我们的应用将会在8080端口运行,并且暴露在公网中,人们都可以访问,–ssl-keyfile参数后面跟key文件目录,–ssl-certfile,同理。可以看到,网站已经可以用https访问。
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第13张图片
3. 配置跨域传参

既然是接口服务,那么跨域传参是必然要碰到的问题。

现有情景如下我们的Api服务是127.0.0.0:8000,而我们的网站主域名是127.0.0.1,

不同端口属于不同域,下面的介绍也适合其他跨域场景比如主站是www.xx.com而api服务的域名是api.xx.com,同样适合。

现在网站要调用api的接口,我们用jquery的 ajax试一下:

建立一个测试文件zhiliao.html,写入如下内容并访问:

<script src="https://cdn.staticfile.org/jquery/1.10.2/jquery.min.js"></script>
<script> //引入CDN jquery
$.get("http://127.0.0.1:8000/", function(data){ //get数据
console.log(data);//控制台打印数据
});
</script>

可以看到,由于是不同域,访问失败:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第14张图片
加上几行代码,最终如下:

# -*- coding:utf-8 -*-from fastapi import FastAPI 
from starlette.middleware.cors import CORSMiddleware  #引入 CORS中间件模块#创建一个FastApi实例
app = FastAPI()#设置允许访问的域名
origins = ["http://127.0.0.1"]  #也可以设置为"*",即为所有。#设置跨域传参
app.add_middleware(
    CORSMiddleware, 
    allow_origins=origins,  #设置允许的origins来源
    allow_credentials=True,
    allow_methods=["*"],  # 设置允许跨域的http方法,比如 get、post、put等。
    allow_headers=["*"])  #允许跨域的headers,可以用来鉴别来源等作用。#创建访问路径,下面的函数用来处理"/"的GET请求
@app.get("/")
def read_root():
    return {"Hello": "Api"}
​
@app.get("/hello/{name}")
def hello(name):
    res = {}
    res['name'] = name
    return res
​
@app.get("/zhiliao")
def read_args(name:str, age:int):
    return {"name": name, "age":age }

我们刷新浏览器:
性能是Flask的3倍!比PHP7还快!这个Python框架你值得拥有!(附使用教程)_第15张图片
跨域传参成功,获取数据成功。

那么,介绍到这里就结束了,相信有了python+fastapi的加持,python在web领域又多了一席之地。也希望,fastapi成为你的得力工具。

你可能感兴趣的:(编程)