一、forms组件

二、cookie和session组件

三、auth组件

一、forms组件

　　1.校验字段功能

　　针对一个实例：注册用户讲解

模型：models

class UserInfo(models.Model):

    name=models.CharField(max_length=32)

    pwd=models.CharField(max_length=32)

    email=models.EmailField(

模板文件

复制代码

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>Title</title>

</head>

<body>

<form action="" method="post">

    {% csrf_token %}

    <div>

        <label for="user">用户名</label>

        <p><input type="text" name="name" id="name"></p>

    </div>

    <div>

        <label for="pwd">密码</label>

        <p><input type="password" name="pwd" id="pwd"></p>

    </div>

    <div>

        <label for="r_pwd">确认密码</label>

        <p><input type="password" name="r_pwd" id="r_pwd"></p>

    </div>

     <div>

        <label for="email">邮箱</label>

        <p><input type="text" name="email" id="email"></p>

    </div>

    <input type="submit">

</form>

</body>

</html>

视图函数

# forms组件

from django.forms import widgets

wid_01=widgets.TextInput(attrs={"class":"form-control"})

wid_02=widgets.PasswordInput(attrs={"class":"form-control"})

class UserForm(forms.Form):

    name=forms.CharField(max_length=32,

                         widget=wid_01

                         )

    pwd=forms.CharField(max_length=32,widget=wid_02)

    r_pwd=forms.CharField(max_length=32,widget=wid_02)

    email=forms.EmailField(widget=wid_01)

    tel=forms.CharField(max_length=32,widget=wid_01)

def register(request):

    if request.method=="POST":

        form=UserForm(request.POST)

        if form.is_valid():

            print(form.cleaned_data)       # 所有干净的字段以及对应的值

        else:

            print(form.cleaned_data)       #

            print(form.errors)             # ErrorDict : {"校验错误的字段":["错误信息",]}

            print(form.errors.get("name")) # ErrorList ["错误信息",]

        return HttpResponse("OK")

    form=UserForm()

    return render(request,"register.html",locals())

　　2.渲染标签功能

渲染方式1

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>Title</title>

   <!-- 最新版本的 Bootstrap 核心 CSS 文件 -->

    <link rel="stylesheet" href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">

</head>

<body>

<h3>注册页面</h3>

<div class="container">

    <div class="row">

        <div class="col-md-6 col-lg-offset-3">

                <form action="" method="post">

                    {% csrf_token %}

                    <div>

                        <label for="">用户名</label>

                        {{ form.name }}

                    </div>

                    <div>

                        <label for="">密码</label>

                        {{ form.pwd }}

                    </div>

                    <div>

                        <label for="">确认密码</label>

                        {{ form.r_pwd }}

                    </div>

                    <div>

                        <label for=""> 邮箱</label>

                        {{ form.email }}

                    </div>

                    <input type="submit" class="btn btn-default pull-right">

                </form>

        </div>

    </div>

</div>

</body>

</html>

渲染方式二

<form action="" method="post">

                    {% csrf_token %}

                    {% for field in form %}

                        <div>

                            <label for="">{{ field.label }}</label>

                            {{ field }}

                        </div>

                    {% endfor %}

                    <input type="submit" class="btn btn-default pull-right">

</form>

渲染方式三、

<form action="" method="post">

    {% csrf_token %}

    {{ form.as_p }}

    <input type="submit" class="btn btn-default pull-right">

</form>

　　3、渲染错误信息功能

视图

def register(request):

    if request.method=="POST":

        form=UserForm(request.POST)

        if form.is_valid():

            print(form.cleaned_data)       # 所有干净的字段以及对应的值

        else:

            print(form.cleaned_data)       #

            print(form.errors)             # ErrorDict : {"校验错误的字段":["错误信息",]}

            print(form.errors.get("name")) # ErrorList ["错误信息",]

        return render(request,"register.html",locals())

    form=UserForm()

    return render(request,"register.html",locals()

模板

<form action="" method="post" novalidate>

    {% csrf_token %}

    {% for field in form %}

        <div>

            <label for="">{{ field.label }}</label>

            {{ field }} <span class="pull-right" style="color: red">{{ field.errors.0 }}</span>

        </div>

    {% endfor %}

    <input type="submit" class="btn btn-default">

</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': '格式错误'})

　　5.局部钩子

from django.core.exceptions import NON_FIELD_ERRORS, ValidationError

def clean_name(self):

        val=self.cleaned_data.get("name")

        ret=UserInfo.objects.filter(name=val)

        if not ret:

            return val

        else:

            raise ValidationError("该用户已注册!")

    def clean_tel(self):

        val=self.cleaned_data.get("tel")

        if len(val)==11:

            return val

        else:

            raise  ValidationError("手机号格式错误")

　　6.全局钩子

  def clean(self):

        pwd=self.cleaned_data.get('pwd')

        r_pwd=self.cleaned_data.get('r_pwd')

        if pwd and r_pwd:

            if pwd==r_pwd:

                return self.cleaned_data

            else:

                raise ValidationError('两次密码不一致')

        else:

            return self.cleaned_data

pwd_err=my_form.errors.get('__all__')

from django import forms

from django.forms import widgets

from app01 import models

from django.core.exceptions import ValidationError

class RegForm(forms.Form):

    name = forms.CharField(max_length=8, min_length=3, label='用户名',

                           error_messages={'max_length': '太长了',

                                           'min_length': '太短了',

                                           'required': '该项不能为空'

                                           },

                           widget=widgets.TextInput(attrs={'class': 'form-control'})

                           )

    pwd = forms.CharField(max_length=8, min_length=3, label='密码',

                          error_messages={'max_length': '太长了',

                                          'min_length': '太短了',

                                          'required': '该项不能为空'

                                          },

                          widget=widgets.PasswordInput(attrs={'class': 'form-control'})

                          )

    re_pwd = forms.CharField(max_length=8, min_length=3, label='确认密码',

                          error_messages={'max_length': '太长了',

                                          'min_length': '太短了',

                                          'required': '该项不能为空'

                                          },

                          widget=widgets.PasswordInput(attrs={'class': 'form-control'})

                          )

    email = forms.EmailField(label='邮箱', error_messages={'invalid': '格式不正确',

                                                         'required': '该项不能为空'

                                                         },

                             widget=widgets.EmailInput(attrs={'class': 'form-control'})

                             )

    # clean_字段名字

    def clean_name(self):

        # 从cleaned_data中取出字段的值

        name = self.cleaned_data.get('name')

        # # 校验是否以sb开头

        if name.startswith('sb'):

            raise ValidationError('不能以sb开头')

        else:

            return name

        # user = models.UserInfo.objects.filter(name=name).first()

        # if user:

        #     # 用户已经存在,校验不通过,抛一个异常

        #     raise ValidationError('该用户已经存在')

        #

        # else:

        #     # 校验通过,返回要校验的数据

        #     return name

    # def clean_pwd(self):

    #     pass

    # 全局钩子函数(上面所有校验规则都通过了,包括自定义的)

    def clean(self):

        pwd=self.cleaned_data.get('pwd')

        re_pwd=self.cleaned_data.get('re_pwd')

        if pwd==re_pwd:

            # 正确,返回self.cleaned_data

            return None

        else:

            # 校验失败,抛异常

            raise ValidationError('两次密码不一致')

myfroms

from django.shortcuts import render, HttpResponse, redirect

# Create your views here.

from app01.MyForm import RegForm

def register(request):

    if request.method == 'GET':

        myform = RegForm()

    else:

        myform = RegForm(request.POST)

        if myform.is_valid():

            # 存数据库,保存这个人

            print(myform.cleaned_data)

        else:

            # 校验不通过,这里面也可能有值

            # 总错误信息{'name':['太长了',],'pwd':['太短了']}

            # print(myform.cleaned_data)

            # 总错误

            # myform.glo_err=myform.errors.get('__all__')

            error_all = myform.errors.get('__all__')

            # print()

            # 每一个的错误信息

            # for item in myform:

            #     # ['太长了',]

            #     # print(item.errors[0])

            #     # print(type(item.errors))

            #     from django.forms.utils import ErrorList

            #     # print(item.errors.as_data())

            #     print(item.errors)

            #     # print(type(item.errors))

    return render(request, 'register.html', locals())

视图函数

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <link rel="stylesheet" href="/static/bootstrap-3.3.7-dist/css/bootstrap.css">

    <script src="/static/jquery-3.3.1.js"></script>

    <title>注册</title>

</head>

<body>

<div class="row">

    <div class="col-md-6 col-md-offset-3">

        <form action="" method="post" novalidate>

            {% for foo in myform %}

                <p>{{ foo.label }}:{{ foo }} <span class="pull-right">{{ foo.errors.0 }}</span></p>

            {% endfor %}

            <input type="submit" value="提交"><span>{{error_all.0 }}</span>

        </form>

        <hr>

        <form action="" method="post" novalidate>

            <p>用户名:{{ myform.name }} <span>{{ myform.errors.name }}</span></p>

            <p>用户名:{{ myform.pwd }} <span>{{ myform.errors.pwd }}</span></p>

            <p>用户名:{{ myform.email }} <span>{{ myform.errors.email }}</span></p>

            <input type="submit" value="提交">

        </form>

    </div>

</div>

</body>

</html>

模板

# 小结：

    -forms组件的渲染错误信息

        在模板中:<span>{{ foo.errors.0 }}</span>

    -forms使用bootstrap样式

         widget=widgets.EmailInput(attrs={'class':'form-control'}))

    -全局和局部钩子函数

        AOP:面向切面编程

        -局部钩子函数(再校验name)

        def clean_name(self):

            # 从cleaned_data中取出字段的值

            name = self.cleaned_data.get('name')

            # # 校验是否以sb开头

            if name.startswith('sb'):

                raise ValidationError('不能以sb开头')

            else:

                return name

        -全局钩子函数

        def clean(self):

            pwd=self.cleaned_data.get('pwd')

            re_pwd=self.cleaned_data.get('re_pwd')

            if pwd==re_pwd:

                # 正确,返回self.cleaned_data

                return self.cleaned_data

            else:

                # 校验失败,抛异常

                raise ValidationError('两次密码不一致')

二、cookie和session组件

　　1.什么是会话跟踪

　　我们需要了解下什么叫做会话，可以把会话理解成客户端和服务器之间的一次会晤，在一次会晤中可能会包含多次请求和响应。例如你给10086打电话，你就是客户端，10086就是服务器。双方接通电话的那一刻起，会话就开始，到某一方挂断电话表示会话结束，在通话过程中，你会向10086 发出很多请求，那么这个请求就在一个会话中。

在一个会话的多个请求中共享数据，这就是会话跟踪技术。例如在一个会话中的请求如下：  　　

　　请求银行主页；

请求登录（请求参数是用户名和密码）；
请求转账（请求参数与转账相关的数据）；
请求信誉卡还款（请求参数与还款相关的数据）。

在这上会话中当前用户信息必须在这个会话中共享的，因为登录的是张三，那么在转账和还款时一定是相对张三的转账和还款！这就说明我们必须在一个会话过程中有共享数据的能力。

　　# 会话路径技术使用cookie或session完成

我们知道HTTP协议是无状态协议，也就是说每个请求都是独立的！无法记录前一次请求的状态。但HTTP协议中可以使用Cookie来完成会话跟踪！在Web开发中，使用session来完成会话跟踪，session底层依赖Cookie技术。

　　2.cookie

cookie的由来

大家都知道HTTP协议是无状态的。

无状态的意思是每次请求都是独立的，它的执行情况和结果与前面的请求和之后的请求都无直接关系，它不会受前面的请求响应情况直接影响，也不会直接影响后面的请求响应情况。

一句有意思的话来描述就是人生只如初见，对服务器来说，每次的请求都是全新的。

状态可以理解为客户端和服务器在某次会话中产生的数据，那无状态的就以为这些数据不会被保留。会话中产生的数据又是我们需要保存的，也就是说要“保持状态”。因此Cookie就是在这样一个场景下诞生。

　　# 什么cookie

其实Cookie是key-value结构，类似于一个python中的字典。随着服务器端的响应发送给客户端浏览器。然后客户端浏览器会把Cookie保存起来，当下一次再访问服务器时把Cookie再发送给服务器。 Cookie是由服务器创建，然后通过响应发送给客户端的一个键值对。客户端会保存Cookie，并会标注出Cookie的来源（哪个服务器的Cookie）。当客户端向服务器发出请求时会把所有这个服务器Cookie包含在请求中发送给服务器，这样服务器就可以识别客户端了！

　　#cookie的原理

cookie的工作原理是:由服务器产生内容，浏览器收到请求后保存在本地，当浏览器再次访问时，浏览器会自动带上cookie，这样服务器就能通过cookie的内容来判断这个是谁了

　　#cookie规范

cookie大小上限为4kb；

一个服务器最多在浏览器上保存20个cookie

一个浏览器上最多保存300个cookie

上面的数据只是http的cookie规范，但是浏览器大战的今天，一些浏览器为了打败对手，为了展现自己的能力起见，可能对cookie规范扩展了一些，例如每个cookie大小为8kb，最多可以保存500个kb等，但也不会出现把你的硬盘占满的可能！

注意，不同的浏览器之间是不共享cookie的，也就是说在你使用IE访问浏览器时，服务器会把Cookie发给IE，然后由IE保存起来，当你在使用FireFox访问服务器时，不可能把IE保存的Cookie发送给服务器。

　　#cookie的覆盖

如果服务器发送重复大的cookie那么会覆盖原有的cookie，例如客户端的第一个请求服务器端发送的cookie是：set-cookie：a=A；第二个请求服务器端发送的是：set-cookie：a=AA，那么客户端只留下一个cookie，即a=AA

　　# 在浏览器中查看cookie

浏览器中按F12，点network--cookies就能看到

　　django中操作cookie

　　# 获取cookie

request.COOKIES['key']

request.get_signed_cookie(key, default=RAISE_ERROR, salt='', max_age=None)

参数：

default: 默认值
salt: 加密盐
max_age: 后台控制过期时间

　　# 设置cookie

rep = HttpResponse(...)

rep ＝ render(request, ...)

rep.set_cookie(key,value)

rep.set_signed_cookie(key,value,salt='加密盐')

参数：

key, 键
value='', 值
max_age=None, 超时时间 cookie需要延续的时间（以秒为单位）如果参数是\ None`` ，这个cookie会延续到浏览器关闭为止
expires=None, 超时时间(IE requires expires, so set it if hasn't been already.)
path='/', Cookie生效的路径，/ 表示根路径，特殊的：根路径的cookie可以被任何url的页面访问，浏览器只会把cookie回传给带有该路径的页面，这样可以避免将cookie传给站点中的其他的应用。
domain=None, Cookie生效的域名你可用这个参数来构造一个跨站cookie。如， domain=".example.com"所构造的cookie对下面这些站点都是可读的：www.example.com 、 www2.example.com 和an.other.sub.domain.example.com 。如果该参数设置为 None ，cookie只能由设置它的站点读取
secure=False, 浏览器将通过HTTPS来回传cookie
httponly=False 只能http协议传输，无法被JavaScript获取（不是绝对，底层抓包可以获取到也可以被覆盖）

　　#删除cookie

def logout(request):

    rep = redirect("/login/")

    rep.delete_cookie("user")  # 删除用户浏览器上之前设置的usercookie值

    return rep

　　#cookie版登录校验

def login_auth(func):

    def inner(request,*args,**kwargs):

        next_url=request.get_full_path()

        if request.COOKIES.get('is_login'):

            return func(request,*args,**kwargs)

        else:

            return redirect('cookie_login/?next=%s'%next_url)

    return inner

@login_auth

def cookie_order(request):

    return HttpResponse('我是订单页面')

@login_auth

def cookie_index(request):

    name=request.COOKIES.get('username')

    return render(request,'cookie_index.html',{'name':name})

def cookie_login(request):

    if request.method =='POST':

        next_url=request.GET.get('next')

        name=request.POST.get('name')

        password=request.POST.get('password')

        if name == 'lqz' and password == '':

            import datetime

            now=datetime.datetime.now().strftime('%Y-%m-%d %X')

            print(now)

            obj=redirect(next_url)

            obj.set_cookie('is_login',True)

            obj.set_cookie('username',name)

            obj.set_cookie('login_time',now)

            return obj

    return render(request, 'cookie_login.html')

登录认证装饰器

　　3.session

　　# session的由来

Cookie虽然在一定程度上解决了“保持状态”的需求，但是由于Cookie本身最大支持4096字节，以及Cookie本身保存在客户端，可能被拦截或窃取，因此就需要有一种新的东西，它能支持更多的字节，并且他保存在服务器，有较高的安全性。这就是Session。

问题来了，基于HTTP协议的无状态特征，服务器根本就不知道访问者是“谁”。那么上述的Cookie就起到桥接的作用。

我们可以给每个客户端的Cookie分配一个唯一的id，这样用户在访问时，通过Cookie，服务器就知道来的人是“谁”。然后我们再根据不同的Cookie的id，在服务器上保存一段时间的私密资料，如“账号密码”等等。

总结而言：Cookie弥补了HTTP无状态的不足，让服务器知道来的人是“谁”；但是Cookie以文本的形式保存在本地，自身安全性较差；所以我们就通过Cookie识别不同的用户，对应的在Session里保存私密的信息以及超过4096字节的文本。

另外，上述所说的Cookie和Session其实是共通性的东西，不限于语言和框架。

　　#django中的session相关方法

# 获取、设置、删除Session中数据

request.session['k1']

request.session.get('k1',None)

request.session['k1'] = 123

request.session.setdefault('k1',123) # 存在则不设置

del request.session['k1']

# 所有 键、值、键值对

request.session.keys()

request.session.values()

request.session.items()

request.session.iterkeys()

request.session.itervalues()

request.session.iteritems()

# 会话session的key

request.session.session_key

# 将所有Session失效日期小于当前日期的数据删除

request.session.clear_expired()

# 检查会话session的key在数据库中是否存在

request.session.exists("session_key")

# 删除当前会话的所有Session数据(只删数据库)

request.session.delete()

　　

# 删除当前的会话数据并删除会话的Cookie（数据库和cookie都删）。

request.session.flush()

    这用于确保前面的会话数据不可以再次被用户的浏览器访问

    例如，django.contrib.auth.logout() 函数中就会调用它。

# 设置会话Session和Cookie的超时时间

request.session.set_expiry(value)

    * 如果value是个整数，session会在些秒数后失效。

    * 如果value是个datatime或timedelta，session就会在这个时间后失效。

    * 如果value是0,用户关闭浏览器session就会失效。

    * 如果value是None,session会依赖全局session失效策略。

Django中使用session时，做的事：

# 生成随机字符串

# 写浏览器cookie -> session_id: 随机字符串

# 写到服务端session：

    # {

    #     "随机字符串": {'user':'alex'}

    # }

　　# django中的session配置

1. 数据库Session

SESSION_ENGINE = 'django.contrib.sessions.backends.db'   # 引擎（默认）

2. 缓存Session

SESSION_ENGINE = 'django.contrib.sessions.backends.cache'  # 引擎

SESSION_CACHE_ALIAS = 'default'                            # 使用的缓存别名（默认内存缓存，也可以是memcache），此处别名依赖缓存的设置

3. 文件Session

SESSION_ENGINE = 'django.contrib.sessions.backends.file'    # 引擎

SESSION_FILE_PATH = None                                    # 缓存文件路径，如果为None，则使用tempfile模块获取一个临时地址tempfile.gettempdir() 

4. 缓存+数据库

SESSION_ENGINE = 'django.contrib.sessions.backends.cached_db'        # 引擎

5. 加密Cookie Session

SESSION_ENGINE = 'django.contrib.sessions.backends.signed_cookies'   # 引擎

其他公用设置项：

SESSION_COOKIE_NAME ＝ "sessionid"                       # Session的cookie保存在浏览器上时的key，即：sessionid＝随机字符串（默认）

SESSION_COOKIE_PATH ＝ "/"                               # Session的cookie保存的路径（默认）

SESSION_COOKIE_DOMAIN = None                             # Session的cookie保存的域名（默认）

SESSION_COOKIE_SECURE = False                            # 是否Https传输cookie（默认）

SESSION_COOKIE_HTTPONLY = True                           # 是否Session的cookie只支持http传输（默认）

SESSION_COOKIE_AGE = 1209600                             # Session的cookie失效日期（2周）（默认）

SESSION_EXPIRE_AT_BROWSER_CLOSE = False                  # 是否关闭浏览器使得Session过期（默认）

SESSION_SAVE_EVERY_REQUEST = False                       # 是否每次请求都保存Session，默认修改之后才保存（默认）

思考，如果第二人再次在同一个浏览器上登录，django-session表会怎样

　　# CBV中加装饰器

from django import views

from django.utils.decorators import method_decorator

# @method_decorator(login_auth,name='get')

# @method_decorator(login_auth,name='post')

class UserList(views.View):

    # @method_decorator(login_auth)

    def dispatch(self, request, *args, **kwargs):

        obj=super().dispatch(request, *args, **kwargs)

        return obj

    @method_decorator(login_auth)

    def get(self,request):

        return HttpResponse('我是用户列表')

    def post(self,request):

        return HttpResponse('我是用户列表')

三、auth组件

　　1.Auth模块是什么

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

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

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

　　2.auth模块常用方法

导入模块

from django.contrib import auth

　　#authenticate()

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

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

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

用法：

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

　　#login(HttpRequest,user)

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

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

用法：

from django.contrib.auth import authenticate, login

def my_view(request):

  username = request.POST['username']

  password = request.POST['password']

  user = authenticate(username=username, password=password)

  if user is not None:

    login(request, user)

    # Redirect to a success page.

    ...

  else:

    # Return an 'invalid login' error message.

    ...

　　#logout(request)

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

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

用法：

from django.contrib.auth import logout

def logout_view(request):

  logout(request)

  # Redirect to a success page.

　　# is_authenticated()

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

用法：

def my_view(request):

  if not request.user.is_authenticated():

    return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))

