Django 1.11 内置认证视图实现邮箱密码重置完整指南

前言

密码重置功能是Web应用中不可或缺的一环。本文将深入解析如何利用Django框架内置的认证视图，快速实现基于邮箱的密码重置流程。内容包含具体的配置步骤与代码示例，旨在为开发者提供一份清晰、可操作的参考指南，帮助读者掌握这一实用技能。

本文基于Django 1.11版本进行讲解。

实现方法

Django框架在django.contrib.auth.views模块中预置了四个专门用于处理密码重置的类视图，开发者可直接调用或继承定制。

class PasswordResetView

URL name: password_reset #需保持与路由配置一致

该视图负责生成并发送包含重置链接的邮件。需特别注意：若系统中不存在该邮箱对应的用户，Django默认不会发送邮件，且不会抛出错误提示，而是直接重定向至success_url指定的页面。

主要属性如下：

• template_name: 指定用于输入邮箱地址的重置表单页面模板，默认值为'registration/password_reset_form.html'。
• form_class: 指定用于验证邮箱的Form类，默认为'PasswordResetForm'。若需实现“邮箱未注册”的明确提示，可重写该Form的clean()方法以添加自定义验证逻辑。
• email_template_name: 定义邮件正文内容的模板文件，默认值为'registration/password_reset_email.html'。
• subject_template_name: 定义邮件主题行的模板文件，默认值为'registration/password_reset_subject.txt'。
• success_url: 指定邮件发送成功（或邮箱未注册）后，用户被重定向的目标URL。
• form_email: 指定发送邮件的发件人地址，默认使用settings.py中配置的DEFAULT_FROM_EMAIL。务必确保在settings.py中正确配置了相关邮箱参数。
• extra_context: 用于向模板传递额外上下文数据的字典。

以下是对PasswordResetView进行简单定制的代码示例：

form django.contrib.auth.views import PasswordRestView
from django.contrib.auth.forms import PasswordRestForm
from django.contrib.auth.models import User
from django import forms

class CustomPasswordResetForm(PasswordRestForm):
 #实现'邮箱未注册'的提示
 class clean_email(self):
 email = self.cleaned_date.get('email', '')
 if not User.objects.filter(email=email):
  raise forms.ValidationError('邮箱未注册')
 return email

class CustomPasswordResetView(PasswordRestView):
 template_name = 'your_passd_reset.html'
 form_class = CustomPasswordResetForm


#urls.py
from myapp import views

urlpatterns = [
 # 除非重写了各视图的模板,否则name需要和指定的URL name一致
 url(r'^password_reset/$', views.CustomPasswordResetView.as_view(), name='password_reset'),
]

class PasswordResetDoneView

URL name: password_reset_done

该视图用于显示“密码重置邮件已成功发送”的提示页面。通常由PasswordResetView通过success_url参数自动调用。

特别注意：即使邮箱未注册、用户is_active状态为False或用户密码不可用，系统仍会重定向至此页面，但实际不会发送邮件。

主要属性如下：

• template_name: 指定显示的模板文件，默认值为'registration/password_reset_done.html'。
• extra_context: 用于添加额外的上下文数据。

class PasswordResetConfirmView

URL name: password_reset_confirm

该视图展示一个包含输入新密码表单的页面，供用户设置新密码。

主要属性如下：

• template_name: 指定显示的模板文件，默认值为'registration/password_reset_confirm.html'。
• post_reset_login: 布尔值，指定密码重置成功后是否自动登录用户，默认值为False。
• post_reset_login_backend: 当重写了authentication_backend且将post_reset_login设为True时，需指定所使用的authentication_backend。
• form_class: 用于验证新密码的Form类，默认为SetPasswordForm。
• success_url: 密码重置完成后重定向的URL，默认值为'password_reset_complete'。
• extra_context: 用于传递额外的上下文数据。

class PasswordResetCompleteView

URL name: password_reset_complete

该视图用于显示通知用户“密码重置成功”的页面。

主要属性如下：

• template_name: 指定显示的模板文件，默认值为'registration/password_reset_complete.html'。
• extra_context: 用于添加额外的上下文数据。

上述三个视图的重写方法与PasswordResetView类似，均通过继承和覆盖属性实现。

若完全使用Django提供的默认功能和模板，可直接在urls.py文件中引入相关视图。

from django.conf.urls import url, include
from django.contrib.auth import views as auth_views

urlpatterns = [
 url(r'^login/$', auth_views.LoginView.as_view(), name='login'),
 url(r'^logout/$', auth_views.logout_then_login, name='logout'), #注销后重定向到登录界面
 url(r'^password_reset/$', auth_views.PasswordResetView.as_view(form_class=forms.CustomPasswordResetForm), name='password_reset'), #密码重置链接
 url(r'^password_reset/done/$', auth_views.PasswordResetDoneView.as_view(), name='password_reset_done'), #密码重置邮件发送完成后的页面
 url(r'^reset/(?P<uidb64>[0-9A-Za-z_\-]+)/(?P<token>[0-9A-Za-z]{1,13}-[0-9A-Za-z]{1,20})/$', auth_views.PasswordResetConfirmView.as_view(), name='password_reset_confirm'), #用户通过邮箱打开的重置密码页面
 url(r'^reset/done/$', auth_views.PasswordResetCompleteView.as_view(), name='password_reset_complete'), #密码重置完成后跳转的页面
]

官方参考文档：https://docs.djangoproject.com/en/1.11/topics/auth/default/#module-django.contrib.auth.views

总结

以上就是利用Django内置认证视图实现密码重置功能的完整介绍。希望本文内容能为您的学习或工作提供有价值的参考。如有任何疑问，欢迎留言交流，感谢支持。