摘要：快速開始在安裝之前在支持異步的過程中，都經歷了哪些比較重大的更新。踏出第一步我們將正式使用來構建一個項目，讓我們踏出第一步，利用來編寫一個返回字符串的服務程序。本次示例的源代碼全部在上，見。

在安裝Sanic之前，讓我們一起來看看Python在支持異步的過程中，都經歷了哪些比較重大的更新。

首先是Python3.4版本引入了asyncio，這讓Python有了支持異步IO的標準庫，而后3.5版本又提供了兩個新的關鍵字 async/await，目的是為了更好地標識異步IO，讓異步編程看起來更加友好，最后3.6版本更進一步，推出了穩定版的asyncio，從這一系列的更新可以看出，Python社區正邁著堅定且穩重的步伐向異步編程靠近。

Sanic是一個支持 async/await 語法的異步無阻塞框架，這意味著我們可以依靠其處理異步請求的新特性來提升服務性能，如果你有Flask框架的使用經驗，那么你可以迅速地使用Sanic來構建出心中想要的應用，并且性能會提升不少，我將同一服務分別用Flask和Sanic編寫，再將壓測的結果進行對比，發現Sanic編寫的服務大概是Falsk的1.5倍。

僅僅是Sanic的異步特性就讓它的速度得到這么大的提升么？是的，但這個答案并不標準，更為關鍵的是Sanic使用了uvloop作為asyncio的事件循環，uvloop由Cython編寫，它的出現讓asyncio更快，快到什么程度？這篇文章中有介紹，其中提出速度至少比 nodejs、gevent 和其他Python異步框架要快兩倍，并且性能接近于用Go編寫的程序，順便一提，Sanic的作者就是受這篇文章影響，這才有了Sanic。

怎么樣？有沒有激起你學習Sanic的興趣，如果有，就讓我們一起開始學習吧，在開始之前，你只需要有一臺安裝了Python的電腦即可。

說明：由于Windows下暫不支持安裝uvloop，故在此建議使用Mac或Linux

程序世界一部分是對應著現實的，在生活中，我們會在不同的環境完成不同的任務，比如在廚房做飯、臥室休息，分工極其明確。

其實用Python編寫應用服務也是如此，它們同樣希望應用服務與開發環境是一對一的關系，這樣做的好處在于，每個獨立的環境都可以簡潔高效地管理自身對應服務所依賴的第三方庫，如若不然，各個服務都安排在同一環境，這樣不僅會造成管理上的麻煩，還會使第三方庫之間產生沖突。

通過上面的敘述，我們是不是可以得出這樣一個核心觀點：應該在不同的環境下做不同的事 ，以此類推，寫項目的時候，我們也需要為每個不同的項目構建一個無干擾的的環境，發散思維，總結一下：

不同的項目，需要為其構建不同的虛擬環境，以免互相干擾

構建虛擬環境的工具很多，如下：

virtualenv

pyenv

anaconda

…...

以上三個工具都可以快速地幫助我們構建當前需要的Python環境，如果你之前沒有使用過，可直接點開鏈接進行下載，如果你正在使用其它的環境管理工具，也不要緊，因為不論你使用哪一種方式，我們最終目的都是針對一個新項目構建一個新的環境。

安裝配置好之后，簡單看看官方提供的使用方法，就可以開始了，比如我本機使用的是anaconda ，安裝完成后可以很方便地創建一個虛擬環境，比如這里使用Python3.6來作為本書項目的默認環境：

# 新建一個python3.6環境
conda create --name python36 python=3.6
# 安裝好之后 輸入下面命令進入名為python36的環境
source activate python36

若安裝速度比較慢，可以考慮換國內源，比如 國內鏡像 ，至于為什么選擇python3.6作為默認環境，一是因為Sanic只支持Python3.5+，二則是我們構建的項目最終是要在生產環境下運行的，所以建議最好安裝Python3.6下穩定版本的asyncio。

Python安裝第三方模塊都是利用pip工具進行安裝，這里也不例外，首先進入上一步我們新建的 python3.6 虛擬環境，然后安裝：

# 安裝Sanic，請先使用 source activate python36 進入虛擬環境
pip install sanic
# 如果不想使用uvloop和ujson 可以這樣安裝
SANIC_NO_UVLOOP=true SANIC_NO_UJSON=true pip install sanic

通過上面的命令，你就可以在 python3.6 虛擬環境中安裝Sanic以及其依賴的第三方庫了，若想查看Sanic是否已經正確安裝，可以進入終端下對應的虛擬環境，啟動Python解釋器，導入Sanic庫：

# 啟動Python解釋器
python
>>> import sanic
>>>

