mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-07-24 13:44:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Fixed #27053 -- Documented contrib.auth.get_user().

Browse source
This commit is contained in:
Berker Peksag 2016-08-24 12:21:28 +03:00 • committed by Tim Graham
parent 419b6ec7d0
commit f7e91cac68
2 changed files with 43 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

23
docs/ref/contrib/auth.txt
View file

@ -682,3 +682,26 @@ The following backends are available in :mod:`django.contrib.auth.backends`:
An :class:`~django.apps.AppConfig` for use if you :ref:`aren't using
<using-auth-without-models>` any of the built-in ``contrib.auth`` models.
Utility functions
=================
.. currentmodule:: django.contrib.auth
.. function:: get_user(request)
Returns the user model instance associated with the given ``request``’s
session.
It checks if the authentication backend stored in the session is present in
:setting:`AUTHENTICATION_BACKENDS`. If so, it uses the backend's
``get_user()`` method to retrieve the user model instance and then verifies
the session by calling the user model's
:meth:`~django.contrib.auth.models.AbstractBaseUser.get_session_auth_hash`
method.
Returns an instance of :class:`~django.contrib.auth.models.AnonymousUser`
if the authentication backend stored in the session is no longer in
:setting:`AUTHENTICATION_BACKENDS`, if a user isn't returned by the
backend's ``get_user()`` method, or if the session auth hash doesn't
validate.