目錄

• Django自帶的用戶認證
  • auth模塊
    • authenticate()
    • login(HttpRequest, user)　
    • logout(request)
    • is_authenticated()
    • login_requierd()
    • create_user()
    • create_superuser()
    • check_password(password)
    • set_password(password)
    • User對象的屬性
  • 擴展默認的auth_user表

Django自帶的用戶認證

我們在開發一個網站的時候，無可避免的需要設計實現網站的用戶系統。此時我們需要實現包括用戶註冊、用戶登錄、用戶認證、註銷、修改密碼等功能，這個功能的實現相當的麻煩。
Django作為一個完美主義者的終極框架，內置了強大的用戶認證系統-auth，它默認使用auth_user表來存儲用戶數據

auth模塊

from django.contrib import auth

auth中提供了許多實現方法

authenticate()

提供了用戶認證功能嗎，即檢驗用戶名以及密碼是否鄭雪，一般需要username,password兩個關鍵字參數。
如果認證成功，變回返回一個user對象。
authenticate()會在該user()對象上設置一個屬性來標識後端已經認證了該用戶，且該信息在後續的登錄過程中是需要的。
用法：

user = authenticate(username=‘wph‘, password=‘123123‘)

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()

創建新的超級用戶的方法，需要提供必要參數(username，password)等。
用法：

from django.contrib.auth.models import User
user = User.objects.create_superuser（username=‘用戶名‘,password=‘密碼‘,email=‘郵箱‘,...）

check_password(password)

檢查密碼是否正確的方法，需要提供當前請求用戶的密碼.
密碼正確返回True，負責返回False。
用法：

ok = user.check_password(‘密碼‘)

set_password(password)

修改密碼的方法，接收要設置的新密碼座位參數。
註意：設置完一定要調用用戶對象的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，可以在不刪除用戶的前提下禁止用戶登錄。

擴展默認的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，我現在使用我新定義的UserInfo表來做用戶認證。寫法如下：

# 引用Django自帶的User表，繼承使用時需要設置
AUTH_USER_MODEL = "app名.UserInfo"

一旦我們指定了新的認證系統所使用的表，我們就需要重新在數據庫中創建該表，而不能繼續使用原來默認的auth_user表了。

Django自帶的認證系統