什么是中間件

我們從一個簡單的例子開始。

高流量的站點通常需要將Django部署在負載平衡proxy之后。 這種方式將帶來一些復雜性，其一就是每個request中的遠程IP地址(request.META["REMOTE_IP"])將指向該負載平衡proxy，而不是發起這個request的實際IP。 負載平衡proxy處理這個問題的方法在特殊的 X-Forwarded-For 中設置實際發起請求的IP。

因此，需要一個小小的中間件來確保運行在proxy之后的站點也能夠在 request.META["REMOTE_ADDR"] 中得到正確的IP地址：

            
class SetRemoteAddrFromForwardedFor(object):
  def process_request(self, request):
    try:
      real_ip = request.META['HTTP_X_FORWARDED_FOR']
    except KeyError:
      pass
    else:
      # HTTP_X_FORWARDED_FOR can be a comma-separated list of IPs.
      # Take just the first one.
      real_ip = real_ip.split(",")[0]
      request.META['REMOTE_ADDR'] = real_ip


          

            
(Note: Although the HTTP header is called X-Forwarded-For , Django makes it available as request.META['HTTP_X_FORWARDED_FOR'] . With the exception of content-length and content-type , any HTTP headers in the request are converted to request.META keys by converting all characters to uppercase, replacing any hyphens with underscores and adding an HTTP_ prefix to the name.)


          

一旦安裝了該中間件(參見下一節)，每個request中的 X-Forwarded-For 值都會被自動插入到 request.META['REMOTE_ADDR'] 中。這樣，Django應用就不需要關心自己是否位于負載平衡proxy之后；簡單讀取 request.META['REMOTE_ADDR'] 的方式在是否有proxy的情形下都將正常工作。

實際上，為針對這個非常常見的情形，Django已將該中間件內置。 它位于 django.middleware.http 中, 下一節將給出這個中間件相關的更多細節。
安裝中間件

要啟用一個中間件，只需將其添加到配置模塊的 MIDDLEWARE_CLASSES 元組中。 在 MIDDLEWARE_CLASSES 中，中間件組件用字符串表示： 指向中間件類名的完整Python路徑。 例如，下面是 django-admin.py startproject 創建的缺省 MIDDLEWARE_CLASSES :

            
MIDDLEWARE_CLASSES = (
  'django.middleware.common.CommonMiddleware',
  'django.contrib.sessions.middleware.SessionMiddleware',
  'django.contrib.auth.middleware.AuthenticationMiddleware',
)


          

Django項目的安裝并不強制要求任何中間件，如果你愿意， MIDDLEWARE_CLASSES 可以為空。

這里中間件出現的順序非常重要。 在request和view的處理階段，Django按照 MIDDLEWARE_CLASSES 中出現的順序來應用中間件，而在response和異常處理階段，Django則按逆序來調用它們。 也就是說，Django將 MIDDLEWARE_CLASSES 視為view函數外層的順序包裝子： 在request階段按順序從上到下穿過，而在response則反過來。