Auth認證模塊

1.什麼是Auth模塊?

Auth模塊是Django自帶的用戶認證模塊。 咱們在開發大多數網站時,無可避免的就是須要用戶的登陸,註冊,註銷,及修改密碼等功能。javascript

而Django幫咱們都封裝好了,Auth模塊內置了強大的用戶認證統一auth,它默認使用auth_user表來存儲用戶數據。java

 

2.auth模塊經常使用方法

from django.contrib import auth

 

authenticate()

提供了用戶認證功能,能夠驗證用戶名密碼是否正確。數據庫

若是認證成功了,他會返回一個User對象django

authenticate()會在該User對象上設置一個屬性來標識後端已經認證了該用戶。後端

這個User對象在後續的登陸過程當中時須要的。session

用法:app

user = authenticate(username='username',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_required()

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)等.

用法:

user =models.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(passwowrd)

auth 提供的一個修改密碼的方法,接收 要設置的新密碼 做爲參數。

注意:設置完必定要調用用戶對象的save方法!!!

用法:

user.set_password(password='')
user.save()

 

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表了。

相關文章
相關標籤/搜索