如果沒有出現錯誤，就說明你已經正確地安裝了Sanic，請繼續閱讀下一節，了解下如何利用Sanic來構建一個Web項目吧。

我們將正式使用Sanic來構建一個web項目，讓我們踏出第一步，利用Sanic來編寫一個返回Hello World!字符串的服務程序。

新建一個文件，名為 run.py :

#!/usr/bin/env python
from sanic import Sanic
from sanic.response import text

app = Sanic()


@app.route("/")
async def test(request):
    return text("Hello World!")


if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

Sanic的目標是讓編寫服務更加簡單易用，請看上面僅用不到10行的代碼，就編寫好了一個簡單的Web服務，運行此文件，在瀏覽器輸入 http://0.0.0.0:8000 ，出現的字符會讓你回想起當年學c的恐懼^_^。

如果你是第一次使用Sanic，上面的代碼可能會讓你產生一些困擾，不用擔心，接下來，我們將一起用Sanic編寫一個簡單的資訊閱讀的web服務，在這過程中，你將逐漸地了解到Sanic的一些基本用法，如路由的構建、接受請求數據以及返回響應的內容等。

本次示例的源代碼全部在github上，見examples/demo01/news.py。

在開始編寫之前，第一步最好寫一下需求，哪怕是個簡單不過的玩具項目也不能略過這個步驟，比如現在編寫的資訊閱讀項目，需求就一個，在頁面中展示一些資訊新聞。

既然是展示資訊新聞，那么解決數據來源的問題最為重要，對于這個問題你也不用擔心，因為在本次示例的源碼中我編寫了一個名為get_news()的函數專門用來返回資訊新聞數據，簡化代碼如下:

async def get_news(size=10):
    """
    Sanic是一個異步框架，為了更好的發揮它的性能，有些操作最好也要用異步的
    比如這里發起請求就必須要用異步請求框架aiohttp
    所以使用本服務的時候請先執行: pip install aiohttp
    數據使用的是readhub網站的api接口
    為了使這個數據獲取函數正常運行，我會保持更新，所以具體代碼：examples/demo01/news.py
    """
    async with aiohttp.ClientSession() as client:
        async with client.get(readhub_api, params=params, headers=headers) as response:
            assert response.status == 200
            text = await response.json()
        return text

這樣各位就可以只專注于Sanic的代碼實現，而不必考慮其他問題，我會一直維護這個數據獲取函數，以保證數據正常輸出，各位請放心使用。

數據的問題解決之后，我們可以開始著手于需求的實現了，根據前面的描述，此時的需求是當客戶端（Web瀏覽器）訪問http://0.0.0.0:8000/的時候，瀏覽器會立馬展示服務端響應返回的10條資訊新聞（假設內容由index()函數返回），若瀏覽器訪問的是http://0.0.0.0:8000/2，此時返回的就是第二頁的10條資訊新聞，以此類推......

當Sanic程序實例接收到一個請求，比如前面提到的http://0.0.0.0:8000/，它是怎么知道這個URL可以對應到index()函數呢？

Sanic有一個機制來保存URL和函數（一般稱之為視圖函數）之間的映射關系，就像dict中key和value，這樣當服務端接收到請求http://0.0.0.0:8000/，就會立馬知道，接下來需要調用index()函數了，我們將其稱之為路由。

Sanic中可以用app.route修飾器來定義路由，當Sanic服務啟動的時候，app.route就會將其中傳入的參數與裝飾的函數自動注冊好，比如下面這段代碼：

@app.route("/")
async def index(request):
    """當服務端接收到客戶端的/請求時，就會調用此函數"""
    return text("Hello World!")

此時請求http://0.0.0.0:8000/就會返回Hello World!，很顯然，這不是我們想要的需求，我們的需求是展示10條資訊新聞，數據怎么來？你只需要調用get_news()函數，就會獲取到你想要的資訊數據：

