Django 用户认证组件使用详解
一、auth模块
#创建超级用户 pythonmanage.pycreatesuperuser fromdjango.contribimportauth
django.contrib.auth中提供了许多方法:
authenticate()
提供了用户认证功能,即验证用户名以及密码是否正确,一般需要username、password两个关键字参数。
如果认证成功(用户名和密码正确有效),便会返回一个User对象。
authenticate()会在该User对象上设置一个属性来标识后端已经认证了该用户,且该信息在后续的登录过程中是需要的。
fromdjango.contrib.authimportauthenticate user=authenticate(username="user",password="pwd")
login(HttpRequest,user)
该函数接受一个HttpRequest对象,以及一个认证了的User对象;该函数实现一个用户登录的功能。它本质上会在后端为该用户生成相关session数据。
fromdjango.contrib.authimportauthenticate,login
deflog_in(request):
ifrequest.method=="POST":
user=request.POST.get("username")
pwd=request.POST.get("password")
user=authenticate(username=user,password=pwd)
ifuserisnotNone:
login(request,user)
#Redirecttoasuccesspage
...
else:
#Returnan"invalidlogin"errormessage.
...
returnrender(request,"login.html")
logout(request)注销用户
该函数接受一个HttpRequest对象,无返回值。当调用该函数时,当前请求的session信息会全部清除。该用户即使没有登录,使用该函数也不会报错。
fromdjango.contrib.authimportlogout deflog_out(request): logout(request) #Redirecttoasuccesspage.
二、User对象
User对象属性:username,password(必填项);password用哈希算法保存到数据库
is_staff:用户是否拥有网站的管理权限
is_active:是否允许用户登录。设置为"False",可以不用删除用户来禁止用户登录
is_authenticated()
如果是真正的User对象,返回值恒为True;用于检查用户是否已经通过了认证。
通过认证并不意味着用户拥有任何权限,甚至也不检查该用户是否处于激活状态,这只是表明用户成功的通过了认证。这个方法很重要,在后台用request.user.is_authenticated()判断用户是否已经登录,如果为true则可以向前台展示request.user.name。
要求:
- 用户登陆后才能访问某些页面
- 如果用户没有登录就访问该页面的话直接跳到登录页面
- 用户在跳转的登陆界面中完成登陆后,自动访问跳转到之前访问的地址
方法1:
defmy_view(request):
ifnotrequest.user.is_authenticated():
returnredirect('%s?next=%s'%(settings.LOGIN_URL,request.path))
方法2:
django已经为我们设计好了一个用于此种情况的装饰器:login_requierd()
fromdjango.contrib.auth.decoratorsimportlogin_required @login_required defmy_view(request): ...
使用login_requierd()注意:
若用户没有登录,则会跳转到django默认的登录URL'/accounts/login/';并传递当前访问url的绝对路径(登陆成功后,会重定向到该路径)。
如果需要自定义登录的URL,则需要在settings.py文件中通过LOGIN_URL进行修改。
LOGIN_URL="/login/"#这里配置成项目登录页面的路由
create_user()创建用户
fromdjango.contrib.auth.modelsimportUser user=User.objects.create_user(username="",password="",email="",...)
create_superuser()创建超级用户
fromdjango.contrib.auth.modelsimportUser user=User.objects.create_superuser(username="",password="",email="",...)
check_password(password)
检查密码是否正确的方法;密码正确返回True,否则返回False。
ret=user.check_password("密码")
set_password(password)
一个修改密码的方法,接收要设置的新密码作为参数。
注意:设置完一定要调用User对象的save方法!!!
user.set_password(password="") user.save()
修改密码示例:
@login_required
defalter_password(request):
user=request.user
err_msg=""
ifrequest.method=='POST':
old_password=request.POST.get("old_password","")
new_password=request.POST.get("new_password","")
repeat_password=request.POST.get("repeat_password","")
ifuser.check_password(old_password):
ifnotnew_password:
err_msg="新密码不能为空"
elifnew_password!=repeat_password:
err_msg="两次密码不一致"
else:
user.set_password(new_password)
user.save()
returnredirect("/log_in/")
else:
err_msg="原密码输入错误"
content={
"err_msg":err_msg,
}
returnrender(request,"alter_password.html",content)
三、扩展默认的auth_user表
通过继承内置的AbstractUser类,来定义一个自己的Model类。这样既能根据项目需求灵活的设计用户表,又能使用Django强大的认证系统了。
#models.py fromdjango.dbimportmodels fromdjango.contrib.auth.modelsimportAbstractUser classUserInfo(AbstractUser): age=models.IntegerField(default=18) phone=models.CharField(max_length=11,null=True,unique=True) def__str__(self): returnself.username
注意:
按上面的方式扩展了内置的auth_user表之后,一定要在settings.py中告诉Django,我现在使用我新定义的UserInfo表来做用户认证:
#引用Django自带的User表,继承使用时需要设置 AUTH_USER_MODEL="app名.UserInfo"
一旦我们指定了新的认证系统所使用的表,我们就需要重新在数据库中创建该表,而不能继续使用原来默认的auth_user表了。
四、示例
views.py
fromdjango.shortcutsimportrender,redirect
fromdjango.contrib.authimportauthenticate,login,logout
fromdjango.contrib.auth.decoratorsimportlogin_required
#fromdjango.contrib.auth.modelsimportUser
fromappxximportmodels
defsign_up(request):
error_msg=""
ifrequest.method=="POST":
user=request.POST.get("username")
pwd=request.POST.get("password")
ifmodels.UserInfo.objects.filter(username=user):
error_msg="用户已存在"
else:
new_user=models.UserInfo.objects.create_user(username=user,password=pwd)
new_user.save()
returnredirect("/login/")
content={
"error_msg":error_msg
}
returnrender(request,"register.html",content)
deflog_in(request):
ifrequest.method=="POST":
user=request.POST.get("username")
pwd=request.POST.get("password")
user=authenticate(username=user,password=pwd)
ifuserisnotNone:
login(request,user)
returnredirect("/index/")
returnrender(request,"login.html")
@login_required
defindex(request):
returnrender(request,"index.html")
deflog_out(request):
logout(request)
returnredirect("/login/")
sign_up函数部分原本使用User.objects,但因为使用了UserInfo表代替了django内置的auth_user表,所以需要改为models.UserInfo.objects
login.html
登录 登录页面
{%csrf_token%}
账号:
密码: