auth认证组件是Django自带的用户认证
导入 auth模块
from django.contrib import auth
auth模块中的方法:
1.authenticate()
提供了用户认证功能,即验证用户名以及密码是否正确,一般需要username 、password两个关键字参数。
如果认证成功(用户名和密码正确有效),便会返回一个 User 对象。如果没有成功,不会报错,则会生成一个匿名用户,里面的所有的字段都是空的;
authenticate()会在该 User 对象上设置一个属性来标识后端已经认证了该用户,且该信息在后续的登录过程中是需要的。
user = auth.authenticate(username=username, password=pwd) if user: # 用户名密码正确 # 给用户做登录 auth.login(request, user) ret["msg"] = "/index/"
2.login(HttpRequest, user)
接收一个Request,以及通过验证的User对象;
把认证过的user对象封装在 request.user里面,即可以通过 user = request.user,拿到当前登录用户的对象;
user= request.user # 来获取 登录用户的对象;
3.logout(request)
该函数接受一个HttpRequest对象,无返回值。
当调用该函数时,当前请求的session信息以及cookies值会全部清除。该用户即使没有登录,使用该函数也不会报错。
def logout(request): auth.logout(request) return redirect("/index/")
4.is_authenticated()
用来判断当前请求是否通过了认证。返回值为True或Flase
def my_view(request): if not request.user.is_authenticated(): return HttpResponse("98k")
5.login_requierd()
auth 给我们提供的一个装饰器工具,用来快捷的给某个视图添加登录校验。本质是也是用session,只不过auth模块帮我们写了;
from django.contrib.auth.decorators import login_required
@login_required #也是基于session和cookies def index(request): # request.user 拿到当前的用户 article_list = models.Article.objects.all() # print(article_list) return render(request,"index.html",{"article_list":article_list})
若用户没有登录,则会跳转到django默认的 登录URL '/login/ ' 并传递当前访问url的绝对路径 (登陆成功后,会重定向到该路径)。
如果需要自定义登录的URL,则需要在settings.py文件中通过LOGIN_URL进行修改。
# 自定义跳转的登录页面 LOGIN_URL = "/login/"
6.create_user()
auth 提供的一个创建新用户的方法,需要提供必要参数(username、password)
from django.contrib.auth.models import User user = User.objects.create_user(username='用户名',password='密码',email='邮箱')
7.create_superuser()
一个创建新超级用户的方法
8.check_password(raw_password)
auth 提供的一个检查密码是否正确的方法,需要提供当前请求用户的密码。
密码正确返回True,否则返回False。
# 修改密码 def setpwd(request): if request.method == "POST": user_obj = request.user o_name = request.POST.get("old_name") n_name = request.POST.get("new_name") ret = user_obj.check_password(o_name) if ret: user_obj.set_password(n_name) user_obj.save() return redirect("/login/") else: return HttpResponse("原密码输入错误") return render(request,"setpwd.html")
9.set_password(raw_password)
auth 提供的一个修改密码的方法,接收 要设置的新密码 作为参数。
注意:设置完一定要调用用户对象的save方法!!!
示例:如上图
扩展默认的auth_user表
我们可以通过继承内置的 AbstractUser 类,来定义一个自己的Model类,这样又能用auth表的字段也能增加额外的字段;
这样既能根据项目需求灵活的设计用户表,又能使用Django强大的认证系统了。
from django.contrib.auth.models import AbstractUser class UserInfo(AbstractUser): """ 用户信息表 """ id = models.AutoField(primary_key=True) phone = models.CharField(max_length=11, null=True, unique=True) def __str__(self): return self.username
注意:
按上面的方式扩展了内置的auth_user表之后,一定要在settings.py中告诉Django,我现在使用我新定义的UserInfo表来做用户认证。写法如下:
# 引用Django自带的User表,继承的使用需要设置 AUTH_USER_MODEL = "app01.UserInfo"
自定义认证系统默认使用的数据表之后,我们就可以像使用默认的auth_user表那样使用我们的UserInfo表了。
UserInfo.objects.create_user(username='用户名', password='密码')
UserInfo.objects.create_superuser(username='用户名', password='密码')
再次注意:
一旦我们指定了新的认证系统所使用的表,我们就需要重新在数据库中创建该表,而不能继续使用原来默认的auth_user表了。
详细(点我)