Auth模塊

本文目錄

 

Auth模塊是什麼

Auth模塊時Django自帶的用戶認證模塊,能夠快速的實現用戶註冊,登陸,認證,註銷,修改密碼等功能。javascript

Django內置強大的用戶認證系統——auth,它默認使用auth_user表來存儲用戶數據。html

 

Auth模塊怎麼用

(1)先建立超級用戶:   java

  -python3 manage.py createsuperuser
  -輸入用戶名,郵箱(能夠不輸入),密碼,敲回車,這樣就建立出一個超級用戶
  -也就是在auth_user這個表中插入了一條數據(密碼是加密的,因此我不能手動插入) python

(2)驗證用戶:

  -from django.contrib import auth
  -user = auth.authenticate(request, username=name, password=pwd)
  -至關於在查詢:user=models.User.objects.filter(name=name,pwd=pwd).first()
  -若是校驗經過,會返回一個user對象,經過判斷user對象,校驗是否驗證成功mysql


 

authenticate()git

  

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

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

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

用法:django

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

 


(3)登陸 :  

  -auth.login(request,user)
  -其實就是在session中寫了一條數據
(4)一旦登陸成功,調了這個函數login(request,user)

   -之後再視圖類,函數中的request對象中,就有一個user對象,就是當前登陸的用戶對象
  -若是沒有登陸,request.user=AnonymousUser,匿名用戶


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.
    ...

 


(5)註銷

   -auth.logout(request)
  -內部:調用了request.session.flush(),刪除了登陸狀態


login(request)

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

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

用法:

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

 


(6)登陸認證裝飾器   

  -from django.contrib.auth.decorators import login_required
  -@login_required(redirect_field_name='eee',login_url='/login/')
  -redirect_field_name:修改?後面的key值,
  -login_url:若是沒有登陸,跳轉到的頁面
    -能夠局部配置
    -能夠全局配置(在setting中)
      # 全局的配置,若是沒有登陸,跳到這個路由
      LOGIN_URL='/login/'


login_required()

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/'  # 這裏配置成你項目登陸頁面的路由

 

(7)建立用戶:   

  -from django.contrib.auth.models import User
  - 建立超級用戶和普通用戶
    # 不能用create
    # user=User.objects.create(username=name,password=pwd)
    # 建立超級用戶
    # user=User.objects.create_superuser(username=name,password=pwd)
    # 建立普通用戶
    user=User.objects.create_user(username=name,password=pwd)


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

 

(8)校驗密碼

   -request.user.check_password(pwd)
  -先拿到用戶(能夠是登陸用戶,能夠現查)


check_password(password)

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

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

用法:

ok = user.check_password('密碼')

 


(9)修改密碼:

   -user.set_password(pwd)
  -user.save()
  -注意:必定要調用save(),不然是不保存的


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)

一個修改密碼的簡單示例
一個修改密碼的簡單示例

 


(10)is_authenticated()

   -若是經過驗證,是true反之false


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

用法:

def my_view(request):
  if not request.user.is_authenticated():
    return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))


(11)其餘方法(瞭解):   

  -is_active:禁止登陸網站(用戶還存在,封號)
  -is_staff:是否對網站有管理權限(能不能登陸admin)


User對象屬性:username, password

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

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


-(12)刪除用戶   

    -orm刪除
  若是想在認證組件上加手機號等其餘字段:如何處理
    -(1) 定義一個表模型,跟User一對一管理
      class UserDetail(models.Model):
        phone=models.CharField(max_length=32)
        # 一對一跟auth_user表作關聯
        # 若是是從外部引入的表模型,是不能加引號的
        # 若是加引號,只是在當前model找
        user=models.OneToOneField(to=User)
    -(2)定義一個表模型,繼承(AbstractUser)
      -from django.contrib.auth.models import AbstractUser
      class UserInfo(AbstractUser):
        # username,password...都有
        phone=models.CharField(max_length=32)
        sex=models.BooleanField()
      -在setting中配置:
        AUTH_USER_MODEL ='app01.UserInfo'
      -作數據庫遷移,之後就沒有auth_user這個表了,之後認證組件用的表就是UserInfo
      -原來auth中的其餘操做:
        -authentication
        -login
        -logout
        -set_password
        ....
        ---同樣用,徹底同樣
      -不同的地方:
        若是以前用到User這個表模型的地方,都換成UserInfo

 

擴展默認的auth_user表

 

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

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

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

答案是固然有了。

咱們能夠經過繼承內置的 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表了。

 

博客項目需求分析

1 需求分析
  -首頁(顯示文章)
  -文章詳情
  -點贊,點踩
  -文章評論
  -字評論
  -評論的展現
  -登陸功能(圖片驗證碼)
  -註冊功能(基於form驗證,ajax)
  -我的站點(不一樣人不一樣樣式,文章過濾)
  -後臺管理:
  -文章展現
  -新增文章
  -富文本編輯器



2 設計程序(框架,數據庫設計)
  -UserInfo----用戶表
  -blog-----我的站點表
  -Article----文章表
  -commit----評論表
  -upanddown----點贊點踩表
  -category---文章分類表
  -tag---文章標籤表
  -表關係
  -userInfo跟blog ---- 一對一
  -article跟blog-----一對多
  -article跟category----(一篇文章只能由一個分類,一個分類下有多篇文章)一對多
  -article跟tag----(一個標籤能夠對應多篇文章,一篇文章能夠有多個標籤)多對多
  -commit跟Article---- 一對多
  -upanddown跟Article---- 一對多
  -user跟commit---一對多
  -user跟upanddown---一對多
  -category跟blog----一對多
  -tag跟blog----一對多

3 分任務開發(git)
4 測試
5 上線
博客項目

 

做業:

1 基於auth組件,寫登陸註冊,修改密碼,註銷(必須完成)  -登陸成功,顯示用戶名字,和註銷   -沒有登陸:顯示登陸註冊   -基於擴展的auth(寫一個表模型,繼承abstractuser) 2 表字段,關係分析好,建出來,同步到數據庫(mysql)

相關文章
相關標籤/搜索