Django总结|部署服务器正常运行需要的settings.py的常用设置及其他常规设置

1、什么是项目配置文件
创建的Django项目中，会在根模块中包含一个settings.py配置文件，这个配置文件中用于配置和管理Django项目的管理运维信息

2、配置文件的特性

配置项
settings.py配置文件中的所有配置项都是大写的
默认值
settings.py在项目创建时，就初始化了一些默认配置，这些默认配置承载着最基础的项目信息
配置规则
可以从global_settings.py中导入全局配置，常规情况下，这是不必要的
在配置过程中，我们可以随时通过python manage.py diffsettings来查看当前settings文件和默认设置的不同之处
可以通过django.conf.settings模块中导入变量，在代码中访问配置信息，这样的话，就可以在程序运行过程中进行动态的settings配置修改
安全性
对于settings文件包含的信息，涉密的情况很多，需要严格控制settings.py文件的访问权限，在共享主机的情况下，这一点格外重要。

3、下面是一个常用的能够运行的django项目的settings.py的常用设置

"""
Django settings for inspiration_notebook project.

Generated by 'django-admin startproject' using Django 1.11.7.

For more information on this file, see
https://docs.djangoproject.com/en/1.11/topics/settings/

For the full list of settings and their values, see
https://docs.djangoproject.com/en/1.11/ref/settings/
"""
import os

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# Quick-start development settings - unsuitable for production
# See https://docs.djangoproject.com/en/1.11/howto/deployment/checklist/

# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = 'c09w)ly!ce0*jd#kup+j4mryn+u=dt=&2-oeik+%=d7#+mh2ao'

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

ALLOWED_HOSTS = ['xx.xx.', 'localhost', '0.0.0.0:8000', '127.0.0.1']

# Application definition
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'corsheaders',		#解决CORS
    'haystack',			#全文检索
    'account',			#用户行为app
    'note',				#自己的app
]

HAYSTACK_CONNECTIONS = {
    'default': {
        'ENGINE': 'note.whoosh_cn_backend.WhooshEngine',
        'PATH': os.path.join(BASE_DIR, 'whoosh_index'),
    }
}
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
HAYSTACK_SEARCH_RESULTS_PER_PAGE = 5


MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    # 'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'corsheaders.middleware.CorsMiddleware',
    'django.middleware.common.CommonMiddleware',
    'your_project.middlewares.MiddleTest'    #参见我的另一篇关于解决Django的跨域（CORS）问题的博客
]

CORS_ORIGIN_ALLOW_ALL = True
CORS_ALLOW_CREDENTIALS = True
# 记得需要加http
# CORS_ORIGIN_WHITELIST = [
#     # 'http://localhost:10000',
# ]
CORS_ORIGIN_WHITELIST = (
    '*'
)

CORS_ALLOW_METHODS = (
    'DELETE',
    'GET',
    'OPTIONS',
    'PATCH',
    'POST',
    'PUT',
)

CORS_ALLOW_HEADERS = (
    'accept',
    'accept-encoding',
    'authorization',
    'content-type',
    'dnt',
    'origin',
    'user-agent',
    'x-csrftoken',
    'x-requested-with',
    'cookie',
)


ROOT_URLCONF = 'inspiration_notebook.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                'django.template.context_processors.media',
            ],
        },
    },
]
WSGI_APPLICATION = 'your_project.wsgi.application'


# Database
# https://docs.djangoproject.com/en/1.11/ref/settings/#databases
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}


# Password validation
# https://docs.djangoproject.com/en/1.11/ref/settings/#auth-password-validators
AUTH_PASSWORD_VALIDATORS = [
    {
        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
    },
]


# Internationalization
# https://docs.djangoproject.com/en/1.11/topics/i18n/
LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'
USE_I18N = True
USE_L10N = True
USE_TZ = True

# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/1.11/howto/static-files/

STATIC_URL = '/static/'
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
]

MEDIA_ROOT = os.path.join(BASE_DIR, 'media').replace('\\', '/')     #设置静态文件路径为主目录下的media文件夹
MEDIA_URL = '/media/'

4、一些常规配置

