Django之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_authrnticated()

　　用來判斷當前請求是否經過來認證。

　　用法：

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，則須要在setting.py文件中經過LOHGIN_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提供的一個檢查密碼是否正確的方法，須要提供當前請求用戶的密碼。

　　密碼正確返回Ture，不然返回False。

　　用法：

ok = user.check_password('密碼')

　　#set_passwoed(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，我如今使用我新定義的Userinfo表來作用戶認證，寫法以下：

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

 

　　在此注意：

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