from django.contrib import auth
django.contrib.auth中提供了许多方法,这里主要介绍其中的三个:html
一、authenticate()
前端
提供了用户认证,即验证用户名以及密码是否正确,通常须要username,password两个关键字参数。python
若是认真信息有效,就返回一个User对象。authenticate()会在User对象上设置一个属性标识哪一种认证后端认证了该用户,且该信息在后面的登陆过程当中是须要的。当咱们视图登录一个从数据库中直接取出来不通过authenticate()的User对象,会报错。算法
user = authenticate(username='someone',password='somepassword')
二、login(HttpRequest, user)
数据库
该函数接受一个HttpRequest对象,以及一个认证了的User对象。django
此函数使用Django的session框架给某个已认证的用户附加上session_id等信息。后端
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: login(request, user) # Redirect to a success page. ... else: # Return an 'invalid login' error message. ...
三、logout(request)
注销用户session
from django.contrib.auth import logout def logout_view(request): logout(request) # Redirect to a success page.
该函数接受一个HttpRequest对象,无返回值。当调用该函数时,当前请求的session信息会所有清除。该用户即便没有登陆,使用该函数也不会报错。框架
User对象属性:username,password(必填项),password用哈希算法保存到数据库。函数
一、user对象的is_authenticated()
若是是真正的User对象,返回值恒为True。用于检查用户是否已经经过了认证。
经过认证并不意味着用户拥有任何权限,甚至也不检查该用户是否处于激活状态,这只是代表用户成功地经过了认证。这个方法很重要,在后台用request.user.is_anthenticated()
判断用户是否已登陆,若是是True则能够向前端展现request.user.name
例如,要求:
一、用户登陆后才能访问某些页面。
二、若是用户没有登陆就访问该页面的话直接跳转到登陆页面。
三、用户在跳转的登陆界面中完成登陆后,自动访问跳转以前访问的地址。
方法1:
def my_view(request): if not request.user.is_authenticated(): return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))
方法2:
django已经为咱们设计好了一个用于此种状况的装饰器:login_requierd()
from django.contrib.auth.decorators import login_required @login_required def my_view(request): ...
若用户没有登陆,则会跳转到django默认的登陆URL'/accounts/login/'
(这个值能够在settings文件中经过LOGIN_URL进行修改),并传递当前访问URL的绝对路径(登陆成功后,后重定向到 该路径)。
二、建立用户
使用 create_user 辅助函数建立用户:
from django.contrib.auth.models import User user = User.objects.create_user(username='',password='',email='')
三、check_password(password)
用户须要修改密码的时候 首先要让他输入原来的密码 ,若是给定的字符串经过了密码检查,返回 True。
四、修改密码
使用 set_password()
来修改密码
user = User.objects.get(username='') user.set_password(password='') user.save
五、简单示例
注册:
def sign_up(request): state = None if request.method == 'POST': password = request.POST.get('password', '') repeat_password = request.POST.get('repeat_password', '') email=request.POST.get('email', '') username = request.POST.get('username', '') if User.objects.filter(username=username): state = 'user_exist' else: new_user = User.objects.create_user(username=username, password=password,email=email) new_user.save() return redirect('/book/') content = { 'state': state, 'user': None, } return render(request, 'sign_up.html', content)
修改密码:
@login_required def set_password(request): user = request.user state = None if request.method == 'POST': old_password = request.POST.get('old_password', '') new_password = request.POST.get('new_password', '') repeat_password = request.POST.get('repeat_password', '') if user.check_password(old_password): if not new_password: state = 'empty' elif new_password != repeat_password: state = 'repeat_error' else: user.set_password(new_password) user.save() return redirect("/log_in/") else: state = 'password_error' content = { 'user': user, 'state': state, } return render(request, 'set_password.html', content)