Auth模块、Forms组件

Auth模块

auth模块是Django自带的用户认证模块：

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

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

为了方便快捷的帮开发者完成登录相关的认证交互功能。

auth_user表常用操作：

from django.contrib.auth.models import User
#创建普通用户
User.objects.create_user(username='Owen', password='')

#创建超级用户
User.objects.create_superuser(username='root',password='root',email='root@root.com')

#获取第一个用户
user = User.objects.first()

#修改密码
user.set_password('')
user.save()  #注：修改完成后必须要进行保存，即执行save()方法

#校验密码
res = user.check_password('')

auth组件常用功能：

# 校验用户账号及密码，校验成功返回user对象
from django.contrib.auth import authenticate
#该模块需要两个参数，用户名和密码
user=authenticate(username=usr, password=pwd)

# 注册用户到request对象中，注册成功可以用request.user访问当前登录用户（会形成session记录）
from django.contrib.auth import login
login(request, user)  # 注册authenticate成功（当前登录）的用户

# 注销当前注册的user(用户注销)
from django.contrib.auth import logout
logout(request)

# 校验用户登录状态
# 视图函数中使用
if request.user.is_authenticated(): pass
# 模板语言中使用
{% if request.user.is_authenticated %}
{% else %}
{% endif %}

# 校验登录状态的装饰器
from django.contrib.auth.decorators import login_required
@login_required(login_url='/user_login/')
def user_home(request):
    return render(request, 'user.html', locals())

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

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

# 在settings.py中设置：
LOGIN_URL = '/login/'  # 这里配置成你项目登录页面的路由

扩展User表：

# app/models.py
#第一种方式：（建议使用）
from django.contrib.auth.models import AbstractUser
class User(AbstractUser):
    # 增加自定义字段
    info = models.TextField(null=True)

# settings.py配置
AUTH_USER_MODEL = 'app.User'

# 在视图函数中导入的模块就是：
from app.models import User

#第二种方式：（不建议使用）
 from django.contrib.auth.models import User
Create your models here.
class UserInfo(models.Model):
     id = models.AutoField(primary_key=True)
     info = models.TextField(null=True)
     user = models.OneToOneField(to=User, to_field='username', db_constraint=False, null=True, on_delete=models.SET_NULL)

Forms组件

表单字段的校验：

<!-- register.html核心代码 -->
<form action="" method="post" novalidate>
    <input type="text" name="usr">
    <input type="password" name="pwd">
    <input type="email" name="email">
    <input type="submit" value="注册">
</form>

# views.py核心代码
from django.shortcuts import render, HttpResponse
from django import forms
# 自定义校验表单字段的类，继承forms.Form，并用forms下具体字段完成校验
class CheckForm(forms.Form):
    # 通过error_messages自定义错误信息
    usr = forms.CharField(min_length=3, max_length=10, error_messages={'min_length':'长度至少为3'})
    pwd = forms.CharField(min_length=3, max_length=10)
    email = forms.EmailField(error_messages={'invalid':'邮箱不合法', 'required': '必填项'})

def register(request):
    if request.method == "GET":
        return render(request, 'register.html')
    if request.method == "POST":
        # 校验请求的所有数据
        check_form = CheckForm(request.POST)
        if check_form.is_valid():
            # 查看校验成功的数据，为字典类型
            print(check_form.cleaned_data)
            return HttpResponse('注册成功')
        else:
            # 查看校验失败的数据，为封装的字典类型
            print(check_form.errors)
    return HttpResponse('注册失败')

表单元素的渲染：

# view.py改动代码
class CheckForm(forms.Form):
    usr = forms.CharField(min_length=3, max_length=10, label="用户名")
    pwd = forms.CharField(min_length=3, max_length=10, label="密码")
    email = forms.EmailField(, label="邮箱")

def register(request):
    if request.method == "GET":
        check_form = CheckForm()
        return render(request, 'register.html', {'check_form': check_form})

<!-- register.html核心代码 -->
<!-- 方式一 -->
<form action="" method="post">
    {{ check_form.usr }}
    {{ check_form.pwd }}
    {{ check_form.email }}
    <input type="submit" value="注册">
</form>
<!-- 方式二 -->
<form action="" method="post">
    {% for foo in check_form %}
         <label for="{{ foo.id_for_label }}" class="col-sm-2 control-label">{{ foo.label }}</label>
         {{ foo }}
     {% endfor %}
    <input type="submit" value="注册">
</form>
<!-- 方式三 -->
<form action="" method="post">
    <table>{{ check_form.as_table}}</table>
    <input type="submit" value="注册">
