摘要：創建了數據庫模型就要遷移數據庫，遷移數據庫的命令也在前面講過。如果表單對應有一個數據庫模型例如這里的評論表單對應著評論模型，那么使用類會簡單很多，這是為我們提供的方便。表明這個表單對應的數據庫模型是類。

相對來說，評論其實是另外一個比較獨立的功能。Django 提倡，如果功能相對比較獨立的話，最好是創建一個應用，把相應的功能代碼寫到這個應用里。我們的第一個應用叫 blog，它里面放了展示博客文章列表和細節等相關功能的代碼。而這里我們再創建一個應用，名為 comments，這里面將存放和評論功能相關的代碼。首先激活虛擬環境，然后輸入如下命令創建一個新的應用：

python manage.py startapp comments

我們可以看到生成的 comments 應用目錄結構和 blog 應用的目錄是類似的。關于創建應用以及 Django 的目錄結構在 建立 Django 博客應用 中已經有過介紹。創建新的應用后一定要記得在 settings.py 里注冊這個應用，Django 才知道這是一個應用。

blogproject/settings.py

...
INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "blog",
    "comments", # 注冊新創建的 comments 應用
]
...

用戶評論的數據必須被存儲到數據庫里，以便其他用戶訪問時 Django 能從數據庫取回這些數據然后展示給訪問的用戶，因此我們需要為評論設計數據庫模型，這和設計文章、分類、標簽的數據庫模型是一樣的，如果你忘了怎么做，再回顧一下 創建 Django 博客的數據庫模型 中的做法。我們的評論模型設計如下（評論模型的代碼寫在 commentmodels.py 里）：

comments/models.py

from django.db import models
from django.utils.six import python_2_unicode_compatible

