22 Django 表单校验与错误处理实践

在 Django 中，表单校验和错误处理是用户交互过程中至关重要的一部分。本文将通过实际案例深入探讨如何在 Django 中实现这一功能。

表单创建与校验

在 Django 中，表单通常通过 forms 模块来创建。让我们从一个基本示例开始，创建一个用户注册表单，并对输入进行校验。

创建用户注册表单

首先，我们需要定义一个表单类，通常是通过继承 forms.Form 来实现的：

from django import forms

class UserRegistrationForm(forms.Form):
    username = forms.CharField(max_length=150)
    email = forms.EmailField()
    password = forms.CharField(widget=forms.PasswordInput())

在这个表单中，我们定义了三个字段：username、email 和 password。Django 自动为常见字段类型（如 CharField 和 EmailField）提供基本的校验，包括空值和格式校验。

在视图中处理表单

接下来，我们需要在视图中处理这个表单：

from django.shortcuts import render
from .forms import UserRegistrationForm

def register(request):
    if request.method == 'POST':
        form = UserRegistrationForm(request.POST)
        if form.is_valid():
            # 在这里处理有效的表单数据
            username = form.cleaned_data['username']
            email = form.cleaned_data['email']
            password = form.cleaned_data['password']
            # 可以在这里保存用户数据

            return render(request, 'registration/success.html')

    else:
        form = UserRegistrationForm()

    return render(request, 'registration/register.html', {'form': form})

在这个视图中，我们首先检查请求方式。如果是 POST，我们就用提交的数据来实例化表单。然后我们调用 is_valid() 方法来验证表单数据。

处理表单错误

如果表单不合法，我们需要将错误信息传递回模板。在上面的 register 视图中，如果表单无效，Django 会自动将错误信息保存在 form.errors 中。这些错误信息可以在模板中进行访问和展示。

在模板中显示错误信息

接下来，我们需要在我们的注册模板中显示表单和错误信息：

<form method="post">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">注册</button>
</form>

{% if form.errors %}
    <ul>
        {% for field in form %}
            {% for error in field.errors %}
                <li>{{ field.label }}: {{ error }}</li>
            {% endfor %}
        {% endfor %}
        {% for error in form.non_field_errors %}
            <li>{{ error }}</li>
        {% endfor %}
    </ul>
{% endif %}

在这个模板中，{{ form.as_p }} 会把表单字段以 <p> 标签的形式显示出来。我们还检查了 form.errors，并如果有错误就将其展示出来。

实战案例

接下来，让我们看一个更复杂的案例，结合模型和表单。比如我们要创建一个带有图片上传的用户资料更新表单。

创建模型

首先，定义一个用户模型（models.py）：

from django.db import models

class UserProfile(models.Model):
    username = models.CharField(max_length=150)
    email = models.EmailField()
    profile_picture = models.ImageField(upload_to='profile_pics/')

创建表单类

然后，创建对应的表单（forms.py）：

class UserProfileForm(forms.ModelForm):
    class Meta:
        model = UserProfile
        fields = ['username', 'email', 'profile_picture']

更新视图

接下来，更新视图（views.py）以处理文件上传及其校验：

from django.shortcuts import render, redirect
from .forms import UserProfileForm

def update_profile(request):
    if request.method == 'POST':
        form = UserProfileForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
            return redirect('profile_success')

    else:
        form = UserProfileForm()

    return render(request, 'profile/update.html', {'form': form})

文件上传设置

确保在 settings.py 中正确配置文件上传：

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media/')

并在 urls.py 中添加媒体文件配置：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他 URL 路由
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

模板更新

更新模板以支持文件上传（update.html）：

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">更新资料</button>
</form>

{% if form.errors %}
    <ul>
        {% for field in form %}
            {% for error in field.errors %}
                <li>{{ field.label }}: {{ error }}</li>
            {% endfor %}
        {% endfor %}
        {% for error in form.non_field_errors %}
            <li>{{ error }}</li>
        {% endfor %}
    </ul>
{% endif %}

总结

通过以上步骤，我们实现了 Django 表单校验和错误处理。关键点在于：

• 使用 forms.Form 或 forms.ModelForm 定义表单。
• 利用 .is_valid() 验证表单数据。
• 通过模板展示表单和错误信息。

掌握这些内容将大大增强你在 Django 中构建用户交互的能力。