譯者夜夜月，已獲作者授權轉載。

原文連結：

http：//www。

jianshu。com/p/fd9a66891

24d

書籍出處：

https：//www。

packtpub。com/web-develo

pment/django-example

原作者：Antonio Melé

2017年1月4日初稿釋出

2017年5月5日第一次精校完成（感謝大牛 @kukoo 的精校！）

（譯者注：祝大家新年快樂，這次帶來《Django By Example》第四章的翻譯，這章非常的實用，因為簡書的文章內容有長度限制，所以本章分為上下兩篇，本篇是第四章下篇，上篇地址《Django By Example》第四章 上 中文 翻譯 （個人學習，渣翻） ）

使用者註冊和使用者profiles

現有的使用者已經可以登入，登出，修改他們的密碼，以及當他們忘記密碼的時候重置他們的密碼。現在，我們需要構建一個檢視（view）允許訪問者建立他們的賬號。

使用者註冊

讓我們建立一個簡單的檢視（view）允許使用者在我們的網站中進行註冊。首先，我們需要建立一個表單（form）讓使用者填寫使用者名稱，他們的真實姓名以及密碼。編輯

account

應用新目錄下的

forms。py

檔案新增如下程式碼：

from django。contrib。auth。models import User

class UserRegistrationForm（forms。ModelForm）：

password = forms。CharField（label=‘Password’，

widget=forms。PasswordInput）

password2 = forms。CharField（label=‘Repeat password’，

widget=forms。PasswordInput）

class Meta：

model = User

fields = （‘username’， ‘first_name’， ‘email’）

def clean_password2（self）：

cd = self。cleaned_data

if cd［‘password’］ ！= cd［‘password2’］：

raise forms。ValidationError（‘Passwords don\’t match。‘）

return cd［’password2‘］

我們為

User

模型（model）建立了一個model表單（form）。在我們的表單（form）中我們只包含了模型（model）中的

username，first_name，email

欄位。這些欄位會在它們對應的模型（model）欄位上進行驗證。例如：如果使用者選擇了一個已經存在的使用者名稱，將會得到一個驗證錯誤。我們還添加了兩個額外的欄位

password

和

password2

給使用者用來填寫他們的新密碼和確定密碼。我們定義了一個clean_password2（）方法去檢查第二次輸入的密碼是否和第一次輸入的保持一致，如果不一致這個表單將會是無效的。當我們透過呼叫is_valid（）方法驗證這個表單（form）時這個檢查會被執行。你可以提供一個clean_（）方法給任何一個你的表單（form）欄位用來清理值或者丟擲表單（from）指定的欄位的驗證錯誤。表單（forms）還包含了一個clean（）方法用來驗證表單（form）的所有內容，這對驗證需要依賴其他欄位的欄位是非常有用的。

Django還提供一個

UserCreationForm

表單（form）給你使用，它位於

django。contrib。auth。forms

非常類似與我們剛才建立的表單（form）。

編輯

account

應用中的

views。py

檔案，新增如下程式碼：

from 。forms import LoginForm， UserRegistrationForm

def register（request）：

if request。method == ’POST‘：

user_form = UserRegistrationForm（request。POST）

if user_form。is_valid（）：

# Create a new user object but avoid saving it yet

new_user = user_form。save（commit=False）

# Set the chosen password

new_user。set_password（

user_form。cleaned_data［’password‘］）

# Save the User object

new_user。save（）

return render（request，

’account/register_done。html‘，

{’new_user‘： new_user}）

else：

user_form = UserRegistrationForm（）

return render（request，

’account/register。html‘，

{’user_form‘： user_form}）

這個建立使用者賬號的檢視（view）非常簡單。為了保護使用者的隱私，我們使用

User

模型（model）的set_password（）方法將使用者的原密碼進行加密後再進行儲存操作。

現在，編輯

account

應用中的

urls。py

檔案，新增如下URL模式：

url（r’^register/$‘， views。register， name=’register‘），

最後，建立一個新的模板（template）在

account/

模板（template）目錄下，命名為

register。html

，為它新增如下程式碼：

{% extends “base。html” %}

{% block title %}Create an account{% endblock %}

{% block content %}

Create an account

Please， sign up using the following form：

{% endblock %}

在相同的目錄中新增一個模板（template）檔案命名為

register_done。html

，為它新增如下程式碼：

{% extends “base。html” %}

{% block title %}Welcome{% endblock %}

{% block content %}

Welcome {{ new_user。first_name }}！

Your account has been successfully created。 Now you can log in。

{% endblock %}

現在，在瀏覽器中開啟

http：//

127。0。0。1：8000/account/

register/

。你會看到你建立的註冊頁面：

填寫使用者資訊然後點選Create my account按鈕。如果所有的欄位都驗證都過，這個使用者將會被建立然後會得到一條成功資訊，如下所示：

