了解了HTTP協(xié)議和HTML文檔养泡,我們其實就明白了一個Web應用的本質(zhì)就是:
瀏覽器發(fā)送一個HTTP請求;
服務器收到請求,生成一個HTML文檔;
服務器把HTML文檔作為HTTP響應的Body發(fā)送給瀏覽器较雕;
瀏覽器收到HTTP響應,從HTTP Body取出HTML文檔并顯示挚币。
所以亮蒋,最簡單的Web應用就是先把HTML用文件保存好,用一個現(xiàn)成的HTTP服務器軟件妆毕,接收用戶請求慎玖,從文件中讀取HTML,返回笛粘。Apache趁怔、Nginx湿硝、Lighttpd等這些常見的靜態(tài)服務器就是干這件事情的。
如果要動態(tài)生成HTML润努,就需要把上述步驟自己來實現(xiàn)关斜。不過,接受HTTP請求任连、解析HTTP請求蚤吹、發(fā)送HTTP響應都是苦力活例诀,如果我們自己來寫這些底層代碼随抠,還沒開始寫動態(tài)HTML呢,就得花個把月去讀HTTP規(guī)范繁涂。
正確的做法是底層代碼由專門的服務器軟件實現(xiàn)拱她,我們用Python專注于生成HTML文檔。因為我們不希望接觸到TCP連接扔罪、HTTP原始請求和響應格式秉沼,所以,需要一個統(tǒng)一的接口矿酵,讓我們專心用Python編寫Web業(yè)務唬复。
這個接口就是WSGI:Web Server Gateway Interface。
WSGI接口定義非常簡單全肮,它只要求Web開發(fā)者實現(xiàn)一個函數(shù)敞咧,就可以響應HTTP請求。我們來看一個最簡單的Web版本的“Hello, web!”:
def application(environ, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return [b'<h1>Hello, web!</h1>']
上面的application()函數(shù)就是符合WSGI標準的一個HTTP處理函數(shù)辜腺,它接收兩個參數(shù):
environ:一個包含所有HTTP請求信息的dict對象休建;
start_response:一個發(fā)送HTTP響應的函數(shù)。
在application()函數(shù)中评疗,調(diào)用:
start_response('200 OK', [('Content-Type', 'text/html')])
就發(fā)送了HTTP響應的Header测砂,注意Header只能發(fā)送一次,也就是只能調(diào)用一次start_response()函數(shù)百匆。start_response()函數(shù)接收兩個參數(shù)砌些,一個是HTTP響應碼,一個是一組list表示的HTTP Header加匈,每個Header用一個包含兩個str的tuple表示存璃。
通常情況下,都應該把Content-Type頭發(fā)送給瀏覽器矩动。其他很多常用的HTTP Header也應該發(fā)送有巧。
然后,函數(shù)的返回值b'<h1>Hello, web!</h1>'
將作為HTTP響應的Body發(fā)送給瀏覽器悲没。
有了WSGI篮迎,我們關心的就是如何從environ這個dict對象拿到HTTP請求信息男图,然后構造HTML,通過start_response()發(fā)送Header甜橱,最后返回Body逊笆。
整個application()函數(shù)本身沒有涉及到任何解析HTTP的部分,也就是說岂傲,底層代碼不需要我們自己編寫难裆,我們只負責在更高層次上考慮如何響應請求就可以了。
不過镊掖,等等乃戈,這個application()函數(shù)怎么調(diào)用?如果我們自己調(diào)用亩进,兩個參數(shù)environ和start_response我們沒法提供症虑,返回的bytes也沒法發(fā)給瀏覽器。
所以application()函數(shù)必須由WSGI服務器來調(diào)用归薛。有很多符合WSGI規(guī)范的服務器谍憔,我們可以挑選一個來用。但是現(xiàn)在主籍,我們只想盡快測試一下我們編寫的application()函數(shù)真的可以把HTML輸出到瀏覽器习贫,所以,要趕緊找一個最簡單的WSGI服務器千元,把我們的Web應用程序跑起來苫昌。
好消息是Python內(nèi)置了一個WSGI服務器,這個模塊叫wsgiref诅炉,它是用純Python編寫的WSGI服務器的參考實現(xiàn)蜡歹。所謂“參考實現(xiàn)”是指該實現(xiàn)完全符合WSGI標準,但是不考慮任何運行效率涕烧,僅供開發(fā)和測試使用月而。
運行WSGI服務
我們先編寫hello.py,實現(xiàn)Web應用程序的WSGI處理函數(shù):
# hello.py
def application(environ, start_response):
start_response('200 OK', [('Content-Type', 'text/html')])
return [b'<h1>Hello, web!</h1>']```
然后议纯,再編寫一個server.py父款,負責啟動WSGI服務器,加載application()函數(shù):
server.py
從wsgiref模塊導入:
from wsgiref.simple_server import make_server
導入我們自己編寫的application函數(shù):
from hello import application
創(chuàng)建一個服務器瞻凤,IP地址為空憨攒,端口是8000,處理函數(shù)是application:
httpd = make_server('', 8000, application)
print('Serving HTTP on port 8000...')
開始監(jiān)聽HTTP請求:
httpd.serve_forever()```
確保以上兩個文件在同一個目錄下阀参,然后在命令行輸入python server.py來啟動WSGI服務器:
啟動成功后肝集,打開瀏覽器,輸入http://localhost:8000/蛛壳,就可以看到結果了:
在命令行可以看到wsgiref打印的log信息:
按Ctrl+C終止服務器杏瞻。
如果你覺得這個Web應用太簡單了所刀,可以稍微改造一下,從environ里讀取PATH_INFO捞挥,這樣可以顯示更加動態(tài)的內(nèi)容:
# hello.py
def application(environ, start_response):
start_response('200 OK', [('Content-Type', 'text/html')])
body = '<h1>Hello, %s!</h1>' % (environ['PATH_INFO'][1:] or 'web')
return [body.encode('utf-8')]```
你可以在地址欄輸入用戶名作為URL的一部分浮创,將返回Hello, xxx!:
