Django - 工程搭建
1 學習目標
- 搭建環境
- 建立工程
- 建立應用
- 瞭解工程目錄結構
- 定義檢視與路由
2 環境安裝
2.1 建立虛擬環境
mkvirtualenv django_py3_1.11 -p python3
注意:需要聯網(django_py3_1.11 為虛擬環境名稱)
2.2 安裝 Django
使用django 1.11.11版本,注意需要聯網
pip install django==1.11.11
2.3 複習虛擬環境和pip的命令
# 虛擬環境 mkvirtualenv # 建立虛擬環境 rmvirtualenv # 刪除虛擬環境 workon # 進入虛擬環境、檢視所有虛擬環境 deactivate # 退出虛擬環境 # pip pip install # 安裝依賴包 pip uninstall # 解除安裝依賴包 pip list # 檢視已安裝的依賴包 pip freeze # 凍結當前環境的依賴包
3 建立工程
在使用Flask框架時,專案工程目錄的組織與建立是需要我們自己手動建立完成的。
在django中,專案工程目錄可以藉助django提供的命令幫助我們建立。
3.1 建立
建立工程的命令為:
django-admin startproject 工程名稱
例如:想要在桌面的code目錄中建立一個名為demo的專案工程,可執行如下命令:
cd ~/Desktop/code
django-admin startproject demo
執行後,會多出一個新目錄名為demo,此即為新建立的工程目錄。
3.2 工程目錄說明
檢視建立的工程目錄,結構如下
- 與專案同名的目錄,此處為demo。
- settings.py 是專案的整體配置檔案。
- urls.py 是專案的URL配置檔案。
- wsgi.py 是專案與WSGI相容的Web伺服器入口。
- manage.py 是專案管理檔案,通過它管理專案。
3.3 執行開發伺服器
在開發階段,為了能夠快速預覽到開發的效果,django提供了一個純python編寫的輕量級web伺服器,僅在開發階段使用。
執行伺服器命令如下:
python manage.py runserver ip:埠 或: python manage.py runserver
可以不寫IP和埠,預設IP是127.0.0.1,預設埠為8000。
啟動後可見如下資訊:
在瀏覽器中輸入網址“127.0.0.1:8000”便可看到效果。
- django預設工作在調式Debug模式下,如果增加、修改、刪除檔案,伺服器會自動重啟。
- 按ctrl+c停止伺服器。
4 建立子應用
在Web應用中,通常有一些業務功能模組是在不同的專案中都可以複用的,故在開發中通常將工程專案拆分為不同的子功能模組,各功能模組間可以保持相對的獨立,在其他工程專案中需要用到某個特定功能模組時,可以將該模組程式碼整體複製過去,達到複用。
在Flask框架中也有類似子功能應用模組的概念,即藍圖Blueprint。
Django的檢視編寫是放在子應用中的。
4.1 建立
在django中,建立子應用模組目錄仍然可以通過命令來操作,即:
python manage.py startapp 子應用名稱
manage.py 為上述建立工程時自動生成的管理檔案。
例如,在剛才建立的demo工程中,想要建立一個使用者users子應用模組,可執行:
cd ~/Desktop/code/demo
python manage.py startapp users
執行後,可以看到工程目錄中多出了一個名為users的子目錄。
4.2 子應用目錄說明
檢視此時的工程目錄,結構如下:
- admin.py 檔案跟網站的後臺管理站點配置相關。
- apps.py 檔案用於配置當前子應用的相關資訊。
- migrations 目錄用於存放資料庫遷移歷史檔案。
- models.py 檔案使用者儲存資料庫模型類。
- tests.py 檔案用於開發測試用例,編寫單元測試。
- views.py 檔案用於編寫Web應用檢視。
4.3 註冊安裝子應用
創建出來的子應用目錄檔案雖然被放到了工程專案目錄中,但是django工程並不能立即直接使用該子應用,需要註冊安裝後才能使用。
在工程配置檔案settings.py中,INSTALLED_APPS項儲存了工程中已經註冊安裝的子應用,初始工程中的INSTALLED_APPS如下:
註冊安裝一個子應用的方法,即是將子應用的配置資訊檔案apps.py中的Config類新增到INSTALLED_APPS列表中。
例如,將剛建立的users子應用新增到工程中,可在INSTALLED_APPS列表中新增'users.apps.UsersConfig'。
5 建立檢視
同Flask框架一樣,Django也用檢視來編寫Web應用的業務邏輯。
Django的檢視是定義在子應用的views.py中的。
5.1 建立
開啟剛建立的users模組,在views.py中編寫檢視程式碼。
from django.http import HttpResponse
def index(request):
"""
index檢視
:param request: 包含了請求資訊的請求物件
:return: 響應物件
"""
return HttpResponse("hello the world!")
說明:
- 檢視函式的第一個傳入引數必須定義,用於接收Django構造的包含了請求資料的HttpReqeust物件,通常名為request。
- 檢視函式的返回值必須為一個響應物件,不能像Flask一樣直接返回一個字串,可以將要返回的字串資料放到一個HTTPResponse物件中。
5.2 定義路由URL
1) 在子應用中新建一個urls.py檔案用於儲存該應用的路由。
2) 在users/urls.py檔案中定義路由資訊。
from django.conf.urls import url
from . import views
# urlpatterns是被django自動識別的路由列表變數
urlpatterns = [
# 每個路由資訊都需要使用url函式來構造
# url(路徑, 檢視)
url(r'^index/$', views.index),
]
3) 在工程總路由demo/urls.py中新增子應用的路由資料。
from django.conf.urls import url, include
from django.contrib import admin
urlpatterns = [
url(r'^admin/', admin.site.urls), # django預設包含的
# 新增
url(r'^users/', include('users.urls')),
]
- 使用include來將子應用users裡的全部路由包含進工程路由中;
- r'^users/' 決定了users子應用的所有路由都已/users/開頭,如我們剛定義的檢視index,其最終的完整訪問路徑為/users/index/。
include函式除了可以傳遞字串之外,也可以直接傳遞應用的urls模組,如
from django.conf.urls import url, include
from django.contrib import admin
import users.urls # 先匯入應用的urls模組
urlpatterns = [
url(r'^admin/', admin.site.urls),
# url(r'^users/', include('users.urls')),
url(r'^users/', include(users.urls)), # 新增應用的路由
]
4) 啟動執行
重新啟動django程式
python manage.py runserver
在瀏覽器中輸入網址127.0.0.1:8000/users/index/ 可看到返回的資訊