Django-內置用戶系統

Django自帶的用戶認證

我們在開發一個網站的時候，無可避免的需要設計實現網站的用戶系統。此時我們需要實現包括
1.用戶注冊
2.用戶登錄
3.用戶認證
4.注銷
5.修改密碼

Django作為一個完美主義者的終極框架，當然也會想到用戶的這些痛點。它內置了強大的用戶認證系統--auth，它默認使用 auth_user 表來存儲用戶數據。

auth模塊

from django.contrib import auth

auth中提供了許多實用方法：

authenticate()

提供了用戶認證功能，即驗證用戶名以及密碼是否正確，一般需要username 、password兩個關鍵字參數。
如果認證成功（用戶名和密碼正確有效），便會返回一個 User 對象。
authenticate()會在該 User 對象上設置一個屬性來標識后端已經認證了該用戶，且該信息在后續的登錄過程中是需要的。

用法：

user = authenticate(username='theuser',password='thepassword')

login(HttpRequest, user)

該函數接受一個HttpRequest對象，以及一個經過認證的User對象。
該函數實現一個用戶登錄的功能。它本質上會在后端為該用戶生成相關session數據。

用法：

from django.contrib.auth import authenticate, logindef my_view(request):username = request.POST['username']password = request.POST['password']user_obj = authenticate(username=username, password=password)if user_obj:login(request, user_obj)# Redirect to a success page....else:# Return an 'invalid login' error message....

注意：
只要使用login(request, user_obj)之后，request.user就能拿到當前登錄的用戶對象。否則request.user得到的是一個匿名用戶對象（AnonymousUser Object）。
詳細原理請查看 AuthenticationMiddleware 中間件源碼。

logout(request)

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

from django.contrib.auth import logoutdef 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()

auth 提供的一個創建新的超級用戶的方法，需要提供必要參數（username、password）等。
用法：

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

check_password(raw_password)

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

ok = user_obj.check_password('密碼')

或者直接針對當前請求的user對象校驗原密碼是否正確：

ok = request.user.check_password(raw_password='原密碼')

set_password(raw_password)

auth 提供的一個修改密碼的方法，接收 要設置的新密碼 作為參數。
注意：設置完一定要調用用戶對象的save方法！！！
用法：

user_obj.set_password('新密碼')
user_obj.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_obj能夠拿到認證所用用戶表的數據屬性，比如username， password等。
其他常用屬性含義如下：
is_staff ： 用戶是否擁有網站的管理權限.
is_active ： 是否允許用戶登錄, 設置為 False，可以在不刪除用戶的前提下禁止用戶登錄。

擴展默認的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表那樣使用我們的UserInfo表了。比如：
創建普通用戶：

UserInfo.objects.create_user(username='用戶名', password='密碼')

創建超級用戶：

UserInfo.objects.create_superuser(username='用戶名', password='密碼')

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