ABSOLUTE_URL_OVERRIDES：默认值:{}
一个字典映射“app_label_module_name”字符串到一个函数，该函数接收一个Model对象作为参数并返回它的url，这是一个安装上覆盖get_absolute_url()方法的方式
ADMIN_FOR：默认值：()
用于admin-site settings模块，如果当前站点是admin，它是一个由settings模块组成的tuple字典
ADMIN_MEDIA_PREFIX：默认值：”/media/“
用于给admin模块设置媒体、CSS、JS和图片的前缀，请确保正确的使用它
ADMINS：默认值:()
一个包含2个元素的字典，列出了有权接收代码错误提示的邮件列表，当DEBUG=False时，如果一个view引发了异常，Django会将详细信息用电子邮件的方式发送给这些邮件地址，内容格式一般是（名称,邮箱），如：((“管理员A”,admin@damu.com),(“管理员B”,manager@damu.com))
ALLOWED_INCLUDE_ROOTS：默认值：()
一个字符擦混字典，列表中的元素为前缀的模板Django才可以以ssi形式方法，处于安全考虑，在不应该访问时即使是模板的坐着也不能访问这些文件
APPEND_SLASH：默认值：True
是否给URL添加一个结尾的斜线，只有安装了CommonMiddleware之后，该选项才起作用
CACHE_BACKEND：默认值：’simple://‘
后盾使用的cache缓存
CACHE_MIDDLEWARE_KEY_PREFIX：默认值:””
cache中间件使用的cache key前缀
DATABASE_ENGINE：默认值：”postgresql”
后端使用的数据库引擎：“posgresql”、”mysql”、”sqlite3”或者”ado_mssql”中的任意一个
DATABASE_HOST：默认值：””
数据库所在主机，空字符串意味着使用localhost SQLite.如果你使用MYSQL并且该选项以一个斜线”/“开始，MySQL会通过一个Unix socket连接到指定更多socket
DATABASE_NAME：默认值：””
要使用的数据库名称，默认的SQLite数据库不需要该项
DATABASE_PASSWORD：默认值：””
连接数据库时的登录密码，默认的SQLite数据库不需要该项
DATABASE_PORT：默认值：””
连接数据库时使用的端口，默认的SQLite不需要该项
DATABASE_USER：默认值：””
连接数据库时使用的用户名，SQLite不需要该项
DATE_FORMAT：默认值：”N j, Y”
对日期字段使用的默认日期格式
DEBUG：默认值：False
一个开关，用于是否打开调试模式
DEFAULT_CHARSET：默认值：”utf-8”
设置所有HttpResponse对象的默认字符集，构建Content-Type头数据
DEFAULT_CONTENT_TYPE：默认值：”text/html”
设置所有HttpResponse对对象的默认数据格式，构建Content-type头数据
EMAIL_HOST：默认值：“localhost”
用来发送e-mail电子邮件的主机
EMAIL_HOST_PASSWORD：默认值：””
EMAIL_HOST选项中定义的SMPT邮箱服务器登录密码，如果为空~Django就不会尝试进行认证
EMAIL_HOST_USER：默认值：””
EMAIL_HOST选项中定义的SMTP服务器使用的用户名，如果为空~Django将不会尝试进行认证
EMAIL_PORT：默认值：25
EMAIL_HOST选项指定的SMTP服务器使用的端口号
ENABLE_PSYCO：默认值False
确定是否使用pscyo优化python代码，需要依赖psyco模块
IGNORABLE_404_STARTS：默认值: (‘/cgi-bin/‘, ‘/_vti_bin’, ‘/_vti_inf’)
一个字符串 tuple . 以该tuple中元素为开头的 URL 应该被 404 e-mailer 忽略
INSTALLED_APPS：默认值: () (空的 tuple)
一个字符串tuple ,内容是本 Django 安装中的所有应用. 每个字符串应该是一个包含Django应用程序的Python包的路径全称, django-admin.py startapp 会自动往其中添加内容.
INTERNAL_IPS：默认值: () (空的 tuple)
一个 ip 地址的 tuple(字符串形式), 它:
当 DEBUG 为 True 时,参阅调试务注解
接收 X 头(若 XViewMiddleware 已安装), (参阅 middleware 文档)
JING_PATH
默认值: ‘/usr/bin/jing’
LANGUAGE_CODE：默认值: ‘en-us’
表示默认语言的一个字符串. 必须是标准语言格式. 举例来说, U.S. English 就是 “en-us”. 参阅internationalization docs.
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’)),
)
MANAGERS：默认值: ADMINS (不论 ADMINS 是否已经设置)
一个和 ADMINS 同样格式的 tuple , 当 SEND_BROKEN_LINK_EMAILS=True 时, 这些人有权接收死链接通知信息.
MEDIA_ROOT：默认值: ‘’ (空的字符串)
一个绝对路径, 用于保存媒体文件
MEDIA_URL默认值: ‘’ (空的字符串)
处理媒体服务的URL(媒体文件来自 MEDIA_ROOT)
PREPEND_WWW：默认值: False
是否为没有 “www.” 前缀的域名添加 “www.” 前缀. 当且仅当安装有 CommonMiddleware 后该选项才有效
ROOT_URLCONF默认值: Not defined
一个字符串,表示你的根 URLconf 的模块名. 举例来说:”mydjangoapps.urls”. 参阅 Django如何处理一个请求.
ECRET_KEY默认值: ‘’ (空的字符串)
一个密码. 用于为密码哈希算法提供一个种子.将其设置为一个随机字符串 – 越长越好. django-admin.py startproject 会自动给你创建一个.
SEND_BROKEN_LINK_EMAILS默认值: False
当有人从一个有效Django-powered页面访问另一个Django-powered页面时发现404错误(也就是发现一个死链接)时, 是否发送一封邮件给 MANAGERS. 当且仅当安装有 CommonMiddleware 时该选项才有效
SERVER_EMAIL
默认值: ‘root@localhost’
用来发送错误信息的邮件地址, 比如发送给 ADMINS 和 MANAGERS 的邮件.
SESSION_COOKIE_AGE：默认值: 1209600 (2周, 以秒计)
session cookies 的生命周期, 以秒计. 参阅 session docs.
SESSION_COOKIE_DOMAIN：默认值: None
session cookies 有效的域. 将其值设置为类似 “.lawrence.com” 这样 cookie 就可以跨域生效, 或者使用None 作为一个标准的域 cookie. 参阅 session docs.
SESSION_COOKIE_NAME默认值: ‘sessionid’
session 使用的cookie 名字. 参阅 session docs.
SESSION_SAVE_EVERY_REQUEST默认值: False
是否每次请求都保存session
SITE_ID默认值: Not defined
是一个整数, 表示 django_site 表中的当前站点. 当一个数据包含多个站点数据时，你的程序可以据此 ID 访问特定站点的数据．
TEMPLATE_DEBUG默认值: False
一个布尔值,用来开关模板调试模式.若设置为 True, 如果有任何 TemplateSyntaxError,一个详细的错误报告信息页将被显示给你.这个报告包括有关的模板片断,相应的行会自动高亮.
注意 Django 仅在 DEBUG 为 True 时显示这个信息页面.
TEMPLATE_DIRS默认值: () (空的 tuple)
模板源文件目录列表,按搜索顺序. 注意要使用 Unix-风格的前置斜线(即’/‘), 即便是在 Windows 上.
TEMPLATE_LOADERS默认值:(‘django.template.loaders.filesystem.load_template_source’,)
一个元素为可调用对象(字符串形式的)的 tuple. 这些对象知道如何导入 templates 从各种源中. 参阅 template documentation.
EMPLATE_STRING_IF_INVALID默认值: ‘’ (空的字符串)
输出文本, 作为一个字符串. 模板系统将会在出错 (比如说拼错了) 时使用该变量. 参阅 How invalid variables are handled.
TIME_FORMAT默认值: ‘P’ (举例来说 4 p.m.)
Django admin change-list 使用的默认时间格式. 有可能系统的其它部分也使用该格式. 参阅 allowed date format strings.
TIME_ZONE默认值: ‘America/Chicago’ (我们可以用 ‘Asia/Shanghai PRC’ )
一个表示当前时区的字符串. 参阅选择项列表.
Django 据此设置转换所有的日期/时间 – 并不考虑服务器的时区设置. 举例来说, 一台服务器可以服务多个Django-powered 站点,每个站点使用一个独立的时区设置.
USE_ETAGS默认值: False
一个布尔值.指定是否输出 “Etag” 头. 这个选项可以节省网络带宽,但损失性能. 只有安装 CommonMiddleware 后这个选项才有用(参阅 middleware 文档)

5、参考博客及官方文档
&emsp;［1］ https://buildmedia.readthedocs.org/media/pdf/django/2.0.x/django.pdf
&emsp;［2］ https://docs.djangoproject.com/en/1.11/topics/settings/
&emsp;［3］ https://www.jianshu.com/p/3219e8fa1fff