第七章、Ajango自帶auth模塊

目錄

• 第七章、Ajango自帶auth模塊
  • 1、什麼是auth
    • auth是django自帶的用戶認證模塊
  • 2、auth模塊的經常使用方法
  • 3、拓展默認的auth_user表

第七章、Ajango自帶auth模塊

1、什麼是auth

auth是django自帶的用戶認證模塊

咱們在開發一個網站的時候，無可避免的須要設計實現網站的用戶系統。此時咱們須要實現包括用戶註冊、用戶登陸、用戶認證、註銷、修改密碼等功能，這還真是個麻煩的事情呢
Django做爲一個完美主義者的終極框架，固然也會想到用戶的這些痛點。它內置了強大的用戶認證系統--auth，它默認使用 auth_user表來存儲用戶數據。

2、auth模塊的經常使用方法

首先導入模塊

from django.contrib import auth

authenticate()
login(HttpRequest, user)
logout(request)
is_authenticated()
login_requierd()
create_user()
create_superuser()
check_password(password)
set_password(password)

• authenticate()

  驗證用戶名以及密碼是否正確，通常須要username 、password兩個關鍵字參數。

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

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

• login(HttpRequest, user)

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

  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: #判斷user是否存在 存在就能獲取
          login(request, user)#登陸  本質上給後端爲這個user 生成session數據
      #登錄成功後返回一個sucess的page
      ...
      else:
      # 返回一個user不存在的page
      ...

• 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))  #不經過驗證的user會重定向到登陸界面
      else:
          ...#返回驗證經過後跳轉到的頁面

• 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。

  is_ok = user.check_password('密碼')     #密碼正確is_ok返回True，不然返回False。

• set_password(password)

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

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

  user.set_password(password='')
  user.save()  #設置完必定要調用用戶對象的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表字段都是固定的那幾個，我在項目中無法拿來直接使用啊！

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

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

答案是固然有了。

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

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

from django.contrib.auth.models import AbstractUser
class UserInfo(AbstractUser):
    """
    用戶信息表
    """
    id = models.AutoField(primary_key=True)
    phone = models.CharField(max_length=11, null=True, unique=True)
    
    def __str__(self):
        return self.username

別忘記執行數據遷移的命令migrate和makemigrations

注意：

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

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

再次注意：

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