@app.route("/")
async def index(request):
    # html頁面模板
    html_tem = """
    

        
{title}
        
{summary}
         
{updated_at}
    
    """
    html_list = []
    # 獲取數據
    all_news = await get_news()
    # 生成在瀏覽器展示的html頁面
    for each_news in all_news:
        html_list.append(html_tem.format(
            href=each_news.get("news_info", [{}])[0].get("url", "#"),
            title=each_news.get("title"),
            summary=each_news.get("summary"),
            updated_at=each_news.get("updated_at"),
        ))

    return html("
".join(html_list))

運行此服務：

python run news.py

此時，訪問http://0.0.0.0:8000/，你就會獲得Sanic服務程序返回的資訊新聞，如下圖，可以看到返回服務端提供的最新資訊：

頁面成功地呈現出我們想要的結果，實在是令人興奮，等等，不能高興太早，我們還有一個需求，要根據瀏覽器輸入的頁數來展示內容，如：http://0.0.0.0:8000/2，思考一下，應該怎樣優雅地完成這個需求，或許你會想，再構建一對URL與視圖函數的映射關系，像下面這樣：

@app.route("/2")
async def page_2(request):

不得不說，這是一個糟糕的解決方案，這樣沒法解決接下來的第3頁、第4頁、甚至第n頁（雖然目前這個服務程序只展示到第2頁），最佳實踐應該是把頁數當做變量來獲取，Sanic的路由機制自然提供了獲取動態請求參數的功能，如下：

@app.route("/")
@app.route("/")
async def index(request, page=1):
    """
    支持/請求與/page請求方式
    具體的代碼邏輯也會有一點改變，可參考：examples/demo01/news.py
    """

再次運行此服務：

python run news.py

不論是請求http://0.0.0.0:8000/或者http://0.0.0.0:8000/2，都是我們想要的結果。

細心的你可能會發現，每次編寫一個視圖函數的時候，總是有一個request參數：

async def index(request, page=1):

為什么必須定義這個參數，它從哪來？它有什么作用，下面我將一一為你解答。

如果你在客戶端請求http://0.0.0.0:8000/的時候，順手在視圖函數里面打印下參數request，會有如下輸出：

看終端的輸出可以了解到request參數實際上是一個名為Request的實例對象，每當服務端接收到一個請求，Sanic的handle_request函數必定會接收一個Request實例對象，這個實例對象包含了一系列請求信息。

前面說到，每個URL對應一個視圖函數，而Sanic的handle_request接下來會將接收的Request實例對象作為參數傳給URL對應的視圖函數，也就是上面index的request參數，這樣一來，就必須定義request來接收Request實例對象，其中包含的一些請求信息對視圖函數來說非常重要，目前Request對象提供了以下屬性：

json

token

form

files

args

raw_args

cookies

ip

port

socket

remote_addr

path

url

上面只是列出了一部分屬性，如果你想了解更多，可查看request.py源碼文件了解。

為了可以實際使用下request，我們可以再加一個需求，比如增加一個GET請求的接口http://0.0.0.0:8000/json，如果請求不設置參數nums的值，則默認返回一條資訊新聞，如果設置了nums參數，則該接口返回的新聞數量由參數值決定，參數最大值為10：

@app.route("/json")
async def index_json(request):
    """
    默認返回一條資訊，最多十條
    """
    nums = request.args.get("nums", 1)
    # 獲取數據
    all_news = await get_news()
    try:
        return json(random.sample(all_news, int(nums)))
    except ValueError:
        return json(all_news)

運行此服務：

python run news.py

此時視圖函數index_json就可以根據接受的參數nums來返回對應數量的新聞，訪問http://0.0.0.0:8000/json?nums=2，效果如下：

不論哪個Web框架，都是需要構建響應對象的，Sanic自然也不例外，它用的是sanic.response來構建響應對象，像上面的代碼中可以看到：

from sanic.response import html, json

這表示我們目前構建的資訊閱讀服務，分別返回了body格式為html以及json的響應對象，除了這兩種格式，Sanic還提供了下面幾種格式：

json

text

raw

html

file

file_stream

stream

更多屬性請看response.py，我們可以根據實際需求來構建響應對象，最后再返回給客戶端。

不要以為現在編寫的資訊服務已經很完善了，其實還有許多問題需要我們解決，比如訪問http://0.0.0.0:8000/html這個URL會返回：

Error: Requested URL /html not found

服務程序為什么會拋出這個錯誤？因為程序中并路由沒有注冊html，并且沒有進行錯誤捕捉（比如此時的404），解決這個問題也很方便，比如把這個錯誤全部跳轉到首頁，代碼如下：

@app.exception(NotFound)
def ignore_404s(request, exception):
    return redirect("/")

此時訪問一些沒有注冊于路由的URL，比如此時的http://0.0.0.0:8000/html都會自動跳轉到http://0.0.0.0:8000/。

現在，我們已經用Sanic編寫了一個簡單的資訊閱讀服務，在編寫的過程中使用了路由、數據請求、處理以及響應對象，這些基礎知識足夠你編寫一些基本的服務，但這還遠遠不夠，比如模板引、引入靜態文件等，這些都等著我們在實踐中繼續深入了解。

本章介紹了Sanic的安裝以及基本的使用，目標是希望諸位可以迅速的了解并掌握Sanic的基本使用方法，并為閱讀接下來的章節打一下基礎。

文檔以及代碼：

Sanic github地址：https://github.com/channelcat...

官方教程：http://sanic.readthedocs.io/e...

demo地址：demo01