　　#login_requier()

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

用法：

from django.contrib.auth.decorators import login_required

@login_required

def my_view(request):

  ...

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

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

示例：

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

　　#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='邮箱',...）

　　#check_password(password)

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

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

用法：

ok = user.check_password('密码')

Auth模块

本文目录

回到目录

1 Auth模块是什么

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

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

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

回到目录

2 auth模块常用方法

from django.contrib import auth

authenticate()

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

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

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

用法：

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

login(HttpRequest, user)

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

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

用法：

from django.contrib.auth import authenticate, login

def my_view(request):

  username = request.POST['username']

  password = request.POST['password']

  user = authenticate(username=username, password=password)

  if user is not None:

    login(request, user)

    # Redirect to a success page.

    ...

  else:

    # Return an 'invalid login' error message.

    ...

logout(request)

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

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

用法：

from django.contrib.auth import logout

def logout_view(request):

  logout(request)

  # Redirect to a success page.

is_authenticated()

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

用法：

def my_view(request):

  if not request.user.is_authenticated():

    return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))

login_requierd()

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

用法：

from django.contrib.auth.decorators import login_required

@login_required

def my_view(request):

  ...

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

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

示例：

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

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='邮箱',...）

check_password(password)

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

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

用法：

ok = user.check_password('密码')