# python_2_unicode_compatible 裝飾器用于兼容 Python2
@python_2_unicode_compatible
class Comment(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField(max_length=255)
    url = models.URLField(blank=True)
    text = models.TextField()
    created_time = models.DateTimeField(auto_now_add=True)

    post = models.ForeignKey("blog.Post")

    def __str__(self):
        return self.text[:20]

這里我們會保存評論用戶的 name（名字）、email（郵箱）、url（個人網站），用戶發表的內容將存放在 text 字段里，created_time 記錄評論時間。最后，這個評論是關聯到某篇文章（Post）的，由于一個評論只能屬于一篇文章，一篇文章可以有多個評論，是一對多的關系，因此這里我們使用了 ForeignKey。關于 ForeKey 我們前面已有介紹，這里不再贅述。

同時注意我們為 DateTimeField 傳遞了一個 auto_now_add=True 的參數值。auto_now_add 的作用是，當評論數據保存到數據庫時，自動把 created_time 的值指定為當前時間。created_time 記錄用戶發表評論的時間，我們肯定不希望用戶在發表評論時還得自己手動填寫評論發表時間，這個時間應該自動生成。

創建了數據庫模型就要遷移數據庫，遷移數據庫的命令也在前面講過。在虛擬環境下分別運行下面兩條命令：

python manage.py makemigrations
python manage.py migrate

這一節我們將學習一個全新的 Django 知識：表單。那么什么是表單呢？基本的 HTML 知識告訴我們，在 HTML 文檔中這樣的代碼表示一個表單：

為什么需要表單呢？表單是用來收集并向服務器提交用戶輸入的數據的。考慮用戶在我們博客網站上發表評論的過程。當用戶想要發表評論時，他找到我們給他展示的一個評論表單（我們已經看到在文章詳情頁的底部就有一個評論表單，你將看到表單呈現給我們的樣子），然后根據表單的要求填寫相應的數據。之后用戶點擊評論按鈕，這些數據就會發送給某個 URL。我們知道每一個 URL 對應著一個 Django 的視圖函數，于是 Django 調用這個視圖函數，我們在視圖函數中寫上處理用戶通過表單提交上來的數據的代碼，比如驗證數據的合法性并且保存數據到數據庫中，那么用戶的評論就被 Django 后臺處理了。如果通過表單提交的數據存在錯誤，那么我們把錯誤信息返回給用戶，并在前端重新渲染，并要求用戶根據錯誤信息修正表單中不符合格式的數據，再重新提交。

Django 的表單功能就是幫我們完成上述所說的表單處理邏輯，表單對 Django 來說是一個內容豐富的話題，很難通過教程中的這么一個例子涵蓋其全部用法。因此我們強烈建議你在完成本教程后接下來的學習中仔細閱讀 Django 官方文檔關于 表單 的介紹，因為表單在 Web 開發中會經常遇到。

下面開始編寫評論表單代碼。在 comments 目錄下（和 models.py 同級）新建一個 forms.py 文件，用來存放表單代碼，我們的表單代碼如下：

comments/forms.py

from django import forms
from .models import Comment


class CommentForm(forms.ModelForm):
    class Meta:
        model = Comment
        fields = ["name", "email", "url", "text"]

要使用 Django 的表單功能，我們首先導入 forms 模塊。Django 的表單類必須繼承自 forms.Form 類或者 forms.ModelForm 類。如果表單對應有一個數據庫模型（例如這里的評論表單對應著評論模型），那么使用 ModelForm 類會簡單很多，這是 Django 為我們提供的方便。之后我們在表單的內部類 Meta 里指定一些和表單相關的東西。model = Comment 表明這個表單對應的數據庫模型是 Comment 類。fields = ["name", "email", "url", "text"] 指定了表單需要顯示的字段，這里我們指定了 name、email、url、text 需要顯示。

Django 為什么要給我們提供一個表單類呢？為了便于理解，我們可以把表單和前面講過的 Django ORM 系統做類比?；叵胍幌?，我們使用數據庫保存我們創建的博客文章，但是我們從頭到尾沒有寫過任何和數據庫有關的代碼（要知道數據庫自身也有一門數據庫語言），這是因為 Django 的 ORM 系統內部幫我們做了一些事情。我們遵循 Django 的規范寫的一些 Python 代碼，例如創建 Post、Category 類，然后通過運行數據庫遷移命令將這些代碼反應到數據庫。

Django 的表單和這個思想類似，正常的前端表單代碼應該是和本文開頭所提及的那樣，但是我們目前并沒有寫這些代碼，而是寫了一個 CommentForm 這個 Python 類。通過調用這個類的一些方法和屬性，Django 將自動為我們創建常規的表單代碼，接下來的教程我們就會看到具體是怎么做的。

當用戶提交表單中的數據后，Django 需要調用相應的視圖函數來處理這些數據，下面開始寫我們視圖函數處理邏輯：

comments/views.py

from django.shortcuts import render, get_object_or_404, redirect
from blog.models import Post

from .models import Comment
from .forms import CommentForm


def post_comment(request, post_pk):
    # 先獲取被評論的文章，因為后面需要把評論和被評論的文章關聯起來。
    # 這里我們使用了 Django 提供的一個快捷函數 get_object_or_404，
    # 這個函數的作用是當獲取的文章（Post）存在時，則獲取；否則返回 404 頁面給用戶。
    post = get_object_or_404(Post, pk=post_pk)
    
    # HTTP 請求有 get 和 post 兩種，一般用戶通過表單提交數據都是通過 post 請求，
    # 因此只有當用戶的請求為 post 時才需要處理表單數據。
    if request.method == "POST":
        # 用戶提交的數據存在 request.POST 中，這是一個類字典對象。
        # 我們利用這些數據構造了 CommentForm 的實例，這樣 Django 的表單就生成了。
        form = CommentForm(request.POST)
        
        # 當調用 form.is_valid() 方法時，Django 自動幫我們檢查表單的數據是否符合格式要求。
        if form.is_valid():
            # 檢查到數據是合法的，調用表單的 save 方法保存數據到數據庫，
            # commit=False 的作用是僅僅利用表單的數據生成 Comment 模型類的實例，但還不保存評論數據到數據庫。
            comment = form.save(commit=False)
            
            # 將評論和被評論的文章關聯起來。
            comment.post = post
            
            # 最終將評論數據保存進數據庫，調用模型實例的 save 方法
            comment.save()
            
            # 重定向到 post 的詳情頁，實際上當 redirect 函數接收一個模型的實例時，它會調用這個模型實例的 get_absolute_url 方法，
            # 然后重定向到 get_absolute_url 方法返回的 URL。
            return redirect(post)

        else:
            # 檢查到數據不合法，重新渲染詳情頁，并且渲染表單的錯誤。
            # 因此我們傳了三個模板變量給 detail.html，
            # 一個是文章（Post），一個是評論列表，一個是表單 form
            # 注意這里我們用到了 post.comment_set.all() 方法，
            # 這個用法有點類似于 Post.objects.all()
            # 其作用是獲取這篇 post 下的的全部評論，
            # 因為 Post 和 Comment 是 ForeignKey 關聯的，
            # 因此使用 post.comment_set.all() 反向查詢全部評論。
            # 具體請看下面的講解。
            comment_list = post.comment_set.all()
            context = {"post": post,
                       "form": form,
                       "comment_list": comment_list
                       }
            return render(request, "blog/detail.html", context=context)
    # 不是 post 請求，說明用戶沒有提交數據，重定向到文章詳情頁。
    return redirect(post)

這個評論視圖相比之前的一些視圖復雜了很多，主要是處理評論的過程更加復雜。具體過程在代碼中已有詳細注釋，這里僅就視圖中出現了一些新的知識點進行講解。

首先我們使用了 redirect 函數。這個函數位于 django.shortcuts 模塊中，它的作用是對 HTTP 請求進行重定向（即用戶訪問的是某個 URL，但由于某些原因，服務器會將用戶重定向到另外的 URL）。redirect 既可以接收一個 URL 作為參數，也可以接收一個模型的實例作為參數（例如這里的 post）。如果接收一個模型的實例，那么這個實例必須實現了 get_absolute_url 方法，這樣 redirect 會根據 get_absolute_url 方法返回的 URL 值進行重定向。

另外我們使用了 post.comment_set.all() 來獲取 post 對應的全部評論。 Comment 和Post 是通過 ForeignKey 關聯的，回顧一下我們當初獲取某個分類 cate 下的全部文章時的代碼：Post.objects.filter(category=cate)。這里 post.comment_set.all() 也等價于 Comment.objects.filter(post=post)，即根據 post 來過濾該 post 下的全部評論。但既然我們已經有了一個 Post 模型的實例 post（它對應的是 Post 在數據庫中的一條記錄），那么獲取和 post 關聯的評論列表有一個簡單方法，即調用它的 xxx_set 屬性來獲取一個類似于 objects 的模型管理器，然后調用其 all 方法來返回這個 post 關聯的全部評論。 其中 xxx_set 中的 xxx 為關聯模型的類名（小寫）。例如 Post.objects.filter(category=cate) 也可以等價寫為 cate.post_set.all()。

視圖函數需要和 URL 綁定，這里我們在 comment 應用中再建一個 urls.py 文件，寫上 URL 模式：

comments/urls.py

from django.conf.urls import url

from . import views

app_name = "comments"
urlpatterns = [
    url(r"^comment/post/(?P[0-9]+)/$", views.post_comment, name="post_comment"),
]

別忘了給這個評論的 URL 模式規定命名空間，即 app_name = "comments"。

最后要在項目的 blogprokect 目錄的 urls.py 里包含 commentsurls.py 這個文件：

blogproject/urls.py

urlpatterns = [
    url(r"^admin/", admin.site.urls),
    url(r"", include("blog.urls")),
    + url(r"", include("comments.urls")),
]

我們可以看到評論表單和評論列表是位于文章詳情頁面的，處理文章詳情頁面的視圖函數是 detail，相應地需要更新 detail，讓它生成表單和從數據庫獲取文章對應的評論列表數據，然后傳遞給模板顯示：

blog/views.py

import markdown

from django.shortcuts import render, get_object_or_404

+ from comments.forms import CommentForm
from .models import Post, Category

def detail(request, pk):
    post = get_object_or_404(Post, pk=pk)
    post.body = markdown.markdown(post.body,
                                  extensions=[
                                      "markdown.extensions.extra",
                                      "markdown.extensions.codehilite",
                                      "markdown.extensions.toc",
                                  ])
    # 記得在頂部導入 CommentForm
    form = CommentForm()
    # 獲取這篇 post 下的全部評論
    comment_list = post.comment_set.all()
    
    # 將文章、表單、以及文章下的評論列表作為模板變量傳給 detail.html 模板，以便渲染相應數據。
    context = {"post": post,
               "form": form,
               "comment_list": comment_list
               }
    return render(request, "blog/detail.html", context=context)

使用 Django 表單的一個好處就是 Django 能幫我們自動渲染表單。我們在表單的視圖函數里傳遞了一個 form 變量給模板，這個變量就包含了自動生成 HTML 表單的全部數據。在 detail.html 中通過 form 來自動生成表單。刪掉原來用于占位的 HTML 評論表單代碼，即下面這段代碼：

  

    

      名字：
      
    
    ...
  
    

替換成如下的代碼：

  {% csrf_token %}
  

    

      名字：
      {{ form.name }}
      {{ form.name.errors }}
    
    

      郵箱：
      {{ form.email }}
      {{ form.email.errors }}
    
    

      URL：
      {{ form.url }}
      {{ form.url.errors }}
    
    

      評論：
      {{ form.text }}
      {{ form.text.errors }}
      發表
    
  
    

{{ form.name }}、{{ form.email }}、{{ form.url }} 等將自動渲染成表單控件，例如 控件。

{{ form.name.errors }}、{{ form.email.errors }} 等將渲染表單對應字段的錯誤（如果有的話），例如用戶 email 格式填錯了，那么 Django 會檢查用戶提交的 email 的格式，然后將格式錯誤信息保存到 errors 中，模板便將錯誤信息渲染顯示。

在 detail 視圖函數我們獲取了全部評論數據，并通過 comment_list 傳遞給了模板。和處理 index 頁面的文章列表方式是一樣的，我們在模板中通過 {% for %} 模板標簽來循環顯示文章對應的全部評論內容。

刪掉占位用的評論內容的 HTML 代碼，即如下的代碼：

  

    追夢人物
    2017年3月12日 14:56
    

      文章觀點又有道理又符合人性，這才是真正為了表達觀點而寫，不是為了迎合某某知名人士粉絲而寫。我覺得如果瓊瑤是前妻，生了三孩子后被一不知名的女人挖了墻角，我不信誰會說那個女人是追求真愛，說同情瓊瑤罵小三的女人都是弱者。
    
  
  ...

替換成如下的代碼：

  {% for comment in comment_list %}
  

    {{ comment.name }}
    {{ comment.created_time }}
    

      {{ comment.text }}
    
  
  {% empty %}
  暫無評論
  {% endfor %}

接下來嘗試在詳情頁下的評論表單提交一些評論數據，可以看到詳情頁的評論列表處渲染了你提交的評論數據。

本章節的代碼位于：Step12: comments。

如果遇到問題，請通過下面的方式尋求幫助。

在 評論 - 追夢人物的博客 的評論區留言。

將問題的詳細描述通過郵件發送到 djangostudyteam@163.com，一般會在 24 小時內回復。

更多Django 教程，請訪問 追夢人物的博客。