Auth認證模塊

本文目錄

• 1 Auth模塊是什么
• 2 auth模塊常用方法
• 3 擴展默認的auth_user表

回到目錄

1 Auth模塊是什么

Auth模塊是Django自帶的用戶認證模塊：

我們在開發(fā)一個網(wǎng)站的時候，無可避免的需要設(shè)計實現(xiàn)網(wǎng)站的用戶系統(tǒng)。此時我們需要實現(xiàn)包括用戶注冊、用戶登錄、用戶認證、注銷、修改密碼等功能，這還真是個麻煩的事情呢。

Django作為一個完美主義者的終極框架，當(dāng)然也會想到用戶的這些痛點。它內(nèi)置了強大的用戶認證系統(tǒng)--auth，它默認使用 auth_user 表來存儲用戶數(shù)據(jù)。

回到目錄

2 auth模塊常用方法

from django.contrib import auth

?

authenticate()

提供了用戶認證功能，即驗證用戶名以及密碼是否正確，一般需要username 、password兩個關(guān)鍵字參數(shù)。

如果認證成功（用戶名和密碼正確有效），便會返回一個 User 對象。

authenticate()會在該 User 對象上設(shè)置一個屬性來標(biāo)識后端已經(jīng)認證了該用戶，且該信息在后續(xù)的登錄過程中是需要的。

用法：

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

?

login(HttpRequest, user)

該函數(shù)接受一個HttpRequest對象，以及一個經(jīng)過認證的User對象。

該函數(shù)實現(xiàn)一個用戶登錄的功能。它本質(zhì)上會在后端為該用戶生成相關(guān)session數(shù)據(jù)。

用法：

from django.contrib.auth import authenticate, logindef 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)

該函數(shù)接受一個HttpRequest對象，無返回值。

當(dāng)調(diào)用該函數(shù)時，當(dāng)前請求的session信息會全部清除。該用戶即使沒有登錄，使用該函數(shù)也不會報錯。

用法：

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

?

is_authenticated()

用來判斷當(dāng)前請求是否通過了認證。

用法：

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

?

若用戶沒有登錄，則會跳轉(zhuǎn)到django默認的 登錄URL '/accounts/login/ ' 并傳遞當(dāng)前訪問url的絕對路徑 (登陸成功后，會重定向到該路徑)。

如果需要自定義登錄的URL，則需要在settings.py文件中通過LOGIN_URL進行修改。

示例：

LOGIN_URL = '/login/' # 這里配置成你項目登錄頁面的路由

?

create_user()

auth 提供的一個創(chuàng)建新用戶的方法，需要提供必要參數(shù)（username、password）等。

用法：

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

?

create_superuser()

auth 提供的一個創(chuàng)建新的超級用戶的方法，需要提供必要參數(shù)（username、password）等。

用法：

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

?

check_password(password)

auth 提供的一個檢查密碼是否正確的方法，需要提供當(dāng)前請求用戶的密碼。

密碼正確返回True，否則返回False。

用法：

ok = user.check_password('密碼')

?

set_password(password)

auth 提供的一個修改密碼的方法，接收 要設(shè)置的新密碼 作為參數(shù)。

注意：設(shè)置完一定要調(diào)用用戶對象的save方法！！！

用法：

user.set_password(password='') user.save() @login_required def set_password(request):user = request.usererr_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 ： 用戶是否擁有網(wǎng)站的管理權(quán)限.

is_active ： 是否允許用戶登錄, 設(shè)置為 False，可以在不刪除用戶的前提下禁止用戶登錄。

回到目錄

3 擴展默認的auth_user表

這內(nèi)置的認證系統(tǒng)這么好用，但是auth_user表字段都是固定的那幾個，我在項目中沒法拿來直接使用啊！

比如，我想要加一個存儲用戶手機號的字段，怎么辦？

聰明的你可能會想到新建另外一張表然后通過一對一和內(nèi)置的auth_user表關(guān)聯(lián)，這樣雖然能滿足要求但是有沒有更好的實現(xiàn)方式呢？

答案是當(dāng)然有了。

我們可以通過繼承內(nèi)置的 AbstractUser 類，來定義一個自己的Model類。

這樣既能根據(jù)項目需求靈活的設(shè)計用戶表，又能使用Django強大的認證系統(tǒng)了。

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

?

注意：

按上面的方式擴展了內(nèi)置的auth_user表之后，一定要在settings.py中告訴Django，我現(xiàn)在使用我新定義的UserInfo表來做用戶認證。寫法如下：

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

?

再次注意：

一旦我們指定了新的認證系統(tǒng)所使用的表，我們就需要重新在數(shù)據(jù)庫中創(chuàng)建該表，而不能繼續(xù)使用原來默認的auth_user表了。

?

轉(zhuǎn)載于:https://www.cnblogs.com/Ryan-Yuan/p/11587436.html

總結(jié)

以上是生活随笔為你收集整理的Auth认证模块的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。