Part 1：請求與響應--Django從入門到精通系列教程

該系列教程系個人原創，並完整發佈在個人官網 "劉江的博客和教程" 所有轉載本文者，需在頂部顯著位置註明原作者及www.liujiangblog.com官網地址。 Python及Django學習QQ群：453131687 本章以創建一個Web投票應用為例子，手把手的教你如何使用Django開發Web應 ...

該系列教程系個人原創，並完整發佈在個人官網劉江的博客和教程

所有轉載本文者，需在頂部顯著位置註明原作者及www.liujiangblog.com官網地址。

Python及Django學習QQ群：453131687

本章以創建一個Web投票應用為例子，手把手的教你如何使用Django開發Web應用，力圖從全局範圍帶給大家一個整體的Django概念，讓你對Django的設計理念、功能模塊、體系架構、基本用法有個初步的印象。

該應用包括以下兩個部分：

一個可以讓公眾用戶進行投票和查看投票結果的站點
一個讓可以進行增刪改查的後臺admin管理界面

在開始之前，再次重申，請確保已經安裝最新版本的Django。可以在命令行或者$提示符下輸入：

$ python -m django --version

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

一、新建項目

進入你指定的項目保存目錄，然後運行下麵的命令：

$ django-admin startproject mysite

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

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

一個新建立的項目結構大概如下：

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

各文件和目錄解釋：

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

PS：這一部分，我們可以在Pycharm環境下進行，參考上節內容。

二、啟動開發伺服器

進入mystie項目的根目錄，輸入下麵的命令：

$ python manage.py runserver

你會看到下麵的提示，這表明Django的開發伺服器已經啟動，開始提供Web服務了：

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提供了一個用於開發的web伺服器，使你無需配置一個類似Ngnix的線上伺服器，就能讓站點運行起來。這是一個由Python編寫的輕量級伺服器，簡易並且不安全，因此不要將它用於生產環境。

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

Django的開發伺服器（以後簡稱伺服器）預設運行在內部的8000埠，如果你想指定埠，請在命令中顯示給出：

$ python manage.py runserver 8080

如果想修改伺服器的ip地址，請按下麵的方式運行命令：

$ python manage.py runserver 0.0.0.0:8000

這時，Django將運行在8000埠，整個區域網內都將可以訪問站點，而不只是是本機。

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

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

三、創建投票應用(app)

app應用與project項目的區別：

一個app實現某個功能，比如博客、公共檔案資料庫或者簡單的投票系統；
一個project是配置文件和多個app的集合，這些app組合成整個站點；
一個project可以包含多個app；
一個app可以屬於多個project！

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

進入mysite項目根目錄，確保與manage.py文件處於同一級，輸入下述命令：

$ python manage.py startapp polls

系統會自動生成 polls應用的目錄，其結構如下：

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

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

python manage.py startapp polls

這樣也能創建polls應用。

image.png-29.9kB

四、編寫第一個視圖

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

from django.http import HttpResponse

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

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

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

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

此時，目錄的文件結構是這樣的：

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

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

接下來，在項目的主urls文件中添加urlpattern條目，指向我們剛纔建立的polls這個app獨有的urls文件，這裡需要導入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語法相當於多級路由，它把接收到的url地址去除前面的正則表達式，將剩下的字元串傳遞給下一級路由進行判斷。在路由的章節，有更加詳細的用法指導。

include的背後是一種即插即用的思想。項目根路由不關心具體app的路由策略，只管往指定的二級路由轉發，實現了應用解耦。app所屬的二級路由可以根據自己的需要隨意編寫，不會和其它的app路由發生衝突。app目錄可以放置在任何位置，而不用修改路由。這是軟體設計里很常見的一種模式。

建議：除了admin路由外，儘量給每個app設計自己獨立的二級路由。

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

url()方法：

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

regex：

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

需要註意的是，regex不會去匹配GET或POST參數或功能變數名稱，例如對於https://www.example.com/myapp/，regex只嘗試匹配myapp/。對於https://www.example.com/myapp/?page=3,regex也只嘗試匹配myapp/。

如果你想深入研究正則表達式，可以讀一些相關的書籍或專論，但是在Django的實際應用中，你不需要多高深的正則表達式知識，在Python教程部分有正則表達式相關專題，可供學習參考。

當URLconf模塊載入的時候會預先編譯正則表達式，因此它的匹配搜索速度非常快，你通常感覺不到。

view：

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

kwargs：

任意數量的關鍵字參數可以作為一個字典傳遞給目標視圖。

name：

對你的URL進行命名，讓你能夠在Django的任意處，尤其是模板內顯式地引用它。這是一個非常強大的功能，相當於給URL取了個全局變數名，不會將url匹配地址寫死。

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