异步服务网关接口（Asynchronous Server Gateway Interface，ASGI）秉承WSGI统一网关接口原则，在异步服务、框架和应用之间提供一个标准接口，同时兼容WSGI。

01、ASGI

ASGI是根据统一接口的思想重新设计的新标准，你可能会有疑问，为什么不直接升级WSGI而去创造新的标准呢?

WSGI是基于HTTP短连接的网关接口，一次调用请求必须尽快处理完毕并返回结果，这种模式并不适用于长连接，例如HTML 5新标准中的技术SSE(Server-Sent Events)和WebSocket，WSGI及传统阻塞型IO 编程模型并不擅长处理这类请求。就算强行升级WSGI以支持异步IO，可是如果配套的技术(如Apache服务器)没有提供相应的支持也是没有意义的。既然Python异步IO 编程模型已经走在了前面，那就制定一个全新的标准ASGI以最优雅的方式支持并使用最新的技术。

ASGI接口是一个异步函数，它要求传入3个参数，分别为 scope、receive和send，示例代码如下：

async def app(scope， receive， send)：
    pass

其中scope是一个字典(dict)，包括连接相关的信息，图1所示是一个请求中的scope所包括信息的断点调试截图。

receive是一个异步函数，用于读取前端发来的信息，一条读取到的信息结构如下：

{
    'type'：'http.request'，
    'body'：b""，
    'more_body'：False
}

该信息中包括3个字段，分别为类型(type)、内容(body)和是否还有更多内容(more_body)，其中通过type 可以用来判断该信息是什么类型，如HTTP 请求、生命周期、WebSocket请求等，body是该信息中包括的数据，此数据采用二进制格式，more_body指明当前数据是否已经发送完毕，如果发送完毕，则more_body的值为False，这样便可以用来分段传输大文件。

■ 图1  断点截图

 send也是一个异步函数，用于向前端发送信息，所发送的信息结构与从前端接收的信息结构类似。一个向前端发送简单信息的示例代码如下：

async def app(scope， receive， send)：
#向前端发送HTTP协议头，包括了HTTP状态与协议头
    await send({
        'type'：'http.response.start'，
        'status'：200，
        'headers'：[
            [b'content-type'， b'text/html']，
        ]
  })
#向前端发送数据，如果数据庞大，还可以分段发送
    await send({
        'type'：'http.response.body'，
        'body'：b"Hello World"，
        'more_body'：False
    })

除了常规数据通信外，ASGI 还规定了生命周期管理接口，可以用于侦听服务器的启动与关闭。在实际开发工作中，这非常有用，可以用来执行初始化工作与收尾工作，生命周期管理的运用代码如下：

async def app(scope， receive， send)：
    request_type = scope['type']
    if request_type == 'lifespan'：
        while True：
            message = await receive()
            if message['type'] == 'lifespan.startup'：
                await send({'type'：'lifespan.startup.complete'})
            elif message['type'] == 'lifespan.shutdown'：
                await send({'type'：'lifespan.shutdown.complete'})
                break

当scpoe[‘type’]的类型是lifespan时，意味着该请求的类型是生命周期，该请求会在服务器启动之初发生，接下来应该实现对生命周期的管理。

通过无限循环不断侦听请求状态的变化，当读到message[t’ ype’]是lifespan.startup时执行初始化操作，在操作完成后向前端(协议层)发送lifespan.startup.complete信息，协议层可理解为服务器已经启动完成，可以正常接受浏览器请求了。

当读到message[‘type’]是lifespan.shutdown时，意味服务要关闭，可能是由于服务器管理员执行了关闭指令，那么在这里就需要执行收尾工作，例如释放相应资源等。在收尾完成后向协议层发送lifespan.shutdown.complete信息，表明此时协议层可以放心地关闭服务器。

一个完整的基于ASGI的 Hello World 示例代码如下：

async def app(scope， receive， send)：
    request_type = scope['type']
    if request_type == 'http'：
        await send({
            'type'：'http.response.start'，
            'status'：200，
            'headers'：[
                [b'content-type'， b'text/html']，
            ]
        })
        await send({
            'type'：'http.response.body'，
            'body'：b"Hello World"，
            'more_body'：False
        })
    elif request_type == 'lifespan'：
        while True：
            message = await receive()
            if message['type'] == 'lifespan.startup'：
                await send({'type'：'lifespan.startup.complete'})
            elif message['type'] == 'lifespan.shutdown'：
                await send({'type'：'lifespan.shutdown.complete'})
                break
    else：
        raise NotImplementedError()

02、Uvicorn

Uvicorn是ASGI的一个协议层实现，一个轻量级的ASGI服务器，基于uvloop 和httptools实现，运行速度极快。

uvloop是一个高效的基于异步IO 的事件循环框架，底层实现由libuv承载。libuv是一个使用C语言开发的支持高并发的异步IO 库，由Node.js的作者开发，作为Node.js的底层IO 库实现，如今已经发展得相当成熟稳定。

要使用Uvicorn需要先通过命令pip install uvicorn安装该依赖项，项目结构如图2所示。

接下来在终端输入uvicorn asgi：app以启动该服务器，效果如图3所示

■ 图2  ASGI项目文件结构

 ■ 图3  启动ASGI服务器

服务器启动后，可使用浏览器通过http：//127.0.0.1：8000访问该站点，结果如图4所示。

为了向用户提供更加安全的服务，现代网站都需要支持HTTPS，Uvicorn 也提供了对HTTPS的支持，使用起来也相当方便。

首先准备好HTTPS证书文件，如图5所示。

■图4  页面访问结果

 ■ 图5 证书文件所在目录

接下来通过命令uvicorn–ssl-certfile ./ssl/cert.pem–ssl-keyfile ./ssl/cert.key asgi：app来启动该服务器，如图6所示。

■ 图6  以HTTPS方式启动服务器

容器化对应的 Dockerfile 文件内容如下：

FROM python：3-slim

RUN pip3 install -i https：//pypi.tuna.tsinghua.edu.cn/simple uvicorn

容器化对应的docker-compose.yml内容如下：

services：
  web：
    build：.
    restart：always
    tty：true
    ports：
      - "8000：8000"
    volumes：
      - ".：/opt/"
    working_dir："/opt/"
    command：uvicorn --host 0.0.0.0 asgi：app

 03、源码