【5】Django項目配置settings.py詳解
阿新 • • 發佈:2018-12-05
cal 哈希 組成 data 模型 apps orm 可調用對象 別人
夫唯不爭,故天下莫能與之爭
——老子《道德經》
本節內容
- 1.項目配置文件settings.py介紹
- 2.數據庫配置【MySQL】
- 3.創建模型對象並和數據庫同步
- 4.python官方提供的項目後臺管理平臺的使用
註意:本節內容我們會按照三部分進行分步講解
我們創建好了一個Python項目(mysite/)之後,需要在項目中添加模塊應用(polls/),在模塊應用中添加處理功能邏輯,如添加模塊中的視圖處理函數(polls.views.index()),這是一個python項目簡單的結構模型
但是上面的項目應用,這是在一個項目中包含了一個模塊應用,如果讓項目對模塊應用的數據進行管理;同時按照常規項目處理要求,項目中的數據要保存到指定的數據庫中;同時我們得有一個對項目信息進行管理的系統平臺;本節內容中就要對於這些亟待解決的問題進行解決(大家同樣可以參考官方文檔的操作方式)
1. 項目配置文件settings.py
創建的Django項目中,會在根模塊中包含一個settings.py
配置文件,這個配置文件中用於配置和管理Django項目的管理運維信息
1.1. 配置文件的特性
- 配置項
settings.py配置文件中的所有配置項都是大寫的 - 默認值
settings.py在項目創建時,就初始化了一些默認配置,這些默認配置承載著最基礎的項目信息 - 配置規則
可以從global_settings.py中導入全局配置,常規情況下,這是不必要的
在配置過程中,我們可以隨時通過python manage.py diffsettings
來查看當前settings文件和默認設置的不同之處
可以通過django.conf.settings
- 安全性
對於settings文件包含的信息,涉密的情況很多,需要嚴格控制settings.py文件的訪問權限,在共享主機的情況下,這一點格外重要。
1.2. 常規配置
前一段時間江湖流行武術打假,接下來,就是一堆的硬功夫了~~非常之枯燥,看看就行,我們只需要知道別人的招數是做什麽用的就好!,當然,絕招還是會提示的
友情提示:千萬別修煉下面這些玩意兒!如果興趣不大可以直接翻頁到下一節內容
- 1.2.1 ABSOLUTE_URL_OVERRIDES:默認值:{}
一個字典映射“app_label_module_name”字符串到一個函數,該函數接收一個Model對象作為參數並返回它的url,這是一個安裝上覆蓋get_absolute_url()方法的方式 - 1.2.2 ADMIN_FOR:默認值:()
用於admin-site settings模塊,如果當前站點是admin,它是一個由settings模塊組成的tuple字典 - 1.2.3 ADMIN_MEDIA_PREFIX:默認值:"/media/"
用於給admin模塊設置媒體、CSS、JS和圖片的前綴,請確保正確的使用它 - 1.2.4 ADMINS:默認值:()
一個包含2個元素的字典,列出了有權接收代碼錯誤提示的郵件列表,當DEBUG=False時,如果一個view引發了異常,Django會將詳細信息用電子郵件的方式發送給這些郵件地址,內容格式一般是(名稱,郵箱),如:(("管理員A",[email protected]),("管理員B",[email protected])) - 1.2.5 ALLOWED_INCLUDE_ROOTS:默認值:()
一個字符擦混字典,列表中的元素為前綴的模板Django才可以以{%ssi%}形式方法,處於安全考慮,在不應該訪問時即使是模板的坐著也不能訪問這些文件 - 1.2.6 APPEND_SLASH:默認值:True
是否給URL添加一個結尾的斜線,只有安裝了CommonMiddleware之後,該選項才起作用 - 1.2.7 CACHE_BACKEND:默認值:‘simple://‘
後盾使用的cache緩存 - 1.2.8 CACHE_MIDDLEWARE_KEY_PREFIX:默認值:""
cache中間件使用的cache key前綴 - 1.2.9 DATABASE_ENGINE:默認值:"postgresql"
後端使用的數據庫引擎:“posgresql”、"mysql"、"sqlite3"或者"ado_mssql"中的任意一個 - 1.2.10 DATABASE_HOST:默認值:""
數據庫所在主機,空字符串意味著使用localhost SQLite.如果你使用MYSQL並且該選項以一個斜線"/"開始,MySQL會通過一個Unix socket連接到指定更多socket - 1.2.11 DATABASE_NAME:默認值:""
要使用的數據庫名稱,默認的SQLite數據庫不需要該項 - 1.2.12 DATABASE_PASSWORD:默認值:""
連接數據庫時的登錄密碼,默認的SQLite數據庫不需要該項 - 1.2.13 DATABASE_PORT:默認值:""
連接數據庫時使用的端口,默認的SQLite不需要該項 - 1.2.14 DATABASE_USER:默認值:""
連接數據庫時使用的用戶名,SQLite不需要該項 - 1.2.15 DATE_FORMAT:默認值:"N j, Y"
對日期字段使用的默認日期格式 - 1.2.16 DEBUG:默認值:False
一個開關,用於是否打開調試模式 - 1.2.17 DEFAULT_CHARSET:默認值:"utf-8"
設置所有HttpResponse對象的默認字符集,構建Content-Type頭數據 - 1.2.18 DEFAULT_CONTENT_TYPE:默認值:"text/html"
設置所有HttpResponse對對象的默認數據格式,構建Content-type頭數據 - 1.2.19 EMAIL_HOST:默認值:“localhost”
用來發送e-mail電子郵件的主機
1.2.20 EMAIL_HOST_PASSWORD:默認值:""
EMAIL_HOST選項中定義的SMPT郵箱服務器登錄密碼,如果為空~Django就不會嘗試進行認證 - 1.2.21 EMAIL_HOST_USER:默認值:""
EMAIL_HOST選項中定義的SMTP服務器使用的用戶名,如果為空~Django將不會嘗試進行認證 - 1.2.22 EMAIL_PORT:默認值:25
EMAIL_HOST選項指定的SMTP服務器使用的端口號 - 1.2.23 ENABLE_PSYCO:默認值False
確定是否使用pscyo優化python代碼,需要依賴psyco模塊
1.2.24 IGNORABLE_404_STARTS:默認值: (‘/cgi-bin/‘, ‘/vti_bin‘, ‘/vti_inf‘)
一個字符串 tuple . 以該tuple中元素為開頭的 URL 應該被 404 e-mailer 忽略
1.2.25 INSTALLED_APPS:默認值: () (空的 tuple)
一個字符串tuple ,內容是本 Django 安裝中的所有應用. 每個字符串應該是一個包含Django應用程序的Python包的路徑全稱, django-admin.py startapp 會自動往其中添加內容.
1.2.26 INTERNAL_IPS:默認值: () (空的 tuple)
一個 ip 地址的 tuple(字符串形式), 它:
當 DEBUG 為 True 時,參閱調試務註解
接收 X 頭(若 XViewMiddleware 已安裝), (參閱 middleware 文檔)
JING_PATH
默認值: ‘/usr/bin/jing‘
1.2.27 LANGUAGE_CODE:默認值: ‘en-us‘
表示默認語言的一個字符串. 必須是標準語言格式. 舉例來說, U.S. English 就是 "en-us". 參閱internationalization docs.
1.2.28 LANGUAGES:默認值: 一個 tuple (內容為所有可用語言). 目前它的值是:
LANGUAGES = (
(‘bn‘, (‘Bengali‘)),
(‘cs‘, (‘Czech‘)),
(‘cy‘, (‘Welsh‘)),
(‘da‘, (‘Danish‘)),
(‘de‘, (‘German‘)),
(‘en‘, (‘English‘)),
(‘es‘, (‘Spanish‘)),
(‘fr‘, (‘French‘)),
(‘gl‘, (‘Galician‘)),
(‘is‘, (‘Icelandic‘)),
(‘it‘, (‘Italian‘)),
(‘no‘, (‘Norwegian‘)),
(‘pt-br‘, (‘Brazilian‘)),
(‘ro‘, (‘Romanian‘)),
(‘ru‘, (‘Russian‘)),
(‘sk‘, (‘Slovak‘)),
(‘sr‘, (‘Serbian‘)),
(‘sv‘, (‘Swedish‘)),
(‘zh-cn‘, _(‘Simplified Chinese‘)),
)
1.2.29 MANAGERS:默認值: ADMINS (不論 ADMINS 是否已經設置)
一個和 ADMINS 同樣格式的 tuple , 當 SEND_BROKEN_LINK_EMAILS=True 時, 這些人有權接收死鏈接通知信息.
1.2.30 MEDIA_ROOT:默認值: ‘‘ (空的字符串)
一個絕對路徑, 用於保存媒體文件
1.2.31 MEDIA_URL默認值: ‘‘ (空的字符串)
處理媒體服務的URL(媒體文件來自 MEDIA_ROOT)
1.2.32 PREPEND_WWW:默認值: False
是否為沒有 "www." 前綴的域名添加 "www." 前綴. 當且僅當安裝有 CommonMiddleware 後該選項才有效
1.2.33 ROOT_URLCONF默認值: Not defined
一個字符串,表示你的根 URLconf 的模塊名. 舉例來說:"mydjangoapps.urls". 參閱 Django如何處理一個請求.
1.2.24 ECRET_KEY默認值: ‘‘ (空的字符串)
一個密碼. 用於為密碼哈希算法提供一個種子.將其設置為一個隨機字符串 -- 越長越好. django-admin.py startproject 會自動給你創建一個.
1.2.25 SEND_BROKEN_LINK_EMAILS默認值: False
當有人從一個有效Django-powered頁面訪問另一個Django-powered頁面時發現404錯誤(也就是發現一個死鏈接)時, 是否發送一封郵件給 MANAGERS. 當且僅當 安裝有 CommonMiddleware 時該選項才有效
1.2.26 SERVER_EMAIL
默認值: ‘root@localhost‘
用來發送錯誤信息的郵件地址, 比如發送給 ADMINS 和 MANAGERS 的郵件.
1.2.27 SESSION_COOKIE_AGE:默認值: 1209600 (2周, 以秒計)
session cookies 的生命周期, 以秒計. 參閱 session docs.
1.2.28 SESSION_COOKIE_DOMAIN:默認值: None
session cookies 有效的域. 將其值設置為類似 ".lawrence.com" 這樣 cookie 就可以跨域生效, 或者使用None 作為一個標準的域 cookie. 參閱 session docs.
1.2.29 SESSION_COOKIE_NAME默認值: ‘sessionid‘
session 使用的cookie 名字. 參閱 session docs.
1.2.30 SESSION_SAVE_EVERY_REQUEST默認值: False
是否每次請求都保存session
1.2.31 SITE_ID默認值: Not defined
是一個整數, 表示 django_site 表中的當前站點. 當一個數據包含多個站點數據時,你的程序可以據此 ID 訪問特定站點的數據.
1.2.32 TEMPLATE_DEBUG默認值: False
一個布爾值,用來開關模板調試模式.若設置為 True, 如果有任何 TemplateSyntaxError,一個詳細的錯誤報告信息頁將被顯示給你.這個報告包括有關的模板片斷,相應的行會自動高亮.
註意 Django 僅在 DEBUG 為 True 時顯示這個信息頁面.
1.2.33 TEMPLATE_DIRS默認值: () (空的 tuple)
模板源文件目錄列表,按搜索順序. 註意要使用 Unix-風格的前置斜線(即‘/‘), 即便是在 Windows 上.
1.2.34 TEMPLATE_LOADERS默認值:(‘django.template.loaders.filesystem.load_template_source‘,)
一個元素為可調用對象(字符串形式的)的 tuple. 這些對象知道如何導入 templates 從各種源中. 參閱 template documentation.
1.2.35 EMPLATE_STRING_IF_INVALID默認值: ‘‘ (空的字符串)
輸出文本, 作為一個字符串. 模板系統將會在出錯 (比如說拼錯了) 時使用該變量. 參閱 How invalid variables are handled.
1.2.36 TIME_FORMAT默認值: ‘P‘ (舉例來說 4 p.m.)
Django admin change-list 使用的默認時間格式. 有可能系統的其它部分也使用該格式. 參閱 allowed date format strings.
1.2.37 TIME_ZONE默認值: ‘America/Chicago‘ (我們可以用 ‘Asia/Shanghai PRC‘ )
一個表示當前時區的字符串. 參閱 選擇項列表.
Django 據此設置轉換所有的日期/時間 -- 並不考慮服務器的時區設置. 舉例來說, 一臺服務器可以服務多個Django-powered 站點,每個站點使用一個獨立的時區設置.
1.2.38 USE_ETAGS默認值: False
一個布爾值.指定是否輸出 "Etag" 頭. 這個選項可以節省網絡帶寬,但損失性能. 只有安裝 CommonMiddleware 後這個選項才有用(參閱 middleware 文檔)
【5】Django項目配置settings.py詳解