如何使用 Django 更新用戶個人資料

更新日期： 2024 年 12 月 16 日

在 Django 框架中，處理用戶個人資料更新是一個常見功能，通常需要涉及表單的初始化、驗證以及數據庫保存。

本文將以一個具體範例代碼為基礎，逐步拆解其實現流程，幫助新手理解如何處理用戶個人資料更新功能。

功能概述

這段代碼的目的是實現用戶的個人資料更新，允許用戶修改基本信息（如名字和郵箱）以及文件字段（如頭像圖片）。

以下是主要功能點：

• 提供用戶查看和編輯個人資料的頁面。
• 接收用戶提交的表單數據，進行驗證。
• 保存合法數據到數據庫中。

完整代碼範例

以下是處理個人資料更新的 Django 視圖代碼：

from django.shortcuts import render, redirect
from django.contrib.auth.decorators import login_required
from .forms import UserUpdateForm, ProfileUpdateForm

@login_required
def profile(request):
    if request.method == 'POST':
        user_form = UserUpdateForm(request.POST, instance=request.user)
        profile_form = ProfileUpdateForm(request.POST, request.FILES, instance=request.user.profile)
        if user_form.is_valid() and profile_form.is_valid():
            user_form.save()
            profile_form.save()
            return redirect('profile')
    else:
        user_form = UserUpdateForm(instance=request.user)
        profile_form = ProfileUpdateForm(instance=request.user.profile)

    context = {
        'user_form': user_form,
        'profile_form': profile_form
    }
    return render(request, 'users/profile.html', context)

實現邏輯詳解

判斷請求類型

POST 請求：用戶提交了表單數據

當用戶提交表單（例如點擊「保存」按鈕）後，瀏覽器發送一個 POST 請求到服務器。

此時，代碼需要：

• 獲取用戶提交的數據：包括普通字段（request.POST）和文件字段（request.FILES）。
• 驗證數據是否合法：通過 is_valid() 方法檢查。
• 保存數據：如果驗證通過，調用 save() 方法保存數據。

GET 請求：展示表單

當用戶訪問個人資料頁面時（如 GET /profile），需要加載當前用戶的資料到表單中，讓用戶查看或編輯。

因此，代碼僅需：

• 初始化表單：將當前用戶數據填充到表單中。
• 渲染頁面：將表單傳遞給模板。

表單初始化與綁定

Django 的表單初始化在 GET 和 POST 請求中有不同的行為：

• GET 請求：

user_form = UserUpdateForm(instance=request.user)
profile_form = ProfileUpdateForm(instance=request.user.profile)

此時，表單僅需要從模型實例中加載數據（instance），無需處理用戶提交的數據。

• POST 請求：

user_form = UserUpdateForm(request.POST, instance=request.user)
profile_form = ProfileUpdateForm(request.POST, request.FILES, instance=request.user.profile)

在這種情況下，表單需要將用戶提交的數據（request.POST 和 request.FILES）應用到模型實例中。

延伸思考：如果表單只有 request.POST

user_form = UserUpdateForm(request.POST)

在這種情況下，表單會執行以下操作：

• 初始化一個表單：將提交的數據（request.POST）綁定到表單字段中。
• 沒有指定 instance：這意味著表單並未與任何現有的模型實例關聯。
• 數據處於未保存狀態：它只是暫時存儲在表單對象中，尚未涉及任何數據庫操作。

這種操作的用途：

• 主要用於處理和驗證提交的數據，而不是直接修改數據庫中的現有記錄。
• 適合用於創建新實體（如註冊表單）或處理一些非模型相關的表單數據（例如搜索功能）。

如果 user_form.save() 被調用

當你調用 save() 方法時，Django 表單會嘗試將數據保存到數據庫。

如果表單類（如 UserUpdateForm）繼承自 ModelForm，則：

1. Django 會自動根據 Meta.model 中指定的模型創建一個新實體。

class UserUpdateForm(forms.ModelForm):
    class Meta:
        model = User  # 表單將關聯到 User 模型
        fields = ['username', 'email']

2. 因此，當你調用 user_form.save() 時：
   • 表單會根據 Meta.model 創建一個新的 User 模型實例。
   • 實例的字段值來自表單中提交的數據。
   • 然後保存到數據庫。

沒有指定 instance 時的影響

如果表單沒有指定 instance，Django 認為這是用於創建新實例的表單。當你調用 save() 時，表單會創建並保存一個新的模型記錄，而不是更新現有的記錄。

為什麼 Django 表單能知道模型類型？

這是因為 Django 的 ModelForm 提供了一個 Meta 類，用於明確告訴表單它關聯的是哪個模型。

例如：

class UserUpdateForm(forms.ModelForm):
    class Meta:
        model = User  # 這裡指定了表單關聯到 User 模型
        fields = ['username', 'email']

當你初始化這個表單時：

• 如果傳入 request.POST 且未指定 instance，Django 就會根據 Meta.model 創建一個新實例。
• 如果傳入 request.POST 且指定了 instance，Django 會將數據應用到該實例上，然後更新它。

小結

• 僅傳入 request.POST：表單綁定了用戶提交的數據，但並未關聯任何現有模型實例。當調用 save() 時，Django 會創建一個新的模型實例並保存。
• 傳入 request.POST 和 instance：表單綁定用戶提交的數據並應用到指定的模型實例上。當調用 save() 時，會更新該實例。
• 如何知道要存在哪個模型？：Django 通過 Meta.model 知道該表單關聯的模型類型。

表單驗證與保存

當用戶提交表單後，代碼會通過以下方式驗證和保存數據：

if user_form.is_valid() and profile_form.is_valid():
    user_form.save()
    profile_form.save()
    return redirect('profile')

• 驗證數據：is_valid() 方法檢查表單數據是否符合規則（如字段長度、必填字段等）。
• 保存數據：如果驗證通過，save() 方法將數據保存到數據庫。

處理文件字段

如果用戶需要上傳文件（如頭像圖片），request.FILES 參數會處理這部分數據並綁定到表單中：

profile_form = ProfileUpdateForm(request.POST, request.FILES, instance=request.user.profile)

關鍵技術點解析

自動創建 Profile 實例

通常，我們會通過 Django 的信號（signals）來確保每個用戶，在註冊時都會自動創建一個對應的 Profile 實例。

例如：

from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import Profile

@receiver(post_save, sender=User)
def create_profile(sender, instance, created, **kwargs):
    if created:
        Profile.objects.create(user=instance)

這樣，我們可以保證 request.user.profile 在代碼中始終有效，避免 NoneType 錯誤。

為什麼在 POST 和 GET 中傳遞的參數不同？

• POST 請求：需要將用戶提交的數據與模型實例結合，傳遞 request.POST 和 request.FILES。
• GET 請求：僅需要從數據庫加載當前數據，傳遞 instance 即可。

結語

這段代碼展示了一個完整的用戶個人資料更新功能的實現方式，從表單初始化到數據驗證與保存，遵循了 Django 的最佳實踐。

如果你正在學習 Django，不妨嘗試基於這段代碼構建自己的功能，並結合 Django Signals 等技術，進一步完善用戶體驗和系統穩定性。