set_password(password)

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

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

用法：

user.set_password(password='')

user.save()

@login_required

def set_password(request):

    user = request.user

    err_msg = ''

    if request.method == 'POST':

        old_password = request.POST.get('old_password', '')

        new_password = request.POST.get('new_password', '')

        repeat_password = request.POST.get('repeat_password', '')

        # 检查旧密码是否正确

        if user.check_password(old_password):

            if not new_password:

                err_msg = '新密码不能为空'

            elif new_password != repeat_password:

                err_msg = '两次密码不一致'

            else:

                user.set_password(new_password)

                user.save()

                return redirect("/login/")

        else:

            err_msg = '原密码输入错误'

    content = {

        'err_msg': err_msg,

    }

    return render(request, 'set_password.html', content)

修改过的简单事例

　　#User对象属性

User对象属性：username， password

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

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

　　3.扩展默认的auth_user表

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

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

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

答案是当然有了。

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

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

from django.contrib.auth.models import AbstractUser

class UserInfo(AbstractUser):

    """

    用户信息表

    """

    nid = models.AutoField(primary_key=True)

    phone = models.CharField(max_length=11, null=True, unique=True)

    def __str__(self):

        return self.username

注意：

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

# 引用Django自带的User表，继承使用时需要设置

AUTH_USER_MODEL = "app名.UserInfo"

再次注意：

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

巴特西

Django：forms局部函数、cookie、sesion、auth模块