了解了HTTP協議和HTML文檔,我們其實就明白了一個Web應用的本質就是:
1. 瀏覽器發送一個HTTP請求;
2. 服務器收到請求,生成一個HTML文檔;
3. 服務器把HTML文檔作為HTTP響應的Body發送給瀏覽器;
4. 瀏覽器收到HTTP響應,從HTTP Body取出HTML文檔并顯示。
所以,最簡單的Web應用就是先把HTML用文件保存好,用一個現成的HTTP服務器軟件,接收用戶請求,從文件中讀取HTML,返回。Apache、Nginx、Lighttpd等這些常見的靜態服務器就是干這件事情的。
如果要動態生成HTML,就需要把上述步驟自己來實現。不過,接受HTTP請求、解析HTTP請求、發送HTTP響應都是苦力活,如果我們自己來寫這些底層代碼,還沒開始寫動態HTML呢,就得花個把月去讀HTTP規范。
正確的做法是底層代碼由專門的服務器軟件實現,我們用Python專注于生成HTML文檔。因為我們不希望接觸到TCP連接、HTTP原始請求和響應格式,所以,需要一個統一的接口,讓我們專心用Python編寫Web業務。
這個接口就是WSGI:Web Server Gateway Interface。
WSGI接口定義非常簡單,它只要求Web開發者實現一個函數,就可以響應HTTP請求。我們來看一個最簡單的Web版本的“Hello, web!”:
~~~
def application(environ, start_response):
start_response('200 OK', [('Content-Type', 'text/html')])
return [b'<h1>Hello, web!</h1>']
~~~
上面的`application()`函數就是符合WSGI標準的一個HTTP處理函數,它接收兩個參數:
* environ:一個包含所有HTTP請求信息的`dict`對象;
* start_response:一個發送HTTP響應的函數。
在`application()`函數中,調用:
~~~
start_response('200 OK', [('Content-Type', 'text/html')])
~~~
就發送了HTTP響應的Header,注意Header只能發送一次,也就是只能調用一次`start_response()`函數。`start_response()`函數接收兩個參數,一個是HTTP響應碼,一個是一組`list`表示的HTTP Header,每個Header用一個包含兩個`str`的`tuple`表示。
通常情況下,都應該把`Content-Type`頭發送給瀏覽器。其他很多常用的HTTP Header也應該發送。
然后,函數的返回值`b'Hello, web!'`將作為HTTP響應的Body發送給瀏覽器。
有了WSGI,我們關心的就是如何從`environ`這個`dict`對象拿到HTTP請求信息,然后構造HTML,通過`start_response()`發送Header,最后返回Body。
整個`application()`函數本身沒有涉及到任何解析HTTP的部分,也就是說,底層代碼不需要我們自己編寫,我們只負責在更高層次上考慮如何響應請求就可以了。
不過,等等,這個`application()`函數怎么調用?如果我們自己調用,兩個參數`environ`和`start_response`我們沒法提供,返回的`bytes`也沒法發給瀏覽器。
所以`application()`函數必須由WSGI服務器來調用。有很多符合WSGI規范的服務器,我們可以挑選一個來用。但是現在,我們只想盡快測試一下我們編寫的`application()`函數真的可以把HTML輸出到瀏覽器,所以,要趕緊找一個最簡單的WSGI服務器,把我們的Web應用程序跑起來。
好消息是Python內置了一個WSGI服務器,這個模塊叫wsgiref,它是用純Python編寫的WSGI服務器的參考實現。所謂“參考實現”是指該實現完全符合WSGI標準,但是不考慮任何運行效率,僅供開發和測試使用。
### 運行WSGI服務
我們先編寫`hello.py`,實現Web應用程序的WSGI處理函數:
~~~
# 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()`函數:
~~~
# server.py
# 從wsgiref模塊導入:
from wsgiref.simple_server import make_server
# 導入我們自己編寫的application函數:
from hello import application
# 創建一個服務器,IP地址為空,端口是8000,處理函數是application:
httpd = make_server('', 8000, application)
print('Serving HTTP on port 8000...')
# 開始監聽HTTP請求:
httpd.serve_forever()
~~~
確保以上兩個文件在同一個目錄下,然后在命令行輸入`python server.py`來啟動WSGI服務器:

