Auth模块

auth组件是django内置的用户认证系统，可以快速的实现，登录，注销，修改密码等。

from django.contrib import auth

1.创建用户

python3 manage.py createsuperuser（只能创建超级用户，不能通过命令行创建普通用户）

创建超级用户，输入用户名，邮箱（可以不写，默认NULL=True）,密码，确认密码。在创建之前先执行数据库迁移命令。

create_user(创建普通用户)

from django.contrib.auth.models import User
user = User.objects.create_user（username='用户名',password='密码',email='邮箱',...）

create_superuser(创建超级用户)

from django.contrib.auth.models import User
user = User.objects.create_superuser（username='用户名',password='密码',email='邮箱',...）

2.authenticate(验证用户)

提供了用户认证功能，即验证用户名以及密码是否正确，一般需要username 、password两个关键字参数。

如果认证成功（用户名和密码正确有效），便会返回一个 User 对象。

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

user = auth.authenticate(username='usernamer',password='password')

3.login(request,user)

该函数接受一个HttpRequest对象，以及一个经过认证的User对象。

该函数实现一个用户登录的功能。它本质上会在后端为该用户生成相关session数据。

def auth_test(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        pwd = request.POST.get('pwd')
        # 做认证
        user = auth.authenticate(request,username=name,password=pwd)
        if user:
            # 做登录
            auth.login(request,user)
            return HttpResponse('登录成功')
        return HttpResponse('登录失败')
    elif request.method == 'GET':
    return render(request,'index.html')

4.logout(request)

该函数接受一个HttpRequest对象，无返回值。

当调用该函数时，当前请求的session信息会全部清除，本质就是调用了session的flush()方法。该用户即使没有登录，使用该函数也不会报错。

from django.contrib.auth import logout
   
def logout_view(request):
  logout(request)
  return HttpResponse('退出登录')

5 .login_requierd()

auth 给我们提供的一个装饰器工具，用来快捷的给某个视图添加登录校验。

from django.contrib.auth.decorators import login_required
      
@login_required
def my_view(request):
  user = request.user
    # 判断是否有用户登录
    if user.is_authenticated():
        print('登录了',request.user)
    else:
        print('没有登录',request.user)

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

如果需要自定义登录的URL，则需要在settings.py文件中通过LOGIN_URL进行修改。

示例：

LOGIN_URL = '/login/'  # 这里配置成你项目登录页面的路由

6.is_authenticated()

用来判断当前请求是否通过了认证。

def my_view(request):
  if not request.user.is_authenticated():
    return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))

7.check_password(password)

auth 提供的一个检查密码是否正确的方法，需要提供当前请求用户的密码。

密码正确返回True，否则返回False。

res = request.user.check_password('密码')

8.set_password(password)

auth 提供的一个修改密码的方法，接收要设置的新密码作为参数。

注意：设置完一定要调用用户对象的save方法！！！

用法：

user = request.user
user.set_password(新密码)
user.save()

9.user对象的属性及删除用户

删除用户就是用orm删除方法

user对象属性：username， password

is_staff ：用户是否拥有网站的管理权限。

is_active ：是否允许用户登录, 设置为 False，可以在不删除用户的前提下禁止用户登录。（封号）

10.扩展默认的auth_user表

我们可以通过继承内置的 AbstractUser 类，来定义一个自己的Model类。

这样既能根据项目需求灵活的设计用户表，又能使用Django强大的认证系统了。

from django.contrib.auth.models import AbstractUser
class UserInfo(AbstractUser):
    """
    用户信息表
    """
    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 = "app名称.UserInfo"

一旦我们指定了新的认证系统所使用的表，我们就需要重新在数据库中创建该表，而不能继续使用原来默认的auth_user表了。

小白学Django---------Auth模块