会话（Session）

---

Django的 Session 框架

由于存在的限制与安全漏洞，cookies和持续性会话已经成为Web开发
的隐患，Django自带的session框架会帮你搞定这些问题，你可以用session 框架来存取每个访问者任意数据， 这些数据在服务器端存储，并对cookie的收发进行了抽象。 Cookies只存储数据的哈希会话ID，而不是数据本身，从而避免了大部分的常见cookie问题。

---

开启Sessions功能

Sessions 功能是通过一个中间件和一个模型来实现的。 要打开sessions功能，需要以下几步操作：

• 确保 MIDDLEWARE_CLASSES 中包含 'django.contrib.sessions.middleware.SessionMiddleware'。

• 确保 INSTALLED_APPS 中有 'django.contrib.sessions' (如果你是刚打开这个应用，别忘记同步数据库 )

正常情况下，你无需任何设置就可以使用session功能。

---

在视图中使用Session

SessionMiddleware 激活后，每个传给视图(view)函数的第一个参数HttpRequest对象都有一个 session 属性，这是一个字典型的对象。 你可以象用普通字典一样来用它：

# Set a session value:
request.session["fav_color"] = "blue"

# Get a session value -- this could be called in a different view,
# or many requests later (or both):
fav_color = request.session["fav_color"]

# Clear an item from the session:
del request.session["fav_color"]

# Check if the session has a given key:
if "fav_color" in request.session:

其他的映射方法，如 keys() 和 items() 对 request.session 同样有效

字典的keys() values() items()方法

字典的items(), keys(), values()都返回一个list
dict = { 1 : 2, 'a' : 'b', 'hello' : 'world' }  
dict.values()  
['b', 2, 'world']  
dict.keys()  
['a', 1, 'hello']  
dict.items()  
[('a', 'b'), (1, 2), ('hello', 'world')]  

用正常的字符串作为key来访问字典 request.session ， 而不是整数、对象或其它什么的。Session字典中以下划线开头的key值是Django内部保留key值

看一个简单的例子：在用户发了一次评论后将has_commented设置为True。 这是个简单（但不很安全）的、防止用户多次评论的方法。

def post_comment(request):
    if request.method != 'POST':
        raise Http404('Only POSTs are allowed')
    if 'comment' not in request.POST:
        raise Http404('Comment not submitted')
    if request.session.get('has_commented', False):
        return HttpResponse("You've already commented.")

    c = comments.Comment(comment=request.POST['comment'])
    c.save()
    request.session['has_commented'] = True
    return HttpResponse('Thanks for your comment!')

一个很简单的站点登录视图(view):在实践中，这是很烂的用户登录方式，稍后讨论的认证(authentication )框架会帮你以更健壮和有利的方式来处理这些问题。 这些非常简单的例子只是想让你知道这一切是如何工作的。

def login(request):
    if request.method != 'POST':
        raise Http404('Only POSTs are allowed')
    try:
        m = Member.objects.get(username=request.POST['username'])
        if m.password == request.POST['password']:
            request.session['member_id'] = m.id
            return HttpResponseRedirect('/you-are-logged-in/')
    except Member.DoesNotExist:
        return HttpResponse("Your username and password didn't match.")
def logout(request):
    try:
        del request.session['member_id']
    except KeyError:
        pass
    return HttpResponse("You're logged out.")

---

设置测试Cookies

你不能指望所有的浏览器都可以接受cookie。 因此，为了使用方便，Django提供了一个简单的方法来测试用户的浏览器是否接受cookie。 你只需在视图(view)中调用 request.session.set_test_cookie()
，并在后续的视图(view)，而不是当前的视图(view)中检查 request.session.test_cookie_worked()

def login(request):

    # If we submitted the form...
    if request.method == 'POST':

        # Check that the test cookie worked (we set it below):
        if request.session.test_cookie_worked():

            # The test cookie worked, so delete it.
            request.session.delete_test_cookie()

            # In practice, we'd need some logic to check username/password
            # here, but since this is an example...
            return HttpResponse("You're logged in.")

        # The test cookie failed, so display an error message. If this
        # were a real site, we'd want to display a friendlier message.
        else:
            return HttpResponse("Please enable cookies and try again.")

    # If we didn't post, send the test cookie along with the login form.
    request.session.set_test_cookie()
    return render_to_response('foo/login_form.html')

---

Django Session工作原理：

下面是一些关于session框架内部工作方式的技术细节：

• session 字典接受任何支持序列化的Python对象。 参考Python内建模块pickle的文档以获取更多信息。

• Session 数据存在数据库表 django_session 中

• Session 数据在需要的时候才会读取。 如果你从不使用 request.session ， Django不会动相关数据库表的一根毛。

• Django 只在需要的时候才送出cookie。 如果你压根儿就没有设置任何会话数据，它不会 送出会话cookie(除非 SESSION_SAVE_EVERY_REQUEST 设置为 True )。

• Django session 框架完全而且只能基于cookie。 它不会后退到把会话ID编码在URL中（像某些工具(PHP,JSP)那样）。这是一个有意而为之的设计。 把session放在URL中不只是难看，更重要的是这让你的站点 很容易受到攻击（通过 Referer header进行session ID”窃听”而实施的攻击）

如果你还是好奇，阅读源代码是最直接办法，django.contrib.sessions 。

---

在视图(View)外使用Session：

from django.contrib.sessions.models import Session
s = Session.objects.get(pk='2b1189a188b44ad18c35e113ac6ceead')
s.expire_date
datetime.datetime(2005, 8, 20, 13, 35, 12)

s.session_data
'KGRwMQpTJ19hdXRoX3VzZXJfaWQnCnAyCkkxCnMuMTExY2ZjODI2Yj...'
s.get_decoded()  #需要使用get_decoded() 来读取实际的session数据，因为字典存储为一种特定的编码格式
{'user_id': 42}

---

何时保存Session:

缺省的情况下，Django只会在session发生变化的时候才会存入数据库，比如说，字典赋值或删除。你可以设置 SESSION_SAVE_EVERY_REQUEST 为 True 来改变这一缺省行为。Django会在每次收到请求的时候保存session，即使没发生变化。
会话cookie只会在创建和修改的时候才会送出。 但如果 SESSION_SAVE_EVERY_REQUEST 设置为 True ，会话cookie在每次请求的时候都会送出。 同时，每次会话cookie送出的时候，其 expires 参数都会更新。

---

浏览器关闭即失效会话 vs 持久会话:

缺省情况下， SESSION_EXPIRE_AT_BROWSER_CLOSE 设置为 False ，这样，会话cookie可以在用户浏览器中保持有效达 SESSION_COOKIE_AGE 秒（缺省设置是两周）。 如果你不想用户每次打开浏览器都必须重新登陆的话，用这个参数来帮你。
如果 SESSION_EXPIRE_AT_BROWSER_CLOSE 设置为 True ，当浏览器关闭时，Django会使cookie失效。

影响cookie行为的设置:

设置	缺省值	描述
SESSION_COOKIE_DOMAIN	使用会话cookie（session cookies）的站点。 将它设成一个字符串，就好象“.example.com” 以用于跨站点（cross-domain）的cookie，或None 以用于单个站点。	None
SESSION_COOKIE_NAME	会话中使用的cookie的名字。 它可以是任意的字符串	"sessionid"
SESSION_COOKIE_SECURE	是否在session中使用安全cookie。 如果设置 True , cookie就会标记为安全， 这意味着cookie只会通过HTTPS来传输。	False