注意:如果`8000`端口已被其他程序占用,啟動將失敗,請修改成其他端口。
啟動成功后,打開瀏覽器,輸入`http://localhost:8000/`,就可以看到結果了:

在命令行可以看到wsgiref打印的log信息:

按`Ctrl+C`終止服務器。
如果你覺得這個Web應用太簡單了,可以稍微改造一下,從`environ`里讀取`PATH_INFO`,這樣可以顯示更加動態的內容:
~~~
# 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!`:

是不是有點Web App的感覺了?
### 小結
無論多么復雜的Web應用程序,入口都是一個WSGI處理函數。HTTP請求的所有輸入信息都可以通過`environ`獲得,HTTP響應的輸出都可以通過`start_response()`加上函數返回值作為Body。
復雜的Web應用程序,光靠一個WSGI函數來處理還是太底層了,我們需要在WSGI之上再抽象出Web框架,進一步簡化Web開發。
### 參考源碼
[hello.py](https://github.com/michaelliao/learn-python3/blob/master/samples/web/hello.py)
[do_wsgi.py](https://github.com/michaelliao/learn-python3/blob/master/samples/web/do_wsgi.py)
- 關于
- Python簡介
- 安裝Python
- Python解釋器
- 第一個Python程序
- 使用文本編輯器
- Python代碼運行助手
- 輸入和輸出
- Python基礎
- 數據類型和變量
- 字符串和編碼
- 使用list和tuple
- 條件判斷
- 循環
- 使用dict和set
- 函數
- 調用函數
- 定義函數
- 函數的參數
- 遞歸函數
- 高級特性
- 切片
- 迭代
- 列表生成式
- 生成器
- 迭代器
- 函數式編程
- 高階函數
- 返回函數
- 匿名函數
- 裝飾器
- 偏函數
- 模塊
- 使用模塊
- 安裝第三方模塊
- 面向對象編程
- 類和實例
- 訪問限制
- 繼承和多態
- 獲取對象信息
- 實例屬性和類屬性
- 面向對象高級編程
- 使用slots
- 使用@property
- 多重繼承
- 定制類
- 使用枚舉類
- 使用元類
- 錯誤、調試和測試
- 錯誤處理
- 調試
- 單元測試
- 文檔測試
- IO編程
- 文件讀寫
- StringIO和BytesIO
- 操作文件和目錄
- 序列化
- 進程和線程
- 多進程
- 多線程
- ThreadLocal
- 進程 vs. 線程
- 分布式進程
- 正則表達式
- 常用內建模塊
- datetime
- collections
- base64
- struct
- hashlib
- itertools
- XML
- HTMLParser
- urllib
- 常用第三方模塊
- PIL
- virtualenv
- 圖形界面
- 網絡編程
- TCP/IP簡介
- TCP編程
- UDP編程
- 電子郵件
- SMTP發送郵件
- POP3收取郵件
- 訪問數據庫
- 使用SQLite
- 使用MySQL
- 使用SQLAlchemy
- Web開發
- HTTP協議簡介
- HTML簡介
- WSGI接口
- 使用Web框架
- 使用模板
- 異步IO
- 協程
- asyncio
- aiohttp
- 實戰
- Day 1 - 搭建開發環境
- Day 2 - 編寫Web App骨架
- Day 3 - 編寫ORM
- Day 4 - 編寫Model
- Day 5 - 編寫Web框架
- Day 6 - 編寫配置文件
- Day 7 - 編寫MVC
- Day 8 - 構建前端
- Day 9 - 編寫API
- Day 10 - 用戶注冊和登錄
- Day 11 - 編寫日志創建頁
- Day 12 - 編寫日志列表頁
- Day 13 - 提升開發效率
- Day 14 - 完成Web App
- Day 15 - 部署Web App
- Day 16 - 編寫移動App
- FAQ
- 期末總結