</form>
<!-- 方式四 -->
<form action="" method="post">
    <ul>{{ check_form.as_ul}}</ul>
    <input type="submit" value="注册">
</form>
<!-- 方式五 -->
<form action="" method="post">
    {{ check_form.as_p}}
    <input type="submit" value="注册">
</form>

错误信息的渲染：

# views.py
class CheckForm(forms.Form):
    usr = forms.CharField(
        min_length=3,
        max_length=10,
        error_messages={
            'min_length': '长度至少为3',
            'max_length': '长度最多为10',
            'required': '必填项'
        },
        label="用户名"
    )
    pwd = forms.CharField(
        min_length=3,
        max_length=10,
        error_messages={
            'min_length': '长度至少为3',
            'max_length': '长度最多为10',
            'required': '必填项'
        },
        label="密码"
    )
    email = forms.EmailField(
        error_messages={
            'invalid': '邮箱不合法',
            'required': '必填项'}
    )

def register(request):
    if request.method == "GET":
        check_form = CheckForm()
    if request.method == "POST":
        check_form = CheckForm(request.POST)
        if check_form.is_valid():
            return HttpResponse('注册成功')
    return render(request, 'register.html', locals())

<form action="" method="post" novalidate>
    {% for ele in check_form %}
    <p>
        {{ ele.label }}:{{ ele }}
        <span style="color: red">{{ ele.errors.0 }}</span>
    </p>
    {% endfor %}

    <input type="submit" value="注册">
</form>

组件的参数设置：

class Ret(Form):
    name = forms.CharField(max_length=10, min_length=2, label='用户名',
                           error_messages={'required': '该字段不能为空', 'invalid': '格式错误', 'max_length': '太长',
                                           'min_length': '太短'},
                           widget=widgets.TextInput(attrs={'class':'form-control'}))
    pwd = forms.CharField(max_length=10, min_length=2, widget=widgets.PasswordInput(attrs={'class':'form-control'}))
    email = forms.EmailField(label='邮箱', error_messages={'required': '该字段不能为空', 'invalid': '格式错误'})

局部钩子:

# 在自定义验证类CheckForm中添加局部验证钩子
class CheckForm(forms.Form):
    ...
    def clean_usr(self):
        name = self.cleaned_data.get('usr')  # type: str
        import re
        if re.match('^[0-9]', name):
            from django.core.exceptions import ValidationError
            raise ValidationError('不能以数字开头')
        return name

全局钩子：

# views.py
class CheckForm(forms.Form):
    usr = forms.CharField(
        min_length=3,
        max_length=10,
        error_messages={
            'min_length': '长度至少为3',
            'max_length': '长度最多为10',
            'required': '必填项'
        },
        label="用户名",
        widget=forms.TextInput(attrs={'placeholder': '请输入用户名'})
    )
    pwd = forms.CharField(
        min_length=3,
        max_length=10,
        error_messages={
            'min_length': '长度至少为3',
            'max_length': '长度最多为10',
            'required': '必填项'
        },
        label="密码",
        widget=forms.PasswordInput(attrs={'placeholder': '请输入密码'})
    )
    re_pwd = forms.CharField(
        min_length=3,
        max_length=10,
        error_messages={
            'min_length': '长度至少为3',
            'max_length': '长度最多为10',
            'required': '必填项'
        },
        label="确认密码",
        widget=forms.PasswordInput(attrs={'placeholder': '请确认密码'})
    )
    def clean(self):
        pwd = self.cleaned_data.get('pwd')
        re_pwd = self.cleaned_data.get('re_pwd')
        if pwd == re_pwd:
            return self.cleaned_data
        from django.core.exceptions import ValidationError
        raise ValidationError('两次密码不一致')

def register(request):
    if request.method == "GET":
        check_form = CheckForm()
    if request.method == "POST":
        check_form = CheckForm(request.POST)
        if check_form.is_valid():
            return HttpResponse('注册成功')
        else:
            # 拿到全局钩子抛出的错误信息
            all_error = check_form.errors.get('__all__', None)
    return render(request, 'register.html', locals())

<form action="" method="post" novalidate>
    {% for ele in check_form %}
        <p>
            {{ ele.label }}:{{ ele }}
            <span style="color: red">{{ ele.errors.0 }}</span>
            {% if ele.label == '确认密码' %}
                <span style="color: red">{{ all_error.0 }}</span>
            {% endif %}
        </p>
    {% endfor %}
    <input type="submit" value="注册">
</form>