auth模塊(針對用戶)

Auth模塊是什麼

使用auth模塊 必須用全套 不是本身寫一部分 用別人一部分python

Auth模塊是Django自帶的用戶認證模塊:數據庫

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

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

如何使用auto模塊

1.建立超級管理員,用來登錄用於登陸django admin的後臺管理緩存

接下來建立建立超級管理員session

注意事項:設置密碼的時候密碼不能單一,而且須要8個字符纔可以進行建立,而且密碼是加密的,沒法直接查看app

建立成功後能夠看錶內的內容,下面是全部的字段。框架

登錄後函數




auth模塊經常使用方法

from django.contrib import auth

authenticate()(示例:登錄)

做用:校驗用戶是否存在

該方法會有一個返回值 當條件存在的狀況下 返回就是數據對象自己,條件不知足 直接返回None

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

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

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

用法:

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

<form action="" method="post">
    {% csrf_token %}
    <p>username:<input type="text" name="username"></p>
    <p>password:<input type="text" name="password"></p>
    <p><input type="submit" value="提交"></p>
</form>

login(HttpRequest, user)

做用:保存用戶的登錄狀態

auth.login(request,user_obj)  # 執行完這一句以後 只要是可以拿到request的地方 
        # 均可以經過request.user獲取到當前登陸用戶對象

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

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

用法:執行這個方法的時候,用戶是須要存在,才行

from django.contrib import auth
def login(request):
    if request.method=="POST":
        username = request.POST.get("username")
        password = request.POST.get("password")
        user_obj =auth.authenticate(username=username,password=password)
        print(user_obj)
        print(user_obj.username)
        print(user_obj.password)
        """該方法會主動幫你操做session表 而且只要執行了該方法
            你就能夠在任何位置經過request.user獲取到當前登陸的用戶對象
        """
        auth.login(request,user_obj)
        #必定要記錄用戶狀態 纔算真正的用戶登陸
    return render(request,'login.html')

def home(request):
    print(request.user)
    return HttpResponse('哈嘍共享你進入home')

is_authenticated()

做用:判斷當前用戶是否登陸request.user.is_authenticated()

true是表明已經登錄,flase表明沒有登錄

用來判斷當前請求是否經過了認證。

用法:

def index(request):
    print(request.user)  # 直接拿到登陸用戶的用戶對象
    print(request.user.is_authenticated,1)  # 簡單快捷的判斷用戶是否登陸
    print(request.user.is_authenticated(),2)
    return HttpResponse('index')

login_requierd裝飾器

auth 給咱們提供的一個裝飾器工具,用來快捷的給某個視圖添加登陸校驗。

必須先導入from django.contrib.auth.decorators import login_requierd

用法:

from django.contrib.auth.decorators import login_required
      
@login_required#給下面的視圖添加裝飾器,沒有登錄的話,訪問不了
def set_password(request):
    pass

若用戶沒有登陸,則會跳轉到django默認的 登陸URL '/accounts/login/ ' 並傳遞當前訪問url的絕對路徑 (登錄成功後,會重定向到該路徑)。

局部配置

若是須要自定義登陸的URL,後面添加參數

from django.contrib.auth.decorators import login_required
      
@login_required(login_url="/login/")#給下面的視圖添加裝飾器,沒有登錄的話,訪問不了
def set_password(request):
    pass

全局配置

若是須要全部的都跳到本身寫的指定URL,則須要在settings.py文件中經過LOGIN_URL進行修改。

示例:

auto校驗全局是否登錄的配置
LOGIN_URL = '/login/'  # 這裏配置成你項目登陸頁面的路由
from django.contrib.auth.decorators import login_required
      
@login_required#這個時候不須要添加參數了
def set_password(request):
    pass

check_password(password)

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

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

用法:

ok = user.check_password('密碼')

set_password(password)

auth 提供的一個修改密碼的方法,接收 要設置的新密碼 做爲參數。

注意:設置完必定要調用用戶對象的save方法!!!

用法:

user.set_password(password='')
user.save()

from django.contrib.auth.decorators import login_required
@login_required(login_url='/login')
def set_password(request):
    if request.method == 'POST':
        old_password = request.POST.get('old_password')
        new_password = request.POST.get('new_password')
        # 校驗原密碼對不對
        is_right = request.user.check_password(old_password)
        #判斷密碼是否正確,正確返回True
        print(is_right)
        if is_right:
            # 修改密碼
            request.user.set_password(new_password)
            # 這個方法,僅僅只會在內存中產生一個緩存
            # 並不會直接修改數據庫
            request.user.save()  # 必定要點save方法保存 才能真正的操做數據庫
            return redirect('/login/')
    return render(request, 'set_password.html', locals())
<form action="" method="post">
    {% csrf_token %}
    <p>username<input type="text" disabled value="{{ request.user.username }}"></p>{#disabled名字不能修改#}
    <p><input type="text" name="old_password"></p>
    <p><input type="text" name="new_password"></p>
    <input type="submit">
</form>

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='郵箱',...)

1572525572189

logout(request)

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

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

用法:

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

User對象的屬性

User對象屬性:username, password

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

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

擴展默認的auth_user表(擴展用戶表)

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

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

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

答案是固然有了。

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

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

強調 你繼承了AbstractUser以後 你自定義的表中 字段不能跟原有的衝突

from django.db import models
from django.contrib.auth.models import AbstractUser
# Create your models here.

class Userinfo(AbstractUser):
    """
    強調 你繼承了AbstractUser以後 你自定義的表中 字段不能跟原有的衝突
    """
    phone = models.BigIntegerField()
    avatar = models.FileField()
    register_time = models.DateField(auto_now_add=True)

    
    def __str__(self):
        return self.username

注意

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

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

再次注意:

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

另一種

​ 利用一對一表關係 擴展字段

相關文章
相關標籤/搜索