[TOC] ## **一、 新建項目** **PS：** 這一小結，并不一定需要在命令行下操作，我們可以在Pycharm環境下進行，并且同時創建虛擬環境。參考上節內容。 進入你期望的項目保存目錄，運行下面的命令： ~~~ $ 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 asgi.py wsgi.py ~~~ 各文件和目錄解釋： * 外層的`mysite/`目錄與Django無關，只是你項目的容器，可以任意重命名。 * `manage.py`：一個命令行工具，管理Django的交互腳本。 * 內層的`mysite/`目錄是真正的項目文件包裹目錄，它的名字是你引用內部文件的Python包名，例如：`mysite.urls`。 * `mysite/__init__.py`:一個定義包的空文件。 * `mysite/settings.py`:項目的配置文件。 * `mysite/urls.py`:路由文件，所有的任務都是從這里開始分配，相當于Django驅動站點的目錄。 * `mysite/wsgi.py`:一個基于WSGI的web服務器進入點，提供底層的網絡通信功能，通常不用關心。 * `mysite/asgi.py`：一個基于ASGI的web服務器進入點，提供異步的網絡通信功能，通常不用關心。 <br /> ## **二、 啟動開發服務器** 回到mysite項目的根目錄，也就是`manage.py`文件的同級目錄下，輸入下面的命令： ~~~ $ python3 manage.py runserver ~~~ 你會看到下面的提示，這表明Django的開發服務器已經啟動，開始提供Web服務了： ~~~ Performing system checks... System check identified no issues (0 silenced). You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions. Run 'python manage.py migrate' to apply them. August 31, 2020 - 15:01:31 Django version 3.1, using settings 'mysite.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CTRL-BREAK. ~~~ **Django提供了一個用于開發的web服務器，使你無需配置一個類似Ngnix的生產服務器，就能讓站點運行起來。**這是一個由Python編寫的輕量級服務器，簡易并且不安全，因此不要將它用于生產環境。 打開瀏覽器，訪問`http://127.0.0.1:8000/`，你將看到Django的火箭歡迎界面，一切OK！ Django的開發服務器（以后簡稱服務器）默認運行在內部的8000端口，如果你想指定端口，請在命令中顯示給出： ~~~ $ python3 manage.py runserver 8080 ~~~ 如果想修改服務器的ip地址，請按下面的方式運行命令，比如： ~~~ $ python3 manage.py runserver 0:8000 ~~~ 0 是 0.0.0.0 的簡寫，Django將運行在0.0.0.0:8000上，整個局域網內都將可以訪問站點，而不只是是本機（這其中可能還需要做一些配置和網絡測試）。 注意：**Django的開發服務器具有自動重載功能，當你的Python代碼有修改，服務器會在一個周期后自動更新。** 但是，有一些動作，比如增加文件，不會觸發服務器重載，這時就需要你自己手動重啟。所以建議，在任何修改代碼的操作后，手動重啟開發服務器，確保修改被應用。 PS: 重啟服務器的操作在Pycharm里只需要簡單地點擊按鈕即可。  <br /> ## **三、 創建投票應用(app)** 在 Django 中，每一個應用（app）都是一個 Python 包，并且遵循著相同的約定。Django 自帶一個工具，可以幫你生成應用的基礎目錄結構。 app應用與project項目的區別： * 一個app實現某個具體功能，比如博客、公共檔案數據庫或者簡單的投票系統； * 一個project是配置文件和多個app的集合，這些app組合成整個站點； * 一個project可以包含多個app； * 一個app可以屬于多個project！ app的存放位置可以是任何地點，但是通常都將它們放在與`manage.py`腳本同級的目錄下，這樣方便導入文件。 進入mysite項目根目錄，確保與`manage.py`文件處于同一級，輸入下述命令： `$ python3 manage.py startapp polls` 系統會自動生成 polls應用的目錄，其結構如下： ~~~ polls/ __init__.py admin.py apps.py migrations/ __init__.py models.py tests.py views.py ~~~ 在Pycharm中，沒有可以創建app的圖形化按鈕，需要在下方的`Terminal`終端中輸入命令： ~~~ python3 manage.py startapp polls ~~~ 這樣也能創建polls應用。  通過前面在Pycharm中創建工程的方式有個方便之處，點擊Terminal后，會自動進入虛擬環境。 <br /> ## **四、編寫第一個視圖** 下面，我們編寫一個視圖，也就是具體的業務代碼。 在`polls/views.py`文件中，編寫代碼： ~~~ from django.http import HttpResponse def index(request): return HttpResponse("這里是liujiangblog.com的投票站點") ~~~ 為了調用該視圖，我們還需要編寫urlconf，也就是路由配置。在polls目錄中新建一個文件，名字為`urls.py`（不要換成別的名字），在其中輸入代碼如下： ~~~ from django.urls import path from . import views urlpatterns = [ path('', views.index, name='index'), ] ~~~ 此時，目錄的文件結構是這樣的： ~~~ polls/ __init__.py admin.py apps.py migrations/ __init__.py models.py tests.py urls.py views.py ~~~ 我們先不用深究`urls.py`中代碼的具體含義。 接下來，在項目的**主urls.py文件**中添加`urlpattern`條目，指向我們剛才建立的polls這個app獨有的urls.py文件，這里需要導入include模塊。打開`mysite/urls.py`文件，代碼如下： ~~~ from django.contrib import admin from django.urls import include, path urlpatterns = [ path('polls/', include('polls.urls')), path('admin/', admin.site.urls), ] ~~~ include語法相當于多級路由，它把接收到的url地址去除與此項匹配的部分，將剩下的字符串傳遞給下一級路由urlconf進行判斷。在路由的章節，有更加詳細的用法指導。 <br /> include的背后是一種即插即用的思想。項目的根路由不關心具體app的路由策略，只管往指定的二級路由轉發，實現了應用解耦。app所屬的二級路由可以根據自己的需要隨意編寫，不會和其它的app路由發生沖突。app目錄可以放置在任何位置，而不用修改路由。這是軟件設計里很常見的一種模式。 <br /> **建議**：除了admin路由外，盡量給每個app設計自己獨立的二級路由。 <br /> 好了，路由設置成功后，啟動服務器，然后在瀏覽器中訪問地址`http://localhost:8000/polls/`。一切正常的話，你將看到`這里是liujiangblog.com的投票站點` <br /> ## **五、path()方法** 一個路由配置模塊就是一個urlpatterns列表，列表的每個元素都是一項path，每一項path都是以path()的形式存在。 <br /> path()方法可以接收4個參數，其中前2個是必須的：`route`和`view`，以及2個可選的參數：`kwargs`和`name`。 以下面的代碼為例： ~~~ from django.urls import path from . import views urlpatterns = [ path('', views.index, name='index'), ] ~~~ ### **route** route 是一個匹配 URL 的準則（類似正則表達式）。當 Django 響應一個請求時，它會從 urlpatterns 的第一項path開始，按順序依次匹配列表中的項，直到找到匹配的項，然后執行該條目映射的視圖函數或下級路由，其后的條目將不再繼續匹配。因此，url路由執行的是短路機制，path的編寫順序非常重要！ <br /> 例子中對應的route就是空字符串`''` <br /> 需要注意的是，route不會匹配 GET 和 POST 參數或域名。例如，URLconf 在處理請求`https://www.liujiangblog.com/myapp/`時，它會嘗試匹配`myapp/`。處理請求`https://www.liujiangblog.com/myapp/?page=3`時，也只會嘗試匹配`myapp/`。 <br /> ### **view** view指的是處理當前url請求的視圖函數。當Django匹配到某個路由條目時，自動將封裝的`HttpRequest`對象作為第一個參數，被“捕獲”的參數以關鍵字參數的形式，傳遞給該條目指定的視圖view。 例子中對應的view就是`views.index` <br /> ### **kwargs** 任意數量的關鍵字參數可以作為一個字典傳遞給目標視圖。 本例中沒有使用這個參數。 <br /> ### **name** 對你的URL進行命名，讓你能夠在Django的任意處，尤其是模板內顯式地引用它。這是一個非常強大的功能，相當于給URL取了個全局變量名，不會將url匹配地址寫死。 本例子中沒有使用這個參數。 path()方法的四個參數，每個都非常有講究，這里先做基本的介紹，在后面有詳細的論述。