Django之auth模塊（用戶認證）登錄組件

auth模塊簡介

auth模塊是對登陸認證方法的一種封裝，以前咱們獲取用戶輸入的用戶名及密碼後須要本身從user表裏查詢有沒有用戶名和密碼符合的對象，javascript

而有了auth模塊以後就能夠很輕鬆的去驗證用戶的登陸信息是否存在於數據庫中。html

除此以外，auth還對session作了一些封裝，方便咱們校驗用戶是否已登陸java

auth裏的方法

若是想使用auth模塊的方法，必需要先導入auth模塊python

from django.contrib import auth

django.contrib.auth中提供了許多方法，這裏主要介紹其中的四個：算法

1 、authenticate()

提供了用戶認證，即驗證用戶名以及密碼是否正確,通常須要username password兩個關鍵字參數數據庫

若是認證信息有效，會返回一個 User 對象。authenticate()會在User 對象上設置一個屬性標識那種認證後端認證了該用戶，且該信息在後面的登陸過程當中是須要的。當咱們試圖登錄一個從數據庫中直接取出來不通過authenticate()的User對象會報錯的！！django

user = authenticate(username='someone',password='somepassword')

2 、login(HttpRequest, user)　　

該函數接受一個HttpRequest對象，以及一個認證了的User對象後端

此函數使用django的session框架給某個已認證的用戶附加上session id等信息。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.
        ...

3 、logout(request) 註銷用戶　　

該函數接受一個HttpRequest對象，無返回值。當調用該函數時，當前請求的session信息會所有清除。該用戶即便沒有登陸，使用該函數也不會報錯。框架

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

4 、user對象的 is_authenticated()

要求：

1 用戶登錄後才能訪問某些頁面，

2 若是用戶沒有登陸就訪問該頁面的話直接跳到登陸頁面

3 用戶在跳轉的登錄界面中完成登錄後，自動訪問跳轉到以前訪問的地址

方法1:

直接用auth的is_authenticated()方法驗證

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

方法2:

根據request.user.username來驗證，若是爲空，則說明沒有登陸

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

方法3:

django已經爲咱們設計好了一個用於此種狀況的裝飾器：login_requierd()

from django.contrib.auth.decorators import login_required
      
@login_required
def my_view(request):
  ...

若用戶沒有登陸，則會跳轉到django默認的登陸URL '/accounts/login/ ' (這個值能夠在settings文件中經過LOGIN_URL進行修改)。並傳遞當前訪問url的絕對路徑 (登錄成功後，會重定向到該路徑)。

user對象

User 對象屬性：username， password（必填項）password用哈希算法保存到數據庫

is_staff ：用戶是否擁有網站的管理權限.

is_active ：是否容許用戶登陸, 設置爲``False``，能夠不用刪除用戶來禁止用戶登陸

2.1 、is_authenticated()

若是是真正的 User 對象，返回值恆爲 True 。用於檢查用戶是否已經經過了認證。
經過認證並不意味着用戶擁有任何權限，甚至也不檢查該用戶是否處於激活狀態，這只是代表用戶成功的經過了認證。這個方法很重要, 在後臺用request.user.is_authenticated()判斷用戶是否已經登陸，若是true則能夠向前臺展現request.user.name

2.2 、建立用戶

使用 create_user 輔助函數建立用戶:

from django.contrib.auth.models import User
user = User.objects.create_user（username='',password='',email=''）

2.3 、check_password(passwd)

user = User.objects.get(username=' ')
if user.check_password(passwd):
    ......

用戶須要修改密碼的時候首先要讓他輸入原來的密碼，若是給定的字符串經過了密碼檢查，返回 True

使用 set_password() 來修改密碼

user = User.objects.get(username='')
user.set_password(password='')
user.save

2.5 、簡單示例

註冊：

def sign_up(request):
 
    state = None
    if request.method == 'POST':
 
        password = request.POST.get('password', '')
        repeat_password = request.POST.get('repeat_password', '')
        email=request.POST.get('email', '')
        username = request.POST.get('username', '')
        if User.objects.filter(username=username):
                state = 'user_exist'
        else:
                new_user = User.objects.create_user(username=username, password=password,email=email)
                new_user.save()
 
                return redirect('/book/')
    content = {
        'state': state,
        'user': None,
    }
    return render(request, 'sign_up.html', content)

修改密碼：

@login_required
def set_password(request):
    user = request.user
    state = None
    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:
                state = 'empty'
            elif new_password != repeat_password:
                state = 'repeat_error'
            else:
                user.set_password(new_password)
                user.save()
                return redirect("/log_in/")
        else:
            state = 'password_error'
    content = {
        'user': user,
        'state': state,
    }
    return render(request, 'set_password.html', content)

本身建立User表

須要注意的是，以上的全部操做，都是針對django自動建立的auth_user表的，咱們能夠看一下這張表的結構

這是django給咱們自動建立的一張user表，而若是要用auth模塊，就必需要使用（或繼承）這張表。

繼承表的好處是咱們能夠增長一些本身須要的字段，而且同時可使用auth模塊提供的接口、方法

下面就講一下繼承auth的方法：

一、導入AbstractUser類，而且寫一個自定義的類，繼承AbstractUser類，以下：

from django.contrib.auth.models import AbstractUser

class UserInfo(AbstractUser):
    """
    用戶信息
    """
    nid = models.AutoField(primary_key=True)
    telephone = models.CharField(max_length=11, null=True, unique=True)
   ......

須要注意的是，UserInfo表裏就不須要有auth_user裏重複的字段了，好比說username以及password等，可是仍是能夠直接使用這些字段的，而且django會自動將password進行加密

二、這樣寫完以後，還須要在setting.py文件裏配置：

AUTH_USER_MODEL = 'blog.UserInfo'

這樣，django就知道從blog項目下的models去查找UserInfo這張表了