Django之auth登錄認證

前言：我們在開發一個網站的時候，無可避免的需要設計實現網站的用戶系統。此時我們需要實現包括用戶注冊、用戶登錄、用戶認證、注銷、修改密碼等功能，這還真是個麻煩的事情呢。

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

一、auth模塊的方法介紹：

- 創建用戶

python manage.py createsuperuser
python manage.py createuser

- 模塊的導入：

from django.contrib import auth

1. auth中提供的實用方法:

1.1 authenticate()

提供了用戶認證功能，即驗證用戶名以及密碼是否正確，一般需要username 、password兩個關鍵字參數。如果認證成功（用戶名和密碼正確有效），便會返回一個 User 對象。

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

user = authenticate(username='theuser',password='thepassword')

1.2 login(request,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.
        ...

1.3 logout(request)

該函數接受一個HttpRequest對象，無返回值。當調用該函數時，當前請求的session信息會全部清除。該用戶即使沒有登錄，使用該函數也不會報錯。

from django.contrib.auth import logout

def logout_view(request):
    logout(request)
    # Redirect to a success page.

1.4 is_authenticated()

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

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

1.5 login_requierd()

auth 給我們提供的一個裝飾器工具，用來快捷的給某個FBV視圖添加登錄校驗。

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

 

應用：

1  用戶登陸后才能訪問某些頁面，

2  如果用戶沒有登錄就訪問該頁面的話直接跳到登錄頁面

3  用戶在跳轉的登陸界面中完成登陸后，自動訪問跳轉到之前訪問的地址

從某個頁面跳轉后的登錄頁面的url就成了：http://127.0.0.1:8000/login/?next=/page1/

注意：所以此刻視圖函數登錄成功的返回頁面就不要寫死了

def login(request):

    if request.method == "POST":
        user = request.POST.get("user")
        pwd = request.POST.get("pwd")

        # if 驗證成功返回user對象,否則返回None
        user=auth.authenticate(username=user,password=pwd)

        if user:
            auth.login(request,user)   # request.user:當前登錄對象

            next_url=request.GET.get("next","/index/")
            return  redirect(next_url)


    return render(request,"login.html")

 

1.6 CBV的登錄認證

auth 給我們提供的一個裝飾器工具，用來快捷的給某個CBV視圖添加登錄校驗

from django.contrib.auth.decorators import login_required
from django.utils.decorators import method_decorator

class Home(views.View):

    @method_decorator(login_required)
    def get(self, request):
        return render(request, 'home.html')

1.7 create_user()

 auth 提供的一個創建新用戶的方法，需要提供必要參數（username、password）等。

from django.contrib.auth.models import User

user = User.objects.create_user(username = '用戶名', password = '密碼', email = '郵箱', ...)

1.8 create_superuser()

auth 提供的一個創建新的超級用戶的方法，需要提供必要參數（username、password）等。

from django.contrib.auth.models import User

user = User.objects.create_superuser(username = '用戶名', password = '密碼', email = '郵箱', ...)

1.9 check_password(password)

auth 提供的一個檢查密碼是否正確的方法，需要提供當前請求用戶的密碼。密碼正確返回True，否則返回False。

ret = user.check_password('密碼')

1.10 set_password(password)

auth 提供的一個修改密碼的方法，接收 要設置的新密碼 作為參數。注意：設置完一定要調用用戶對象的save方法！！！

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

二、User對象的屬性

• username，
• password
• is_staff ： 用戶是否擁有網站的管理權限.
• is_active ： 是否允許用戶登錄, 設置為 False，可以在不刪除用戶的前提下禁止用戶登錄。

三、擴展默認的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表了。

 所以創建用戶時  from django.contrib.auth.models import User 這個User就用不上了。而是使用models里定義的新用戶表 UserInfo，並仍然可以使用create_user()

UserInfo.objects.create_user(username=request.POST.get("username"),
                                    password=request.POST.get("password"), phone=request.POST.get("phone"),
                                    email=request.POST.get("email"))