點選log-in連結輸入你的使用者名稱和密碼來驗證賬號是否成功建立。

現在，你還可以新增一個註冊連結在你的登入模板（template）中。編輯

registration/login。html

模板（template）然後替換以下內容：

Please， use the following form to log-in：

為：

Please， use the following form to log-in。 If you don’t have an account register here

如此，我們就可以從登入頁面進入註冊頁面。

擴充套件User模型（model）

當你需要處理使用者賬號，你會發現Django認證（authentication）框架的

User

模型（model）只適應一般的案例。無論如何，

User

模型（model）只有一些最基本的欄位。你可能希望擴充套件

User

模型包含額外的資料。最好的辦法就是建立一個

profile

模型（model）包含所有額外的欄位並且和Django的

User

模型（model）做一對一的關聯。

編輯

account

應用中的

model。py

檔案，新增如下程式碼：

from django。db import models

from django。conf import settings

class Profile（models。Model）：

user = models。OneToOneField（settings。AUTH_USER_MODEL）

date_of_birth = models。DateField（blank=True， null=True）

photo = models。ImageField（upload_to=‘users/%Y/%m/%d’， blank=True）

def __str__（self）：

return ‘Profile for user {}’。format（self。user。username）

為了保持你的程式碼通用化，當需要定義模型（model）和使用者模型的關係時，使用get_user_model（）方法來取回使用者模型（model）並使用

AUTH_USER_MODEL

設定來引用這個使用者模型，替代直接引用auth的

User

模型（model）。

user

一對一欄位允許我們關聯使用者和profiles。

photo

欄位是一個

ImageField

欄位。你需要安裝一個Python包來管理圖片，使用PIL（Python Imaging Library）或者Pillow（PIL的分叉），在shell中執行一下命令來安裝

Pillow

：

pip install Pillow==2。9。0

為了Django能在開發服務中管理使用者上傳的多媒體檔案，在專案

setting。py

檔案中新增如下設定：

MEDIA_URL = ‘/media/’

MEDIA_ROOT = os。path。join（BASE_DIR， ‘media/’）

MEDIA_URL 是管理使用者上傳的多媒體檔案的主URL，MEDIA_ROOT是這些檔案在本地儲存的路徑。我們動態的構建這些路徑相對我們的專案路徑來確保我們的程式碼更通用化。

現在，編輯

bookmarks

專案中的主

urls。py

檔案，修改程式碼如下所示：

from django。conf。urls import include， url

from django。contrib import admin

from django。conf import settings

from django。conf。urls。static import static

urlpatterns = ［

url（r‘^admin/’， include（admin。site。urls）），

url（r‘^account/’， include（‘account。urls’）），

］

if settings。DEBUG：

urlpatterns += static（settings。MEDIA_URL，

document_root=settings。MEDIA_ROOT）

在這種方法中，Django開發伺服器將會在開發時改變對多媒體檔案的服務。

static（）

幫助函式最適合在開發環境中使用而不是在生產環境使用。絕對不要在生產環境中使用Django來服務你的靜態檔案。

開啟終端執行以下命令來為新的模型（model）建立資料庫遷移：

python manage。py makemigrations

你會獲得以下輸出：

Migrations for ‘account’：

0001_initial。py：

- Create model Profile

接著，同步資料庫透過以下命令：

python manage。py migrate

你會看到包含以下內容的輸出：

Applying account。0001_initial。。。 OK

編輯

account

應用中的

admin。py

檔案，在管理站點註冊

Profiel

模型（model），如下所示：

from django。contrib import admin

from 。models import Profile

class ProfileAdmin（admin。ModelAdmin）：

list_display = ［‘user’， ‘date_of_birth’， ‘photo’］

admin。site。register（Profile， ProfileAdmin）

使用python manage。py runnserver命令重新執行開發服務。現在，你可以看到

Profile

模型已經存在你專案中的管理站點中，如下所示：

現在，我們要讓使用者可以在網站編輯它們的

profile

。新增如下的模型（model）表單（forms）到

account

應用中的

forms。py

檔案：

from 。models import Profile

class UserEditForm（forms。ModelForm）：

class Meta：

model = User

fields = （‘first_name’， ‘last_name’， ‘email’）

class ProfileEditForm（forms。ModelForm）：

class Meta：

model = Profile

fields = （‘date_of_birth’， ‘photo’）

這兩個表單（forms）的功能：

UserEditForm：允許使用者編輯它們的

first name，last name， e-mail

這些儲存在

User

模型（model）中的內建欄位。

ProfileEditForm：允許使用者編輯我們儲存在定製的

Profile

模型（model）中的額外資料。使用者可以編輯他們的生日資料以及為他們的

profile

上傳一張照片。

編輯

account

應用中的

view。py

檔案，匯入

Profile

