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（））

该 函数接受一个HttpResponse对象，以及一个经过查询认证的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_lenth=32)
        #一对一跟auth_user表做关联
        #如果是从外部引入的表模型，是不能加引号的
        #如果加引号，只是在当前models找
        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'   '应用名.类名'