auth認證模塊
Django 自帶的用戶驗證：
可以實現用戶註冊、用戶登錄、用戶認證、註銷、修改密碼等功能；
auth模塊：
from django.contrib import auth
auth中的方法：
1）、authenticate()
提供了用戶認證功能，即驗證用戶名以及密碼是否正確，一般需要username 、password兩個關鍵字參數。
如果認證成功（用戶名和密碼正確有效），便會返回一個 User 對象。
authenticate()會在該 User 對象上設置一個屬性來標識後端已經認證了該用戶，且該信息在後續的登錄過程中是需要的。
用法：
user = authenticate(username=‘theuser‘,password=‘thepassword‘)
2)、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.
...
3)、logout(request)
該函數接受一個HttpRequest對象，無返回值。
當調用該函數時，當前請求的session信息會全部清除。該用戶即使沒有登錄，使用該函數也不會報錯。
用法：
from django.contrib.auth import logout def logout_view(request): logout(request) # Redirect to a success page
4)、is_authenticated()
用來判斷當前請求是否通過了認證。
用法：
def my_view(request):
if not request.user.is_authenticated():
return redirect(‘%s?next=%s‘ % (settings.LOGIN_URL, request.path))
5)、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/‘ # 這裏配置成你項目登錄頁面的路由
6）、create_user()
auth提供的一個創建新用戶的方法，需要提供必要參數(username,password)等。
用法：
from django.contrib.auth.models import User user = User.objects.create_superuser（username=‘用戶名‘,password=‘密碼‘,email=‘郵箱‘,...）
7)、check_password(password)
auth提供的一個檢查密碼是否正確的方法，需要提供的當前請求用戶的密碼。
密碼正確返回True，否則就返回False
用法：
ok = user.check_password(‘密碼‘)
8)、set_password(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)
修改密碼示例
9）、User對象的屬性：
User對象屬性：username, password
is_staff: 用戶是否擁有網站的管理權限。
is_active: 是否允許用戶登錄，設置為False，可以在不刪除用戶的前提下禁止用戶登錄。
10)、擴展默認的auth_user表
a、可以通過新建另外一張表，然後一對一關聯內置的auth_user表
b、我們可以通過繼承內置的 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表了。
Django自帶的用戶認證
我們在開發一個網站的時候，無可避免的需要設計實現網站的用戶系統。此時我們需要實現包括用戶註冊、用戶登錄、用戶認證、註銷、修改密碼等功能，這還真是個麻煩的事情呢。
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數據。
用法：
按 Ctrl+C 復制代碼 按 Ctrl+C 復制代碼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_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 = User.objects.create_superuser（username=‘用戶名‘,password=‘密碼‘,email=‘郵箱‘,...）
check_password(password)
auth 提供的一個檢查密碼是否正確的方法，需要提供當前請求用戶的密碼。
密碼正確返回True，否則返回False。
用法：
ok = user.check_password(‘密碼‘)
set_password(password)
auth 提供的一個修改密碼的方法，接收 要設置的新密碼 作為參數。
註意：設置完一定要調用用戶對象的save方法！！！
用法：
user.set_password(password=‘‘) user.save()
一個修改密碼功能的簡單示例
按 Ctrl+C 復制代碼 按 Ctrl+C 復制代碼User對象的屬性
User對象屬性：username， password
is_staff ： 用戶是否擁有網站的管理權限.
is_active ： 是否允許用戶登錄, 設置為 False，可以在不刪除用戶的前提下禁止用戶登錄。
擴展默認的auth_user表
這內置的認證系統這麽好用，但是auth_user表字段都是固定的那幾個，我在項目中沒法拿來直接使用啊！
比如，我想要加一個存儲用戶手機號的字段，怎麽辦？
聰明的你可能會想到新建另外一張表然後通過一對一和內置的auth_user表關聯，這樣雖然能滿足要求但是有沒有更好的實現方式呢？
答案是當然有了。
我們可以通過繼承內置的 AbstractUser 類，來定義一個自己的Model類。
這樣既能根據項目需求靈活的設計用戶表，又能使用Django強大的認證系統了。
按 Ctrl+C 復制代碼 按 Ctrl+C 復制代碼註意：
按上面的方式擴展了內置的auth_user表之後，一定要在settings.py中告訴Django，我現在使用我新定義的UserInfo表來做用戶認證。寫法如下：
# 引用Django自帶的User表，繼承使用時需要設置 AUTH_USER_MODEL = "app名.UserInfo"
再次註意：
一旦我們指定了新的認證系統所使用的表，我們就需要重新在數據庫中創建該表，而不能繼續使用原來默認的auth_user表了。
auth認證模塊