Web框架之Django_10 重要組件(Auth模塊)

1、auth模塊介紹

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

咱們在開發一個網站的時候,無可避免的須要設計實現網站的用戶系統。此時咱們須要實現包括用戶註冊、用戶登陸、用戶認證、註銷、修改密碼等功能,這還真是個麻煩的事情呢。html

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

2、auth模塊經常使用方法

from django.contrib import auth

## create_superuser()

auth 提供的一個建立新的超級用戶的方法,須要提供必要參數(username、password)等。java

用法:數據庫

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

還能夠在菜單欄tool中Run manage.py Task下進行命令行建立超級用戶:createsuperuser而後根據提示建立便可django

## create_user()

auth 提供的一個建立新用戶的方法,須要提供必要參數(username、password)等,該方法和建立超級用戶同樣,只不過用戶權限會有差異後端

用法:session

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

tip:Run manage.py Task下沒法建立普通用戶app

## authenticate()

提供了用戶認證功能,即驗證用戶名以及密碼是否正確,通常須要username 、password兩個關鍵字參數。框架

若是認證成功(用戶名和密碼正確有效),便會返回一個 User 對象。

authenticate()會在該 User 對象上設置一個屬性來標識後端已經認證了該用戶,且該信息在後續的登陸過程當中是須要的。

用法:

user = authenticate(username='usernamer',password='password')  # 用戶名和密碼都要傳才行

## login(HttpRequest, user)

該函數接受一個HttpResponse對象,以及一個通過認證的User對象

該函數實現一個用戶登陸的功能,本質上會在後端爲該用戶生成相關的session數據

用法:

urls.py
url(r'^login/', views.my_login),

views.py from django.contrib.auth import authenticate,login

def my_login(request):
    if request.method == 'POST':
        # 獲取前端帳號密碼
        username = request.POST['username']
        password = request.POST['password']
        # 用戶認證
        user = authenticate(username=username, password=password)
        # 用戶認證成功
        if user:
            # 實現用戶登陸功能,爲該用戶建立生成session數據
            login(request, user)  # 這裏只要執行了login(request, user),在後端任何地方均可以經過request.user拿到當前登陸的用戶對象 return render(request, 'index.html')
        # 認證不成功,說明用戶名密碼錯誤
        else:
            return HttpResponse('用戶名或密碼錯誤,登陸失敗')
    return render(request, 'login.html')

login.html <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>登陸</title>
</head>
<body>
<form action="" method="post">
    {% csrf_token %}
    <p>用戶名:<input type="text" name="username"></p>
    <p>密碼:<input type="password" name="password"></p>
    <p><input type="submit"></p>
</form>
</body>
</html> index.html <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>主頁面</title>
</head>
<body>
<h1>我是登陸後才能看到的頁面</h1>
</body>
</html>

 

 

## logout(request) 

該函數接受一個HttpRequest對象,無返回值。

當調用該函數時,當前請求的session信息會所有清除。該用戶即便沒有登陸,使用該函數也不會報錯。

用法:

from django.contrib.auth import logout
def my_logout(request):
    logout(request)
    return redirect('/home/')


def my_home(request):
    return render(request, 'home.html')

## 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_required(login_url='/auth_login/')  
# 全局配置 
    # auth自動跳轉
    LOGIN_URL = '/auth_login/'  # settings.py配置

實例:

# 導入用戶認證模塊和login函數
from django.contrib.auth import authenticate,login

def my_login(request):
    if request.method == 'POST':
        # 獲取前端帳號密碼
        username = request.POST['username']
        password = request.POST['password']
        next_url = request.GET.get('next')  # 獲取到跳轉過來的原頁面的url
        # 用戶認證
        user = authenticate(username=username, password=password)
        # 用戶認證成功
        if user:
            # 實現用戶登陸功能,爲該用戶建立生成session數據
            login(request, user)
            return redirect(next_url)  # 登陸成功自動跳轉到原來的頁面
        # 認證不成功,說明用戶名密碼錯誤
        else:
            return HttpResponse('用戶名或密碼錯誤,登陸失敗')
    return render(request, 'login.html')

from django.contrib.auth.decorators import login_required
# Django登陸驗證裝飾器在跳轉到登錄頁面時候會自動在頁面末尾拼接一個?next=當前url
@login_required
def my_home(request):
    return render(request, 'home.html')

 

## check_password(password)

auth 提供的一個檢查密碼是否正確的方法,須要提供當前請求用戶的密碼。

密碼正確返回True,不然返回False。

用法:

ok = user.check_password('密碼')

## 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)
修改密碼

## User對象的屬性

User對象屬性:username, password

is_staff : 用戶是否擁有網站的管理權限.

is_active : 是否容許用戶登陸, 設置爲 False,能夠在不刪除用戶的前提下禁止用戶登陸。

3、擴展默認的auth_user表

這內置的認證系統這麼好用,可是auth_user表字段都是固定的那幾個,我在項目中無法拿來直接使用啊!

好比,我想要加一個存儲用戶手機號的字段,怎麼辦?

聰明的你可能會想到新建另一張表而後經過一對一和內置的auth_user表關聯,這樣雖然能知足要求可是有沒有更好的實現方式呢?

答案是固然有了。

咱們能夠經過繼承內置的 AbstractUser 類,來定義一個本身的Model類。

這樣既能根據項目需求靈活的設計用戶表,又能使用Django強大的認證系統了。

# app01下models.py文件中

from django.db import models
from django.contrib.auth.models import User,AbstractUser
# 讓拓展的auth_user表:userinfo繼承AbstractUser,這樣userinfo表擁有了原來auth_user表的全部屬性(字段)
class Userinfo(AbstractUser):
    phone = models.CharField(max_length=32)
    avatar = models.CharField(max_length=32)

須要注意:

按上面的方式擴展了內置的auth_user表以後,必定要在settings.py中告訴Django,我如今使用我新定義的UserInfo表來作用戶認證。寫法以下:

# 引用Django自帶的User表,繼承使用時須要設置
AUTH_USER_MODEL = "app名.UserInfo"

再次注意:

一旦咱們指定了新的認證系統所使用的表,咱們就須要從新在數據庫中建立該表,而不能繼續使用原來默認的auth_user表了。

示例:

這裏須要注意:若是在設置完作數據庫遷移命令migrate的時候報錯:
django.db.migrations.exceptions.InconsistentMigrationHistory: Migration admin.0001_initial is applied before its dependency users.0001_initial on database 'default'

解決方法是:刪除數據庫中 除了auth_user的其餘表,而後從新來一次

相關文章
相關標籤/搜索