Django用户验证系统的简单使用

简介

在使用django框架架构微信抢票系统时,助教要求我们使用django自带的用户验证系统对管理员进行管理操作。因为之前没有用过这一系统,所以我在查阅学习官方文档之后,写下这一篇博客,也方便大家参考和学习。

安装与配置

django的认证系统(Django authentication system)主要处理用户认证用户授权的任务,其中包含有很多内容(Users、Permissions、Groups等),本文只讲述Users的基本用法。

环境

  • python:3.6
  • django:1.9.5

安装配置

在项目的settings.py文件中做如下配置(若你使用 django-admin startproject命令建立项目,则以下配置就已经包含在settings.py文件中,无需额外添加):

  • INSTALLED_APPS中加入:
    1、'django.contrib.auth'
    2、'django.contrib.contenttypes'
  • MIDDLEWARE_CLASSES中加入:
    1、'django.contrib.sessions.middleware.SessionMiddleware'
    2、'django.contrib.auth.middleware.AuthenticationMiddleware'
    3、'django.contrib.auth.middleware.SessionAuthenticationMiddleware'

添加相关配置之后,使用python manage.py migrate命令即可创建用户管理必需的数据库表。

使用

User对象

User对象是用户管理系统的核心,它包含的基本属性有:

  • username:用户名(必须)
  • password:密码(必须)
  • email:电子邮箱(可选)
  • first_name:名(可选)
  • last_name:姓(可选)

导入User对象的命令为:

from django.contrib.auth.models import User

创建用户

最直接创建用户的方式就是使用create_user()函数:

>>> from django.contrib.auth.models import User
>>> user = User.objects.create_user('name','[email protected]','password')

#此时一个User对象已经被创建,你可以修改其属性并存入数据库
>>> user.last_name = 'Cheng'
>>> user.save()

当然,你也可以直接使用命令行创建一个超级用户:

$ python manage.py createsuperuser --username=name [email protected]

然后控制台会要求你输入密码,在你输入密码结束之后,一个用户就成功创建了。

修改密码

创建用户相对应,修改密码也有两种方式:
你可以直接使用set_password()函数:

>>> from django.contrib.auth.models import User
>>> user = User.objects.get(username='name')
>>> user.set_password('new password')
>>> user.save()

你也可以使用命令行修改密码:

$ python manage.py changepassword *username*

之后根据控制台的提示信息,进行密码修改即可。

用户验证

django使用sessionsmiddleware将验证系统与request objects挂钩。
你可以使用request.user属性来获取当前用户。若当前没有用户登录,则属性被设置为AnonymousUser,否则就是User的对象。
你可以使用is_authenticated()来判断用户是否登录:

if request.user.is_authenticated():
  ...
else:
  ...

用户登录

你可以使用login(request,user)函数进行登录操作,该函数的两个参数为HttpRequest对象User对象。该函数会将用户ID保存在session中。以下为官方示例:

from django.contrib.auth import authenticate, login

def my_view(request):
    username = request.POST['username']
    password = request.POST['password']
    user = authenticate(username=username, password=password)
    if user is not None:
        if user.is_active:
            login(request, user)
            # Redirect to a success page.
        else:
            # Return a 'disabled account' error message
            ...
    else:
        # Return an 'invalid login' error message.
        ...

其中authenticate()函数作用为:根据用户名和密码检验用户对象是否合法,并返回改用户对象。

用户注销

你可以使用logout(request)函数进行注销操作,该函数只有一个参数为HttpRequest对象。以下为官方示例:

from django.contrib.auth import logout

def logout_view(request):
    logout(request)
    # Redirect to a success page.

logout函数使用注意事项:

  • 如果没有用户登录,该函数不会抛出错误;
  • 当你使用该函数时,最近一次requestsession中的数据会被完全清除,这一点在使用该函数时需特别注意。

登录状态检验

有时候,你希望用户只有在登录状态下才能做某些操作,你就需要检验当前是否处于用户登录状态。

  • 基础的方法

最简单的方法就是使用request.user.is_authenticated()检验用户是否登录,若未登录则抛出异常或进行重定向:

from django.conf import settings
from django.shortcuts import redirect
from django.shortcuts import render

def my_view(request):
    if not request.user.is_authenticated():
        return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))
        #或者 return render(request, 'myapp/login_error.html')
    # ...
  • 优雅的方法

上一种简单的方法虽然比较好理解,但是并不优雅。如果你在很多地方都需要检验用户是否处于登录状态,就需要写很多重复的代码。
而优雅的解决方式就是——使用login_require()修饰符:

from django.contrib.auth.decorators import login_required

@login_required
def my_view(request):
    ...

login_required(redirect_field_name='next', login_url=None)功能介绍如下:

  • 如果用户没有登录,就会重定向到settings.LOGIN_URL,并将当前的绝对路径以query字符串的形式传递。例:/accounts/login/?next=/当前路径/
  • 如果用户已登录,就会正常地执行view
  • 修饰符默认重定向的传入参数名为next,重定向的地址为settings.LOGIN_URL。当然,你也可以在修饰符中进行修改:

1、将重定向参数名next改为redirect_field_name

from django.contrib.auth.decorators import login_required

@login_required(redirect_field_name='my_redirect_field')
def my_view(request):
    ...

2、设置重定向地址为'/accounts/login/'

from django.contrib.auth.decorators import login_required

@login_required(login_url='/accounts/login/')
def my_view(request):
    ...

:django的用户验证系统中有许多与login_required类似的修饰符,如permission_required判断用户权限等等,具体请查阅官方文档。

总结

对于django用户检验系统的学习就到此结束了,希望我的笔记对大家使用这一系统有所帮助。有什么错误或者不足之处,也欢迎大家批评指正。

参考资料:django官方文档

你可能感兴趣的:(Django用户验证系统的简单使用)