該系列教程系個人原創(chuàng)，并完整發(fā)布在個人官網(wǎng)劉江的博客和教程

所有轉(zhuǎn)載本文者，需在頂部顯著位置注明原作者及www.官網(wǎng)地址。

本章以創(chuàng)建一個Web投票應(yīng)用為例子，手把手的教你如何使用Django開發(fā)Web應(yīng)用，力圖從全局范圍帶給大家一個整體的Django概念，讓你對Django的設(shè)計理念、功能模塊、體系架構(gòu)、基本用法有個初步的印象。

該應(yīng)用包括以下兩個部分：

• 一個可以讓公眾用戶進(jìn)行投票和查看投票結(jié)果的站點(diǎn)
• 一個讓可以進(jìn)行增刪改查的后臺admin管理界面

在開始之前，再次重申，請確保已經(jīng)安裝最新版本的Django?？梢栽诿钚谢蛘?提示符下輸入：

$ python -m django --version

如果沒有顯示版本號，而是提示“No module named django”，請返回前面的章節(jié)，參考安裝Django。

一、 新建項目

進(jìn)入你指定的項目保存目錄，然后運(yùn)行下面的命令：

$ django-admin startproject mysite

這將在目錄下生成一個mysite目錄，也就是你的這個Django項目的根目錄。它包含了一系列自動生成的目錄和文件，具備各自專有的用途。

注意：在給項目命名的時候必須避開Django和Python的保留關(guān)鍵字，比如“django”，“test”等，否則會引起沖突和莫名的錯誤。對于mysite的放置位置，不建議放在傳統(tǒng)的/var/wwww目錄下，它會具有一定的數(shù)據(jù)暴露危險，因此Django建議你將項目文件放在例如/home/mycode類似的位置。

一個新建立的項目結(jié)構(gòu)大概如下：

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

各文件和目錄解釋：

• 外層的mysite/目錄與Django無關(guān)，只是你項目的容器，可以任意命名。
• manage.py：一個命令行工具，用于與Django進(jìn)行不同方式的交互腳本，非常重要！
• 內(nèi)層的mysite/目錄是真正的項目文件包裹目錄，它的名字是你引用內(nèi)部文件的包名，例如：mysite.urls。
• mysite/__init__.py:一個定義包的空文件。
• mysite/settings.py:項目的主配置文件，非常重要！
• mysite/urls.py:路由文件，所有的任務(wù)都是從這里開始分配，相當(dāng)于Django驅(qū)動站點(diǎn)的內(nèi)容表格，非常重要！
• mysite/wsgi.py:一個基于WSGI的web服務(wù)器進(jìn)入點(diǎn)，提供底層的網(wǎng)絡(luò)通信功能，通常不用關(guān)心。

PS：這一部分，我們可以在Pycharm環(huán)境下進(jìn)行，參考上節(jié)內(nèi)容。

二、 啟動開發(fā)服務(wù)器

進(jìn)入mystie項目的根目錄，輸入下面的命令：

$ python manage.py runserver

你會看到下面的提示，這表明Django的開發(fā)服務(wù)器已經(jīng)啟動，開始提供Web服務(wù)了：

Performing system checks...
System check identified no issues (0 silenced).
You have unapplied migrations; your app may not work properly until they are applied.
Run `python manage.py migrate' to apply them.
September 10, 2017 - 15:50:53
Django version 1.10, using settings `mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Django提供了一個用于開發(fā)的web服務(wù)器，使你無需配置一個類似Ngnix的線上服務(wù)器，就能讓站點(diǎn)運(yùn)行起來。這是一個由Python編寫的輕量級服務(wù)器，簡易并且不安全，因此不要將它用于生產(chǎn)環(huán)境。

打開瀏覽器，訪問http://127.0.0.1:8000/，你將看到Django的歡迎界面，一切OK！

Django的開發(fā)服務(wù)器（以后簡稱服務(wù)器）默認(rèn)運(yùn)行在內(nèi)部的8000端口，如果你想指定端口，請在命令中顯示給出：

$ python manage.py runserver 8080

如果想修改服務(wù)器的ip地址，請按下面的方式運(yùn)行命令：

$ python manage.py runserver 0.0.0.0:8000

這時，Django將運(yùn)行在8000端口，整個局域網(wǎng)內(nèi)都將可以訪問站點(diǎn)，而不只是是本機(jī)。

注意： Django的開發(fā)服務(wù)器具有自動重載功能，當(dāng)你的代碼有修改，每隔一段時間服務(wù)器將自動更新。但是，有一些例如增加文件的動作，不會觸發(fā)服務(wù)器重載，這時就需要你自己手動重啟。

PS:這一步操作也可以在Pycharm里完成。

三、 創(chuàng)建投票應(yīng)用(app)

app應(yīng)用與project項目的區(qū)別：

• 一個app實(shí)現(xiàn)某個功能，比如博客、公共檔案數(shù)據(jù)庫或者簡單的投票系統(tǒng)；
• 一個project是配置文件和多個app的集合，這些app組合成整個站點(diǎn)；
• 一個project可以包含多個app；
• 一個app可以屬于多個project！

