Django框架（十三）——Auth模块

Auth模块

一、什么是auth模块

Auth模块是Django自带的用户认证模块

Auth模块是Django自带的用户认证模块，可以实现包括用户注册、用户登录、用户认证、注销、修改密码等功能。默认使用 auth_user 表来存储用户数据。

二、Auth模块使用

1.创建超级用户  (createsuperuser)

创建超级用户就是在auth_user表中插入数据，密码是加密的。

在  Run manage.py Task  创建

createsuperuser

2.查询用户（authenticate()）

验证用户名以及密码是否正确，一般需要username 、password两个关键字参数。如果认证成功（用户名和密码正确有效），便会返回一个 User 对象

from django.contrib import auth
user_obj = auth.authenticate(request, username=name, password=pwd)

不能使用filter这种查询方法，因为user表存的密码是加密的

models.User.objects.filter(username=username,password=password).first()

3.登录用户(login())

该函数接收一个HttpRequest对象，以及一个经过查询认证的user_obj

登录之后，会将用户状态记录到session中

from django.contrib import auth

auth.login(request,user_obj)

4.登录成功

只要执行了上面那句话登录成功，你就可以在后端任意位置通过request.user获取到当前用户对象

user_obj = request.user

5.判断用户是否登录（is_authenticated）

用来判断当前请求是否通过了认证，如果通过就是true,反之false

request.user.is_authenticated

6.登录认证装饰器

快捷的给某个视图添加登录校验。

若用户没有登录，则会跳转到django默认的登录URL'/accounts/login/',并传递当前访问url的绝对路径（登录成功后，会重定向回到该路径）

如果自定义了登录URL,则需要在settings.py文件中通过LOGIN_URL 设置登录路径

from django.contrib.auth.decorators import  login_required

@login_required(login_url='/xxx/')  # 局部配置 直接在装饰器里面写一个登录路径
def index(request):
    pass
    
           
# 全局配置  settings文件中写  
LOGIN_URL = '/xxx/'
设置完后直接写装饰器 @login_required 就可以

7.注册超级用户和普通用户

错误方法：User.objects.create(username =username,password=password)  # 创建用户名的时候 千万不要再使用create 了
User.objects.create_user(username =username,password=password)  # 创建普通用户
User.objects.create_superuser(username =username,password=password,email='123@qq.com')  # 创建超级用户  邮箱必填

8.校验密码(check_password())

#校验密码
request.user.check_password(old_password)

9.修改密码(set_password())

注意：修改密码的时候，一定要save保存，否则不会生效

request.user.set_password(new_password)
request.user.save()

10.退出登录(logout())

当调用该函数时，当前请求的session信息会全部清除，相当于request.session.flush().该用户即使没有登录，使用该函数也不会报错

auth.logout(request)

11.User对象的其他属性

# 在网站上线以前，将is_active和is_staff设置为False
is_active    # 禁止登录网站(用户还存在,封号)
is_staff    # 是否对网站有管理权限(能不能登录admin)

request.user.is_active = False
request.user.is_staff = False

三、自定义auth_user表

1.方法一：定义一个表模型，跟User一对一关联（不推荐使用）

from django.contrib.auth.models import User

class UserDetail(models.Model):
    phone=models.CharField(max_length=32)
    # 一对一跟auth_user表做关联
    # 如果是从外部引入的表模型,是不能加引号的
    # 如果加引号,只是在当前model找
    user=models.OneToOneField(to=User)

2.方法二：使用类的继承，继承(AbstractUser)

from django.contrib.auth.models import AbstractUser

class Userinfo(AbstractUser):
    # 千万不要跟原来表中的字段重复 只能创新
    phone = models.BigIntegerField()
    avatar = models.CharField(max_length=32)

注意：

1.一旦我们通过继承来实现扩展auth_user表，那么做数据库迁移，以后就没有auth_user这个表了，以后认证组件用的表就是UserInfo。原来使用 auth_user 表模型的地方全部要用新的表模型——UserInfo(这个是你自定义的模型类)

2.告诉django不再使用auth默认的表，而是使用你自定义的表，需要在settings.py中设置
AUTH_USER_MODEL = 'app01.Userinfo'   '应用名.类名'