Django Auth应用实现用户身份认证

目录

• 安装Django Auth应用
• 配置Django Auth应用
• 创建用户模型
• 创建用户管理器
• 创建用户注册视图
• 创建用户登录视图
• 创建用户注销视图
• 配置网站URL

Django Auth应用是Django官方提供的一个用户认证应用，可以用于实现用户的注册、登录、注销等功能。本文将介绍如何使用Django Auth应用实现用户身份认证的完整方法。

安装Django Auth应用

首先需要安装Django Auth应用，可以使用pip安装：

pip install django-auth

或者在项目的requirements.txt文件中添加以下内容：

django-auth

配置Django Auth应用

在Django的settings.py文件中，需要添加以下配置项：

INSTALLED_APPS = [
    ...,
    'django.contrib.auth',
    'django.contrib.contenttypes',
    ...,
]

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
]

其中，INSTALLED_APPS需要添加django.contrib.auth和django.contrib.contenttypes两个应用；AUTHENTICATION_BACKENDS需要添加django.contrib.auth.backends.ModelBackend作为默认的身份认证后端。

创建用户模型

Django Auth应用使用的是Django自带的用户模型，可以通过以下命令创建用户模型：

python manage.py migrate auth

如果需要自定义用户模型，可以在models.py文件中定义一个继承自AbstractBaseUser和PermissionsMixin的用户模型：

from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin
from django.db import models

class User(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True)
    name = models.CharField(max_length=30)
    is_staff = models.BooleanField(default=False)
    is_active = models.BooleanField(default=True)
    date_joined = models.DateTimeField(auto_now_add=True)

    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = ['name']

    objects = UserManager()

    class Meta:
        verbose_name = 'user'
        verbose_name_plural = 'users'

    def get_full_name(self):
        return self.name

    def get_short_name(self):
        return self.name

    def __str__(self):
        return self.email

在上面的代码中，我们自定义了一个包含email、name等字段的用户模型，并通过USERNAME_FIELD指定了用户名字段为email。REQUIRED_FIELDS指定注册时需要填写的字段列表。

创建用户管理器

如果自定义用户模型，还需要创建一个用户管理器。可以在managers.py文件中定义一个继承自BaseUserManager的用户管理器：

from django.contrib.auth.base_user import BaseUserManager

class UserManager(BaseUserManager):
    use_in_migrations = True

    def create_user(self, email, name, password=None, **kwargs):
        if not email:
            raise ValueError('Users must have an email address')
        user = self.model(
            email=self.normalize_email(email),
            name=name,
            **kwargs
        )
        user.set_password(password)
        user.save(using=self._db)
        return user

    def create_superuser(self, email, name, password=None, **kwargs):
        kwargs.setdefault('is_staff', True)
        kwargs.setdefault('is_superuser', True)
        return self.create_user(email, name, password, **kwargs)

在上述代码中，我们通过create_user方法创建用户，create_superuser方法创建超级用户。

创建用户注册视图

接下来，我们需要创建用户注册视图。在views.py文件中添加以下代码：

from django.contrib.auth import authenticate, login
from django.contrib.auth.forms import UserCreationForm
from django.shortcuts import redirect, render

def register(request):
    if request.method == 'POST':
        form = UserCreationForm(request.POST)
        if form.is_valid():
            form.save()
            email = form.cleaned_data.get('email')
            password = form.cleaned_data.get('password1')
            user = authenticate(request, email=email, password=password)
            login(request, user)
            return redirect('home')
    else:
        form = UserCreationForm()
    return render(request, 'registration/register.html', {'form': form})

在上述代码中，我们使用了django.contrib.auth.forms.UserCreationForm来创建用户注册表单，用户提交注册表单后，将用户信息保存到数据库中，并使用authenticate方法进行身份认证，最后使用login方法登录到系统中。

创建用户登录视图

类似地，我们需要创建用户登录视图。在views.py文件中添加以下代码：

from django.contrib.auth.forms import AuthenticationForm
from django.contrib.auth import authenticate, login
from django.shortcuts import redirect, render

def login_view(request):
    if request.user.is_authenticated:
        return redirect('home')
    if request.method == 'POST':
        form = AuthenticationForm(request, request.POST)
        if form.is_valid():
            email = form.cleaned_data.get('username')
            password = form.cleaned_data.get('password')
            user = authenticate(request, email=email, password=password)
            if user is not None:
                login(request, user)
                return redirect('home')
    else:
        form = AuthenticationForm()
    return render(request, 'registration/login.html', {'form': form})

在上述代码中，我们同样使用django.contrib.auth.forms.AuthenticationForm来创建用户登录表单，并在用户成功登录后跳转到网站首页。

创建用户注销视图

最后，我们需要创建用户注销视图。在views.py文件中添加以下代码：

from django.contrib.auth import logout
from django.shortcuts import redirect

def logout_view(request):
    logout(request)
    return redirect('home')

在上述代码中，我们使用django.contrib.auth.logout方法注销用户，并跳转到网站首页。

配置网站URL

最后，我们需要在urls.py文件中配置网站URL。添加以下代码：

from django.contrib.auth.views import LogoutView
from django.urls import path
from . import views

urlpatterns = [
    path('register/', views.register, name='register'),
    path('login/', views.login_view, name='login'),
    path('logout/', LogoutView.as_view(next_page='home'), name='logout'),
    ...
]

在上述代码中，我们使用django.contrib.auth.views.LogoutView来处理用户注销操作，并使用next_page参数指定注销后跳转的页面。

至此，使用Django Auth应用实现用户身份认证的完整实现方法就结束了。