app的存放位置可以是任何地點(diǎn)，但是通常都將它們放在與manage.py腳本同級的目錄下，這樣方便導(dǎo)入文件。

進(jìn)入mysite項目根目錄，確保與manage.py文件處于同一級，輸入下述命令：

$ python manage.py startapp polls

系統(tǒng)會自動生成 polls應(yīng)用的目錄，其結(jié)構(gòu)如下：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

在Pycharm中，沒有可以創(chuàng)建app的圖形化按鈕，需要在下方的terminal終端中輸入命令：

python manage.py startapp polls

這樣也能創(chuàng)建polls應(yīng)用。

四、編寫第一個視圖

在polls/views.py文件中，編寫代碼：

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

為了調(diào)用該視圖，我們還需要編寫urlconf，也就是路由路徑。現(xiàn)在，在polls目錄中新建一個文件，名字為urls.py，在其中輸入代碼如下：

from django.conf.urls import url
from . import views

urlpatterns = [
    url(r'^$', views.index, name='index'),
]

此時，目錄的文件結(jié)構(gòu)是這樣的：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

我們先不用深究url中代碼的具體含義。

接下來，在項目的主urls文件中添加urlpattern條目，指向我們剛才建立的polls這個app獨(dú)有的urls文件，這里需要導(dǎo)入include模塊。打開mysite/urls.py文件，代碼如下：

from django.conf.urls import include, url
from django.contrib import admin

urlpatterns = [
    url(r'^polls/', include('polls.urls')),
    url(r'^admin/', admin.site.urls),
]

include語法相當(dāng)于多級路由，它把接收到的url地址去除前面的正則表達(dá)式，將剩下的字符串傳遞給下一級路由進(jìn)行判斷。在路由的章節(jié)，有更加詳細(xì)的用法指導(dǎo)。

include的背后是一種即插即用的思想。項目根路由不關(guān)心具體app的路由策略，只管往指定的二級路由轉(zhuǎn)發(fā)，實(shí)現(xiàn)了應(yīng)用解耦。app所屬的二級路由可以根據(jù)自己的需要隨意編寫，不會和其它的app路由發(fā)生沖突。app目錄可以放置在任何位置，而不用修改路由。這是軟件設(shè)計里很常見的一種模式。

建議：除了admin路由外，盡量給每個app設(shè)計自己獨(dú)立的二級路由。

好了，路由設(shè)置成功后，啟動服務(wù)器，然后在瀏覽器中訪問地址http://localhost:8000/polls/。一切正常的話，你將看到“Hello, world. You’re at the polls index.”

url()方法：

url()方法可以接收4個參數(shù)，其中2個是必須的：regex和view，以及2個可選的參數(shù)：kwargs和name。

regex：

regex是正則表達(dá)式的通用縮寫，它是一種匹配字符串或url地址的語法。Django拿著用戶請求的url地址，在urls.py文件中對urlpatterns列表中的每一項條目從頭開始進(jìn)行逐一對比，一旦遇到匹配項，立即執(zhí)行該條目映射的視圖函數(shù)或下級路由，其后的條目將不再繼續(xù)匹配。因此，url路由的編寫順序非常重要！

需要注意的是，regex不會去匹配GET或POST參數(shù)或域名，例如對于https://www./myapp/，regex只嘗試匹配myapp/。對于https://www./myapp/?page=3,regex也只嘗試匹配myapp/。

如果你想深入研究正則表達(dá)式，可以讀一些相關(guān)的書籍或?qū)Ｕ?，但是在Django的實(shí)際應(yīng)用中，你不需要多高深的正則表達(dá)式知識，在Python教程部分有正則表達(dá)式相關(guān)專題，可供學(xué)習(xí)參考。

當(dāng)URLconf模塊加載的時候會預(yù)先編譯正則表達(dá)式，因此它的匹配搜索速度非?？?，你通常感覺不到。

view：

view指的是處理當(dāng)前url請求的視圖函數(shù)。當(dāng)正則表達(dá)式匹配到某個條目時，自動將封裝的HttpRequest對象作為第一個參數(shù)，正則表達(dá)式“捕獲”到的值作為第二個參數(shù)，傳遞給該條目指定的視圖view。如果是簡單捕獲，那么捕獲值將作為一個位置參數(shù)進(jìn)行傳遞，如果是命名捕獲，那么將作為關(guān)鍵字參數(shù)進(jìn)行傳遞。

kwargs：

任意數(shù)量的關(guān)鍵字參數(shù)可以作為一個字典傳遞給目標(biāo)視圖。

name：

對你的URL進(jìn)行命名，讓你能夠在Django的任意處，尤其是模板內(nèi)顯式地引用它。這是一個非常強(qiáng)大的功能，相當(dāng)于給URL取了個全局變量名，不會將url匹配地址寫死。

url()方法的四個參數(shù)，每個都非常有講究，這里先做基本的介紹，在后面有詳細(xì)的論述。