auth认证组件

auth认证组件是Django自带的用户认证
导入 auth模块html

from django.contrib import auth

auth模块中的方法:python

1.authenticate()数据库

提供了用户认证功能,即验证用户名以及密码是否正确,通常须要username 、password两个关键字参数。django

若是认证成功(用户名和密码正确有效),便会返回一个 User 对象。若是没有成功,不会报错,则会生成一个匿名用户,里面的全部的字段都是空的;后端

authenticate()会在该 User 对象上设置一个属性来标识后端已经认证了该用户,且该信息在后续的登陆过程当中是须要的。cookie

  user = auth.authenticate(username=username, password=pwd)
            if user:
                # 用户名密码正确
                # 给用户作登陆
                auth.login(request, user)
                ret["msg"] = "/index/"

2.login(HttpRequest, user)

接收一个Request,以及经过验证的User对象;session

把认证过的user对象封装在 request.user里面,便可以经过 user = request.user,拿到当前登陆用户的对象;app

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表了。

详细(点我