在 Django 裡,Cookie 與 Session 的讀取方式看起來很像——request.COOKIES[XXX] 與 request.session[XXX],XXX 都是你要取的鍵。但兩者的底層機制完全不同,理解差別才能正確使用。
只要是 HTTP 協議就有 Cookie。只要瀏覽器沒有停用它,任何語言、任何框架都能使用,因為它是協議層級的支援:瀏覽器會把你設定的 Cookie 存在本機,之後每次向伺服器發送請求時自動帶上。
這裡要澄清一個觀念:B/S 架構在理論上並沒有「伺服器端與客戶端的狀態同步」機制,所以 Cookie 本質上是一種非同步的狀態維護手段——而這些細節瀏覽器都替我們處理好了。
無論 Django 最終採用哪種請求實作(WSGIRequest、ModPythonRequest 或自訂版本),它們都符合 HTTP 協議對 request 的要求。
要用 Django 的 Session,必須確認 settings.py 的 MIDDLEWARE_CLASSES 中含有 django.contrib.sessions.middleware.SessionMiddleware(預設就有)。接著看 middleware.py 裡的 process_request,核心只有一句:
request.session = SessionWrapper(request.COOKIES.get(settings.SESSION_COOKIE_NAME, None))
我們平時使用的 request.session 就在這一刻誕生,它其實是一個 SessionWrapper 物件,而生成它的依據是 Cookie 中名為 SESSION_COOKIE_NAME 的那筆值。
也就是說,Session 是依賴 Cookie 的。如果瀏覽器不支援 Cookie,Django 的 Session 也就無從建立。那麼這個 Cookie 是什麼時候被設定的?答案在 process_response:
def process_response(self, request, response):
# 若 session 被修改,就存檔並設定 session cookie
patch_vary_headers(response, ('Cookie',))
try:
modified = request.session.modified
except AttributeError:
pass
else:
if modified or settings.SESSION_SAVE_EVERY_REQUEST:
session_key = request.session.session_key or Session.objects.get_new_session_key()
if settings.SESSION_EXPIRE_AT_BROWSER_CLOSE:
max_age = None
expires = None
else:
max_age = settings.SESSION_COOKIE_AGE
expires = datetime.datetime.strftime(
datetime.datetime.utcnow() + datetime.timedelta(seconds=settings.SESSION_COOKIE_AGE),
"%a, %d-%b-%Y %H:%M:%S GMT")
new_session = Session.objects.save(
session_key, request.session._session,
datetime.datetime.now() + datetime.timedelta(seconds=settings.SESSION_COOKIE_AGE))
response.set_cookie(
settings.SESSION_COOKIE_NAME, session_key,
max_age=max_age, expires=expires,
domain=settings.SESSION_COOKIE_DOMAIN,
secure=settings.SESSION_COOKIE_SECURE or None)
return response
其中兩行最關鍵:session_key = request.session.session_key or Session.objects.get_new_session_key()——有現成的 key 就沿用,沒有就新建一個 Session 並取回它的 key;接著 response.set_cookie(settings.SESSION_COOKIE_NAME, session_key, ...) 把這個 key 寫進回應的 Cookie 裡。
第一次瀏覽一個 Django 網站時,process_request 拿不到 SESSION_COOKIE_NAME 這個 Cookie,於是 session 是空的;但在這次回應之後,Cookie 就出現了。此後每次請求,process_request 都會依 Cookie 裡記的 session_key 建立 SessionWrapper 實例——它本質上是對 Session 這個 Model 的封裝。我們寫入的 request.session[XXX] = ...,最終存進了資料庫中 Session 對應的資料表。
因為 Cookie 有兩個先天限制:容量很小,而且只能存字串。假設你想把一個自訂類別的實例塞進 request.COOKIES[XXX],這個物件根本無法被序列化送到客戶端。
Session 的解法很漂亮:客戶端的 Cookie 只保留一個 key,用來標明「伺服器上那筆資料屬於這個使用者」;真正的內容存在伺服器端,用字典結構保存,透過 pickle 序列化與還原,想存多少複雜結構都可以。這就是「狀態放在伺服器、識別碼放在客戶端」的經典分工。