Auth模块

时间:2019-10-31
本文章向大家介绍Auth模块,主要包括Auth模块使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

Auth模块

一、Auth模块是什么

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

我们在开发一个网站的时候,无可避免的需要设计实现网站的用户系统。此时我们需要实现包括用户注册、用户登录、用户认证、注销、修改密码等功能,这还真是个麻烦的事情呢。

Django作为一个完美主义者的终极框架,当然也会想到用户的这些痛点。它内置了强大的用户认证系统--auth,它默认使用 auth_user 表来存储用户数据。

二、auth模块使用

1.创建表

>>>: python manage.py makemigrations
>>>: python manage.py migrate

2.导入auth模块

from django.contrib import auth

三、auth模块方法

3.1 创建用户

>>>: python mamang.py createsuperuser

3.2 authenticate()获取用户信息

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

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

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

创建的用户可以登录管理员后台管理:http://127.0.0.1:8000/admin/

<body>
<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>
</body>
# urls.py
from app import views
urlpatterns = [
    url(r'^login/', views.login),
]

# views.py
from django.contrib import auth
def login(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        # 查找用户
        User.objects.filter(username=username, password=password)
        # 判断用户是否存在
        user_obj = auth.authenticate(username=username, password=password)
        print(user_obj.username)
        print(user_obj.password)
    return render(request, '01login.html')
"""
  该方法会有一个返回值  当条件存在的情况下 返回就是数据对象本身
  条件不满足 直接返回None
 """

randy
pbkdf2_sha256\(36000\)bjhl1yDKX4rD$eR2I9J9o02ID1s6SEWV2iEr/OlDO4DHl9Aa/Mx6tAp4=

3.3 login(HttpRequest, user)

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

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

from django.contrib import auth
from django.contrib.auth.models import User


def login(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        print(User.objects.filter(username=username, password=password))
        # 判断用户是否存在
        user_obj = auth.authenticate(username=username, password=password)
        print(user_obj.username)
        print(user_obj.password)
        # 判断密码是否正确
        print(user_obj.check_password(password))
        if user_obj:
            # 一定要记录用户的状态, 才算真正的用户登录成功
            auth.login(request, user_obj)
            """
            该方法会主动帮你创建session,保存到django.sesion表中,并且只要执行该方法
            就可以在任何位置通过request.user获取到当前登录的用户信息
            """
    return render(request, '01login.html')

3.4 login_required判断用户是否登录(装饰器)

导入

from django.contrib.auth.decorators import login_required

1.局部添加装饰器

使用装饰器,明确指明要跳转的url

@login_required(login_url='/login/')
def home(request):
    return HttpResponse('home页面')

2.全局添加装饰器

# settings中配置
# auth校验用户是否登录,全局跳转到url
LOGIN_URL = '/login/'

# views.py
@login_required() # 全局配置
def home(request):
    return HttpResponse('home页面')

总结:

当用户没有登录的情况下 跳转的url有两种配置方式

  • 1在装饰器括号内通过login_url参数局部指定
  • 全局配置 用户没有登录的情况下 所有的视图统一跳转到一个url, 配置文件中: LOGIN_URL = '/login/'

3.5 is_authenticated()

用来判断当前请求用户是否登录。

def index(request):
    print(request.user)
    print(request.user.is_authenticated()) # 简单快捷的判断用户是否登录 
    if request.user.is_authenticated(): # True
        return HttpResponse('用户已经登录')
    return HttpResponse("用户没有登录")

返回布尔类型

3.6check_password(password)

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

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

用法:

ok = user.check_password('密码')

3.7 set_password()修改密码

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

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

<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>
    <input type="submit">
</form>
</body>
# urls.py
from app import views
urlpatterns = [
    url(r'^modif_password/', views.modif_password),
]
# views.py
@login_required
def modif_password(request):
    if request.method == 'POST':
        old_password = request.POST.get('old_password')
        new_password = request.POST.get('new_password')

        # 校验密码对不对
        is_password = request.user.check_password(old_password)
        if is_password:
            # 修改密码,只会在内存中产生了一个缓存,并不会直接修改密码
            request.user.set_password(new_password)
            # 一定要save保存
            request.user.save()
            return redirect('/login/')

    return render(request, '02modif_password.html', locals())

注意:设置完一定要调用用户对象的save方法!!,修改密码是request对象修改

3.8 创建普通用户和管理员

<!--register-->
<body>
<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>
</body>
# urls.py
from app import views
urlpatterns = [
    url(r'^register/', views.register),
]
# views.py
def register(request):
    if request.method == 'POST':
        username = request.POST.get('username')
        password = request.POST.get('password')
        # 不用使用create 密码会直接存成明文
        # User.objects.create(username=username,password=password)
        
        # 创建普通用户
        User.objects.create_user(username=username,password=password) # 创建普通用户

        # 创建超级用户管理员邮箱必须填
        User.objects.create_superuser(username=username, password=password,email='2214644978@qq.com')
    return render(request, '03register.html')

create_user():auth 提供的一个创建新用户的方法,需要提供必要参数(username、password)等。

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

create_superuser():auth 提供的一个创建新的超级用户的方法,需要提供必要参数(username、password)等。

from django.contrib.auth.models import User
# 注意创建超级用户邮箱必填写
user = User.objects.create_superuser(username='用户名',password='密码',email='邮箱',...)

3.9 logout(request) 注销

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

当调用该函数时,当前请求的session信息会全部清除。该用户即使没有登录,使用该函数也不会报错。

用法:

from django.contrib.auth import logout
   
def logout_view(request):
  logout(request)
  # Redirect to a success page.

四、扩展默认的auth_user表

这内置的认证系统这么好用,但是auth_user表字段都是固定的那几个,我在项目中没法拿来直接使用啊!

比如,我想要加一个存储用户手机号的字段,怎么办?

聪明的你可能会想到新建另外一张表然后通过一对一和内置的auth_user表关联,这样虽然能满足要求但是有没有更好的实现方式呢?

答案是当然有了。

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

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

# settinsg.py
# auth自定义表配置
AUTH_USER_MODEL = 'app01.Userinfo'
# 固定语法: AUTH_USER_MODEL = '应用名.表名'

# modes.py
from django.contrib.auth.models import AbstractUser
class Userinfo(AbstractUser):
    """
    强调 你继承了AbstractUser之后 你自定义的表中 字段不能跟原有的冲突
    """
    phone = models.BigIntegerField()
    avatar = models.FileField()
    register_time = models.DateField(auto_now_add=True)

生成表不成功,将迁移(migrations文件迁移)记录删除

注意:

按上面的方式扩展了内置的auth_user表之后,一定要在settings.py中告诉Django,我现在使用我新定义的UserInfo表来做用户认证。写法如下:

# 引用Django自带的User表,继承使用时需要设置
AUTH_USER_MODEL = "app名.表名"

再次注意:

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

原文地址:https://www.cnblogs.com/randysun/p/11774001.html