maya-chen/flask
1
0
Fork 0
forked from orbit-oss/flask
Code Pull requests Activity

Improved cookie documentation

Browse source
This commit is contained in:
Armin Ronacher 2011-08-07 15:23:57 +02:00
parent ae00f6d149
commit 13005d76b9
1 changed files with 32 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

37
docs/quickstart.rst
View file

@ -588,11 +588,38 @@ For some better examples, checkout the :ref:`uploading-files` pattern.
Cookies Cookies
``````` ```````
To access cookies you can use the :attr:`~flask.request.cookies` To access cookies you can use the :attr:`~flask.Request.cookies`
attribute. Again this is a dictionary with all the cookies the client attribute. To set cookies you can use the
transmits. If you want to use sessions, do not use the cookies directly :attr:`~flask.Response.set_cookie` method of response objects. The
but instead use the :ref:`sessions` in Flask that add some security on top :attr:`~flask.Request.cookies` attribute of request objects is a
of cookies for you. dictionary with all the cookies the client transmits. If you want to use
sessions, do not use the cookies directly but instead use the
:ref:`sessions` in Flask that add some security on top of cookies for you.
Reading cookies::
from flask import request
@app.route('/')
def index():
username = request.cookies.get('username')
# use cookies.get(key) instead of cookies[key] to not get a
# KeyError if the cookie is missing.
Storing cookies::
from flask import make_response
@app.route('/')
def index():
resp = make_response(render_template(...))
resp.set_cookie('username', 'the username')
return resp
Note that cookies are set on response objects. Since you normally you
just return strings from the view functions Flask will convert them into
response objects for you. If you explicitly want to do that you can use
the :meth:`~flask.make_response` function and then modify it.
Redirects and Errors Redirects and Errors