我們昨天解釋了 django-admin 為你產生的專案架構。今天我們要把架構中缺少的設定補上,讓這個專案能夠執行。下面是我們的專案架構,以防你忘記了(從現在起我會省略最外層目錄,反正它裡面只有兩個目錄,而且其中 venv 的內容不重要):
lunch
├── lunch
│ ├── __init__.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
└── manage.py
首先我們打開 lunch/lunch/settings.py,解釋一下各設定的用途。
你會發現所有的全域變數都是用大寫與底線構成。這是 Django 設定的命名慣例。我們忽略其他東西(註釋和 import 等等),來看看這些設定的用途。
這個設定代表專案的根目錄。預設是
os.path.dirname(os.path.dirname(__file__))
亦即「這個檔案的外層的外層」,也就是上面那個樹狀圖的第一個 lunch(亦即 django-admin建立的外層 lunch 目錄)。
這是 Django 用來加密資訊的重要變數。Django 會用它來加密你的 session 內容、處理 cookie 值、以及管理資料庫裡的帳號密碼等等。因為這可以用來推出很多敏感資訊,所以非常重要。
預設值是 Django 隨機產生的。你可以直接使用,也可以自己產生一組。如果不知道怎麼產生,有個網頁https://djskgen.herokuapp.com/ 還滿好用的,可以參考。
如果設為 True,則 Django 會在遇到錯誤時顯示各式各樣的錯誤訊息,協助你找到問題。所以通常我們在正式開站前要設成 False,不然就會和某市長候選人的官方網站一樣被嘲笑。
跟上面那個差不多,只是它可以顯示 template 中的錯誤。我們之後會再說明 template 是什麼,不過反正這也是一樣在正式開站時要關掉,不然就會像某市長候⋯⋯(夠了)。
好,先看到這邊。我們在網站上線時要把 DEBUG 和 TEMPLATE_DEBUG 關掉。可是在開發時,我們當然想看完整的錯誤訊息。所以這兩個環境的設定不能一樣。可是如果我們每次都在要上線時才改設定,肯定遲早會忘記,然後就像某團隊一樣出包。為了避免這個狀況,我們通常我們會有至少兩個設定檔:一個開發用,一個部署用。[註 1]
為了方便管理這些設定檔,我們建議把它們通通丟到一個 settings 模組裡。所以我們在原本settings.py 的位置創建一個目錄,叫做 settings,然後把 settings.py 丟進去,並改名為 base.py。然後在 settings 目錄裡多建立三個空白檔案:__init__.py、local.py、production.py。
現在你的專案目錄應該會長這個樣子:
lunch
├── lunch
│ ├── __init__.py
│ ├── settings
│ │ ├── __init__.py
│ │ ├── base.py
│ │ ├── local.py
│ │ └── production.py
│ ├── urls.py
│ └── wsgi.py
└── manage.py
settings 裡面除了 __init__.py 之外的三個檔案的作用會是:
base
[*].py:用來存放所有設定中共通的部分。
local
[*].py:本機(開發機)用的設定。
production
[*].py:正式部署到 production server 時用的設定。
接著我們把 local.py 的內容改成這樣:
from .base import *
SECRET_KEY = '某個產生的 secret key 執,請自行代換'
DEBUG = True
TEMPLATE_DEBUG = True
然後把 base.py 裡的這三個設定刪掉。我們之後在本機開發時,就會改用這個檔案,而不是原本的 settings.py。
由於設定檔換位置了,我們就得再改一個參數。打開 base.py,把 BASE_DIR 改成這樣:
BASE_DIR = os.path.dirname(os.path.dirname(os.path.dirname(__file__)))
因為我們把設定檔拿進了一層(原本是 lunch/settings.py,現在是lunch/settings/local.py),所以這個路徑要多往外跳一層才會正確。
接著我們還要告訴 Django 我們的設定檔已經換位置了。如果你還記得昨天的內容,Django 是用 DJANGO_SETTINGS_MODULE 這個環境變數來檢查設定檔位置。所以我們可以在命令列把環境變數設起來:
export DJANGO_SETTINGS_MODULE=lunch.settings.local
Windows 使用者請使用
set DJANGO_SETTINGS_MODULE=lunch.settings.local
不過環境變數每次重開終端機都會重設,很不方便。所以你可以在虛擬環境的 activate 指令裡加上這一行。打開 venv/lunch/bin/activate(Windows 是venv\lunch\Scripts\activate.bat),在最後面新增一行,加入上面的指令。這樣你之後啟用虛擬環境時,就會自動更新環境變數了。
接著,在 base.py 找到這一段:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
這是用來設定資料庫的設定。預設是使用 SQLite 3,不過如果你的機器裡有 PostgreSQL、MySQL 或 Oracle,Django 也有官方支援(還有些非官方的模組支援其他的)。因為網站正式部署時也會和你本機用的不同,所以我們同樣要把這段放到 local.py 裡。把上面這段直接刪掉,然後在 local.py 加上這段:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(os.path.dirname(BASE_DIR), 'db.sqlite3'),
}
}
如果你想用其他資料庫,請參考官方文件。注意你必須安裝合適的 Python 函式庫:
而且這些都需要 C 編譯器與 Python 頭文件。如果你不知道要怎麼設定,那麼就先暫時用 SQLite 3 吧。
設定完之後,你的 local.py 應該會長得像這樣(假設你用 SQLite 3):
from .base import * # noqa
SECRET_KEY = '同上,請自行代換'
DEBUG = True
TEMPLATE_DEBUG = True
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(os.path.dirname(BASE_DIR), 'db.sqlite3'),
}
}
接著我們用以下的指令,在資料庫裡建立預設需要的表格:(請 cd 到 manage.py 所在的目錄再執行)
python manage.py migrate
你應該會看到這樣的輸出:
Operations to perform:
Apply all migrations: admin, contenttypes, auth, sessions
Running migrations:
Applying contenttypes.0001_initial... OK
Applying auth.0001_initial... OK
Applying admin.0001_initial... OK
Applying sessions.0001_initial... OK
代表成功。如果你使用 SQLite 3,應該會在專案目錄外面(和 venv 同一層)發現一個叫 db.sqlite3 的檔案,代表我們的資料庫。(如果使用其他資料庫,也可以自己檢查一下裡面是否被建立的新的 tables。)現在我們(終於)可以執行這個網站了!Django 內建的執行指令是:
python manage.py runserver
執行後應該會看到類似這樣的輸出
Performing system checks...
System check identified no issues (0 silenced).
September 31, 2014 - 09:48:08
Django version 1.7, using settings 'lunch.settings.local'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
如果你在瀏覽器輸入 http://127.0.0.1:8000/,就可以看到 Django 的預設頁面。標題是「It worked!」就代表成功了。
要停止網站伺服器,請按 control + c。
好,設定都完成了,接下來⋯⋯終於可以開始做網站了?
⋯⋯
如果你還沒被我嚇跑,應該至少也早就暗幹在心:哪有一個 framework 要搞這麼多有的沒的,還不能開始做網站?廢爆了!嗯,如果你只是要讓網站可以動,當然其實根本不需要費這麼多工夫;看看市面上的 Django 教學,例如官方的這篇,或者良葛格的這篇,或者 Andy 的這篇,或者 Django Girls Taipei 的這篇,通通都超快 runserver 的啊!
但是這對你沒有好處。反而,如果你可以先把設定都搞定,未來在開發時才能一切順利。我一開始就有說這個教學很硬了嘛。好消息是,你已經把最麻煩的部分都差不多搞定了,接下來的開發會順很多。
所以明日待續。
1.實務上可能還會更多,例如還要多加一個用來內部測試,部署的機器也可能不止一台所以又會各自不同等等。不過就我們這個自用小網站而言,開發部署各一就夠了。
<pre class="c" name="code">python manage.py migrate
Django 1.7 之後才有這個指令