模型（model），如下所示：

from 。models import Profile

然後新增如下內容到

register

檢視（view）中的new_user。save（）下方：

# Create the user profile

profile = Profile。objects。create（user=new_user）

當用戶在我們的站點中註冊，我們會建立一個對應的空的

profile

給他們。你需要在管理站點中為之前建立的使用者們一個個手動建立對應的

Profile

物件。

現在，我們要讓使用者能夠編輯他們的

pfofile

。新增如下程式碼到相同檔案中：

from 。forms import LoginForm， UserRegistrationForm， \

UserEditForm， ProfileEditForm

@login_required

def edit（request）：

if request。method == ‘POST’：

user_form = UserEditForm（instance=request。user，

data=request。POST）

profile_form = ProfileEditForm（instance=request。user。profile，

data=request。POST，

files=request。FILES）

if user_form。is_valid（） and profile_form。is_valid（）：

user_form。save（）

profile_form。save（）

else：

user_form = UserEditForm（instance=request。user）

profile_form = ProfileEditForm（instance=request。user。profile）

return render（request，

‘account/edit。html’，

{‘user_form’： user_form，

‘profile_form’： profile_form}）

我們使用

login_required

裝飾器

decorator

是因為使用者編輯他們的

profile

必須是認證透過的狀態。在這個例子中，我們使用兩個模型（model）表單（forms）：

UserEditForm

用來儲存資料到內建的

User

模型（model）中，

ProfileEditForm

用來儲存額外的

profile

資料。為了驗證提交的資料，透過is_valid（）方法是否都返回

True

我們來檢查每個表單（forms）。在這個例子中，我們儲存兩個表單（form）來更新資料庫中對應的物件。

在

account

應用中的

urls。py

檔案中新增如下URL模式：

url（r‘^edit/$’， views。edit， name=‘edit’），

最後，在

templates/account/

中建立一個新的模板（template）命名為

edit。html

，為它新增如下內容：

{% extends “base。html” %}

{% block title %}Edit your account{% endblock %}

{% block content %}

Edit your account

You can edit your account using the following form：

{% endblock %}

我們在表單（form）中包含enctype=“multipart/form-data”用來支援檔案上傳。我們使用一個HTML表單來提交兩個表單（forms）：

user_form

和

profile_form

。

註冊一個新使用者然後開啟 http：//127。0。0。1：8000/account/edit/。你會看到如下所示頁面：

現在，你可以編輯dashboard頁面包含編輯

profile

的頁面連結和修改密碼的頁面連結。開啟

account/dashboard。html

模板（model）替換如下程式碼：

Welcome to your dashboard。

為：

Welcome to your dashboard。

You can edit your profile

or change your password。

使用者現在可以從他們的dashboard訪問編輯他們的

profile

的表單。

使用一個定製

User

模型（model）

Django還提供一個方法可以使用你自己定製的模型（model）來替代整個

User

模型（model）。你自己的使用者類需要繼承Django的

AbstractUser

類，這個類提供了一個抽象的模型（model）用來完整執行預設使用者。你可訪問https：//docs。djangoproject。com/en/1。8/topics/auth/customizing/#substituting-a-custom-user-model來獲得這個方法的更多資訊。

使用一個定製的使用者模型（model）將會帶給你很多的靈活性，但是它也可能給一些需要與

User

模型（model）互動的即插即用的應用整合帶來一定的困難。

使用messages框架

當處理使用者的操作時，你可能想要通知你的使用者關於他們操作的結果。Django有一個內建的messages框架允許你給你的使用者顯示一次性的提示。messages框架位於

django。contrib。messages

，當你使用python manage。py startproject命令建立一個新專案的時候，messages框架就被預設包含在

settings。py

檔案中的

INSTALLED_APPS

中。你會注意到你的設定檔案中在

MIDDLEWARE_CLASSES

設定裡包含了一個名為

django。contrib。messages。middleware。MessageMiddleware

的中介軟體。messages框架提供了一個簡單的方法新增訊息給使用者。訊息被儲存在資料庫中並且會在使用者的下一次請求中展示。你可以在你的檢視（views）中匯入

messages

模組來使用訊息messages框架，用簡單的快捷方式新增新的messages，如下所示：

from django。contrib import messages

messages。error（request， ‘Something went wrong’）

你可以使用add_message（）方法建立新的messages或用以下任意一個快捷方法：

success（）：當操作成功後顯示成功的messages

info（）：展示messages

warning（）：某些還沒有達到失敗的程度但已經包含有失敗的風險，警報用

error（）：操作沒有成功或者某些事情失敗

debug（）：在生產環境中這種messages會移除或者忽略

讓我們顯示messages給使用者。因為messages框架是被專案全域性應用，我們可以在主模板（template）給使用者展示messages。開啟

base。html

模板（template）在id為

header

的