auth模块方法的使用

1、创建超级用户(管理员)

"""
在创建好一个django项目后，直接执行数据库迁移命令后会自动生成很多表，  django_session   ......    其中就包括 auth_user表

django在启动之后就可以直接访问admin路由，需要输入用户名和密码，数据参考的就是auth_user表，并且还必须是管理员用户才能进入

"""

先执行数据库迁移命令生成表

#创建管理员用户
python manage.py createsuperuser

超级用户创建好之后，auth_user表中发生变化

路由中输入admin，登录管理员用户

登录进入后的界面：

依赖于auth_user表完成用户以下相关的所有功能：

2、获取表，检验密码

登录功能

<form action="" method="post">
    {% csrf_token %}
    <p>username:<input type="text" name="username"></p>
    <p>password:<input type="text" name="password"></p>
    <input type="submit">
</form>

# views.py

from django.shortcuts import render, redirect, HttpResponse
from django.contrib import auth

def login(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        # 去用户表中校验数据
        # 1.获取表
        # 2.密码比对
        user_obj = auth.authenticate(request, username=username, password=password)
        # print(user_obj)  # 用户对象  数据不符合返回None
        # print(user_obj.username)  # 用户名
        # print(user_obj.password)  # ,密码
        
        
        """
        1.自动查找auth_user表
        2.自动给密码加密比对
        该方法的注意事项:
            括号内必须同时传入用户名和密码
            不能只传用户名
        """
        
        if user_obj:
            # 保存用户状态
            auth.login(request, user=user_obj)  # 类似于request.session[key]=user_obj
            
            """
            只要执行了该方法，就可以在任何地方通过request.user获取到当前登录的用户对象
            """ 
             return redirect('/home/')
      

    return render(request, 'login.html')

3、保存用户状态

# 保存用户状态
 auth.login(request, user=user_obj)  # 类似于request.session['key']=user_obj
    
 """
只要执行了该方法，就可以在任何地方通过request.user获取到当前登录的用户对象
""" 

保存用户状态后，django_session表中就多了条数据

4、获取用户对象，校验用户是否登录

def home(request):
    print(request.user)  # 拿到用户对象
    """
    自动去django_session表中查找对应的用户对象给你封装到request.user中
    """
    # 判断用户是否登录
    print(request.user.is_authenticated)
    return HttpResponse('OK!')

当删除django_session表中的数据，就表示用户没有登录过，再次查看request.user拿到什么数据

登陆成功后，返回当前登录的用户对象，返回True

5、验证用户是否登录

用户登录后才能访问(加装饰器)

"""用户登录之后才能看home"""

#  局部配置:用户没有登录跳转到login_user后面指定的网址
from django.contrib.auth.decorators import login_required
@login_required(login_url='/login/')  
def home(request):
    print(request.user) 
    print(request.user.is_authenticated)
    return HttpResponse('OK!')


# 全局配置，没有登录跳转到指定页面
#配置文件settings.py
LOGIN_URL = '/login/'


from django.contrib.auth.decorators import login_required
@login_required
def home(request):
    print(request.user)  
    print(request.user.is_authenticated)
    return HttpResponse('OK!')


# 如果局部和全局都有，会跳转到局部配置，
# 局部配置的优先级大于全局配置
# 全局的好处在于无需重复写代码，但是跳转的页面很单一
# 局部的好处在于不同的视图函数在用户没有登录的情况下可以跳转到不同的页面

6、修改密码

#urls.py

#修改密码
path('set_password/',views.set_password),

#views.py

@login_required
def set_password(request):
    if request.method == 'POST':
        old_password = request.POST.get('old_password')
        new_password = request.POST.get('new_password')
        confirm_password = request.POST.get('confirm_password')
        # 先校验两次密码是否一致
        if new_password == confirm_password:
            # 校验旧密码是否正确
            is_right = request.user.check_password(old_password)  # 自动加密，比对密码，返回布尔值
            if is_right:
                # 修改密码
                request.user.set_password(new_password)  # 仅仅是修改对象的属性
                request.user.save()  # 这一步才是真正的操作数据库，
        return redirect('login')
    return render(request, 'set_password.html', locals())

<form action="" method="post">
    {% csrf_token %}
    <p>username:<input type="text" name="username" disabled value="{{ request.user.username }}"></p>
    <p>old_password:<input type="text" name="old_password"></p>
    <p>new_password:<input type="text" name="new_password"></p>
    <p>confirm_password:<input type="text" name="confirm_password"></p>

    <input type="submit">
</form>

7、注销

#注销
path('login_out/',views.login_out)

@login_required
def login_out(request):
    auth.logout(request)  # 类似于 request.session.flush()
    return redirect('/login/')

8、注册

<form action="" method="post">
    {% csrf_token %}
    <h1>注册</h1>
    <p>username:<input type="text" name="username"></p>
    <p>password:<input type="text" name="password"></p>
    <input type="submit">
</form>

# 注册功能
path('register/',views.register),

#views.py
from django.contrib.auth.models import User
def register(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        # 操作auth_user表写入数据
        User.objects.create(username=username, password=password)  # 创建数据，但是用create创建，密码没有加密处理

    return render(request, 'register.html')

# 创建普通用户
User.objects.create_user(username=username, password=password)

 # 创建超级用户（了解）
        User.objects.create_superuser(username=username,password=password)

9、方法总结

"""1. 比对用户名和密码是否正确"""
user_obj = auth.authenticate(request, username=username, password=password)
print(user_obj)  # 用户对象  数据不符合返回None
print(user_obj.username)  # 用户名
print(user_obj.password)  # ,密码，密文
"""2.保存用户状态"""
# 保存用户状态
 auth.login(request, user=user_obj)  # 类似于request.session['key']=user_obj
#只要执行了该方法，就可以在任何地方通过request.user获取到当前登录的用户对象
"""3. 判断当前用户是否登录"""
print(request.user.is_authenticated)
"""4. 获取当前登录用户"""
request.user
"""5. 校验用户是否登录（装饰器）"""
#  局部配置:用户没有登录跳转到login_user后面指定的网址
from django.contrib.auth.decorators import login_required
@login_required(login_url='/login/')  
#全局配置
#settings.py
LOGIN_URL='/login/'
# 如果局部和全局都有,会跳转到局部配置，
# 局部配置的优先级大于全局配置
# 全局的好处在于无需重复写代码，但是跳转的页面很单一
# 局部的好处在于不同的视图函数在用户没有登录的情况下可以跳转到不同的页面
"""6.比对原密码"""
request.user.check_password(old_password)  # 自动加密，比对密码，返回布尔值
"""7. 修改密码"""
 request.user.set_password(new_password)  # 仅仅是修改对象的属性
 request.user.save()  # 这一步才是真正的操作数据库，
"""8. 注销"""
auth.logout(request)  # 类似于 request.session.flush()
"""9. 注册"""
from django.contrib.auth.models import User
 # 操作auth_user表写入数据
User.objects.create(username=username, password=password)  # 创建数据，但是用create创建，密码没有加密处理
# 创建普通用户
User.objects.create_user(username=username, password=password)
 # 创建超级用户（了解）
User.objects.create_superuser(username=username,password=password)

10、如何扩展auth_user表

from django.db import models
from django.contrib.auth.models import User, AbstractUser

# Create your models here.
"""扩展表的第一种方式：一对一关系   不推荐使用"""
#
# class UserDetail(models.Model):
#     phone = models.BigIntegerField()
#     user = models.OneToOneField(to='User', on_delete=models.CASCADE)

"""第二种方式：利用面向对象的继承"""

#models.py
class UserInfo(AbstractUser):
    phone = models.BigIntegerField()
    create_time = models.DateTimeField(auto_now_add=True)
    """
    如果继承了AbstractUser
    那么在执行数据库迁移命令的时候auth_user表就不会在创建出来了
    而UserInfo表中会出现auth_user表中所有的字段，外加自己扩展的字段

    这么做的好处就在于能够直接点击你自己创建的表，更加快速的完成操作及扩展

    前提:
        1.在继承之前没有执行过数据库迁移命令（auth_user没有被创建）
            如果auth_user已经被创建，那么就重新换一个库
        2.继承的类型里面不要覆盖AbstractUser里面的字段名
            表里面的字段都不要动，只扩展额外的字段即可
        3. 需要在配置文件中告诉django你要用User Info替代auth_user
            AUTH_USER_MODEL='app01.UserInfo'
                                '应用名.表名'
    """
 

如果自己写表替代了auth_user，那么auth模块还照常使用，参考的表也由原来的auth_user变成了现在的UserInfo