auth模塊簡介
auth模塊是對登錄認證方法的一種封裝,之前我們獲取用戶輸入的用戶名及密碼后需要自己從user表里查詢有沒有用戶名和密碼符合的對象,
而有了auth模塊之后就可以很輕松的去驗證用戶的登錄信息是否存在於數據庫中。
除此之外,auth還對session做了一些封裝,方便我們校驗用戶是否已登錄
auth里的方法
如果想使用auth模塊的方法,必須要先導入auth模塊
from django.contrib import auth
django.contrib.auth中提供了許多方法,這里主要介紹其中的四個:
1 、authenticate()
提供了用戶認證,即驗證用戶名以及密碼是否正確,一般需要username password兩個關鍵字參數
如果認證信息有效,會返回一個 User 對象。authenticate()會在User 對象上設置一個屬性標識那種認證后端認證了該用戶,且該信息在后面的登錄過程中是需要的。當我們試圖登陸一個從數據庫中直接取出來不經過authenticate()的User對象會報錯的!!
user = authenticate(username='someone',password='somepassword')
2 、login(HttpRequest, user)
該函數接受一個HttpRequest對象,以及一個認證了的User對象
此函數使用django的session框架給某個已認證的用戶附加上session id等信息。
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.
...
3 、logout(request) 注銷用戶
該函數接受一個HttpRequest對象,無返回值。當調用該函數時,當前請求的session信息會全部清除。該用戶即使沒有登錄,使用該函數也不會報錯。
from django.contrib.auth import logout
def logout_view(request):
logout(request)
# Redirect to a success page.
4 、user對象的 is_authenticated()
要求:
1 用戶登陸后才能訪問某些頁面,
2 如果用戶沒有登錄就訪問該頁面的話直接跳到登錄頁面
3 用戶在跳轉的登陸界面中完成登陸后,自動訪問跳轉到之前訪問的地址
方法1:
直接用auth的is_authenticated()方法驗證
def my_view(request):
if not request.user.is_authenticated():
return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))
方法2:
根據request.user.username來驗證,如果為空,則說明沒有登錄
def my_view(request):
if not request.user.username:
return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))
方法3:
django已經為我們設計好了一個用於此種情況的裝飾器:login_requierd()
from django.contrib.auth.decorators import login_required
@login_required
def my_view(request):
...
若用戶沒有登錄,則會跳轉到django默認的 登錄URL '/accounts/login/ ' (這個值可以在settings文件中通過LOGIN_URL進行修改)。並傳遞 當前訪問url的絕對路徑 (登陸成功后,會重定向到該路徑)。
user對象
User 對象屬性:username, password(必填項)password用哈希算法保存到數據庫
is_staff : 用戶是否擁有網站的管理權限.
is_active : 是否允許用戶登錄, 設置為``False``,可以不用刪除用戶來禁止 用戶登錄
2.1 、is_authenticated()
如果是真正的 User 對象,返回值恆為 True 。 用於檢查用戶是否已經通過了認證。
通過認證並不意味着用戶擁有任何權限,甚至也不檢查該用戶是否處於激活狀態,這只是表明用戶成功的通過了認證。 這個方法很重要, 在后台用request.user.is_authenticated()判斷用戶是否已經登錄,如果true則可以向前台展示request.user.name
2.2 、創建用戶
使用 create_user 輔助函數創建用戶:
from django.contrib.auth.models import User user = User.objects.create_user(username='',password='',email='')
2.3 、check_password(passwd)
user = User.objects.get(username=' ')
if user.check_password(passwd):
......
用戶需要修改密碼的時候 首先要讓他輸入原來的密碼 ,如果給定的字符串通過了密碼檢查,返回 True
使用 set_password() 來修改密碼
user = User.objects.get(username='') user.set_password(password='') user.save
2.5 、簡單示例
注冊:
def sign_up(request):
state = None
if request.method == 'POST':
password = request.POST.get('password', '')
repeat_password = request.POST.get('repeat_password', '')
email=request.POST.get('email', '')
username = request.POST.get('username', '')
if User.objects.filter(username=username):
state = 'user_exist'
else:
new_user = User.objects.create_user(username=username, password=password,email=email)
new_user.save()
return redirect('/book/')
content = {
'state': state,
'user': None,
}
return render(request, 'sign_up.html', content)
修改密碼:
@login_required
def set_password(request):
user = request.user
state = None
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:
state = 'empty'
elif new_password != repeat_password:
state = 'repeat_error'
else:
user.set_password(new_password)
user.save()
return redirect("/log_in/")
else:
state = 'password_error'
content = {
'user': user,
'state': state,
}
return render(request, 'set_password.html', content)
自己創建User表
需要注意的是,以上的所有操作,都是針對django自動創建的auth_user表的,我們可以看一下這張表的結構

這是django給我們自動創建的一張user表,而如果要用auth模塊,就必須要使用(或繼承)這張表。
繼承表的好處是我們可以增加一些自己需要的字段,並且同時可以使用auth模塊提供的接口、方法
下面就講一下繼承auth的方法:
1、導入AbstractUser類,並且寫一個自定義的類,繼承AbstractUser類,如下:
from django.contrib.auth.models import AbstractUser
class UserInfo(AbstractUser):
"""
用戶信息
"""
nid = models.AutoField(primary_key=True)
telephone = models.CharField(max_length=11, null=True, unique=True)
......
需要注意的是,UserInfo表里就不需要有auth_user里重復的字段了,比如說username以及password等,但是還是可以直接使用這些字段的,並且django會自動將password進行加密
2、這樣寫完之后,還需要在setting.py文件里配置:
AUTH_USER_MODEL = 'blog.UserInfo'
這樣,django就知道從blog項目下的models去查找UserInfo這張表了
補充,給類里的方法加裝飾器
由於類里的方法都有一個self參數,所以給類加裝飾器的與普通函數不太一樣,需要調用一個模塊的方法,如下:
from django.utils.decorators import method_decorator
class Admin(View):
@method_decorator(login_required)
def get(request):
pass
