浏览代码

Fixed #24460 -- Extended HttpRequest.build_absolute_uri documentation

Added explanation on why build_absolute_uri always enforces the
request's scheme.
Rik 10 年之前
父节点
当前提交
794c3f74c3
共有 1 个文件被更改,包括 8 次插入0 次删除
  1. 8 0
      docs/ref/request-response.txt

+ 8 - 0
docs/ref/request-response.txt

@@ -249,6 +249,14 @@ Methods
 
     Example: ``"http://example.com/music/bands/the_beatles/?print=true"``
 
+    .. note::
+
+        Mixing HTTP and HTTPS on the same site is discouraged, therefore
+        :meth:`~HttpRequest.build_absolute_uri()` will always generate an
+        absolute URI with the same scheme the current request has. If you need
+        to redirect users to HTTPS, it's best to let your webserver redirect
+        all HTTP traffic to HTTPS.
+
 .. method:: HttpRequest.get_signed_cookie(key, default=RAISE_ERROR, salt='', max_age=None)
 
     Returns a cookie value for a signed cookie, or raises a