《玩转Django2.0》读书笔记-Django配置信息
作者：尹正杰
版权声明：原创作品，谢绝转载！否则将追究法律责任。
项目配置是根据实际开发需求从而对整个Web框架编写相应配置信息。配置信息主要由项目对“setting”实现，主要配置有项目路径，密钥配置，域名访问权限，App列表，配置静态资源，配置模板文件，数据配置，中间件和缓存配置。
一.基本配置信息
一个简单对项目必须具备对基本配置信息有：项目路径，密钥配置，域名访问权限，App列表和中间件。以“MyWeb”项目为例，setting.py的基本配置如下：
"""
Django settings for MyWeb project. Generated by 'django-admin startproject' using Django 2.1.4. For more information on this file, see
https://docs.djangoproject.com/en/2.1/topics/settings/ For the full list of settings and their values, see
https://docs.djangoproject.com/en/2.1/ref/settings/
""" import os '''
BASE_DIR:
指定项目路径，主要通过os模块读取当前项目在系统的具体路径，该代码在创建项目时自动生成，一般情况下无需修改。
'''
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) '''
SECRET_KEY:
指定密钥配置，是一个随机值，在项目创建的时候自动生成，一般情况下无需修改。主要用于重要的数据的加密处理，提高系统的
安全性，避免遭到攻击者恶意破坏。密钥主要用户用户密码，CSRF机制和绘画 Session等数据加密。 用户密码：
Django内置一套用户管理系统，该系统具有用户认证和存储用户信息等功能，在创建用户的时候，该用户密码通过密钥
进行加密处理，保证用户的安全性能。
CSRF机制：
该机制主要用以表单提交，防止窃取网站的用户信息来制造恶意请求。
会话Session：
Session的信息存放在Cookies，以一串随机的字符串表示，用于标识当前访问网站的用户身份，记录相关用户信息。
'''
SECRET_KEY = 'nstb+fm4-5oxi8e432bi!w^lty20@a6lb721&byi6^gw_b6)_f' '''
DEGUG:
指定调试模式，该值为布尔值。主要在开发调试阶段应设置为True，在开发调试过程中会自动检测代码是否发生更改，根据检测
结果执行是否刷新重启系统。如果项目配置部署上线，应该将其改为False，否则会泄露系统的相关信息。
'''
DEBUG = True '''
ALLOWED_HOSTS:
设置可访问的域名，默认值为空。当DEBUG为True并且ALLOWD_HOSTS为空时，项目只允许以localhost或者127.0.0.1在浏览器
*问。当DEBUG为False时，ALLOWED_HOSTS为必填项，否则程序无法启动，如果想允许所有域名访问，可设置ALLOW_HOSTS=["*"]。
'''
ALLOWED_HOSTS = [] '''
INSTALLED_APPS:
指定App列表，告诉Django有哪些App。在项目创建时已有admin，auth和session等配置信息，这些都是Django内置的应用功能。
各个功能说明如下：
admin：
内置的后台管理系统。
auth：
内置的用户认证系统。
contenttypes：
记录项目中所有model元数据（Django的ORM框架）。
sessions：
Session会话功能，用于标识当前访问网站的用户身份，记录相关用户信息。
messages：
消息提示功能。
staticfiles：
查找静态资源路径。 温馨提示：
如果在项目创建了App，必须在App列表INSTALLED_APPS添加App名称。将MyWeb项目已经创建的App添加到App列表，代码如下：
'''
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'index',
'user',
]
二.静态资源
静态资源指的是网站中不会改变的文件。在一般的应用程序中，静态资源包括CSS文件，JavaScript文件以及图片等资源文件。
此处简单介绍以下CSS和JavaScript文件：
CSS也称层叠样式表（Cascading Style Sheets），是一种用来表现HTML（标准通用标记语言的一个应用）或XML（标准通用标记语言的一个子集）等文件样式的计算机语言。CSS不仅可以静态地修饰网页，还可以配合各种脚本语言动态地对网页各元素进行格式化。 Javascript是一种直译是脚本语言，也是一种动态类型，弱类型，基于原型的语言，内置支持类型。它的解释器被成为JavaScript引擎，为浏览器的一部分，广泛用于客户端的脚本语言，最早是在HTML（标准通用标记语言下的一个应用）网页上使用的，用来给HTML网页增加动态功能。
一个项目在开发过程中肯定需要使用CSS和JavaScript文件，这些静态文件的存放主要由配置文件setting.py设置，配置信息如下：
'''
STATIC_URL:
是必须配置的属性而且不能为空。如果没有配置STATICFILES_DIRS，则STATIC_URL只能识别static静态资源文件夹。
'''
STATIC_URL = '/static/' '''
STATICFILES_DIRS:
是可选的配置属性，属性值为列表或元组格式，每个列表（元组）元素代表一个静态资源文件夹，这些文件夹可自行命名。
在浏览器*问项目的静态资源时，无论项目的静态资源文件夹是如何命名的，在浏览器上，静态资源的上级目录必须为static，
而static是STATIC_URL的默认属性值，因为STATIC_URL也是静态资源的起始URL。
除此之外，静态资源配置还有STATIC_ROOT，其作用是方便在服务器上不熟项目，实现服务器和项目之间的映射。STATIC_ROOT主
要收集整个项目的静态资源并存放在一个新的文件夹，然后由该文件夹与服务器之间的构建映射关系。STATIC_ROOT用于项目生产部署，
在项目开发过程中作用不大，关于STATIC_ROOT的配置和STATICFILES_DIRS类似。
'''
STATICFILES_DIRS = [
os.path.join(BASE_DIR, 'public_static'),
os.path.join(BASE_DIR,'index/index_static')
]
三.模版路径
在Web开发中，模板是一种较为特殊的HTML文档。这个HTML文档嵌入了一些能够让Python识别的变量和指针，然后程序解析这些变量和指令，生成的完整的HTML网页并返回给用户浏览。模板是Django里面的MTV框架模式的T部分，配置模板路径是告诉Django在解析模板时，如何查找模板所在的位置。创建项目是，Django已经初始的模板配置信息，如下所示：
'''
TEMPLATES:
模板配置是以列表格式呈现的，每个元素具有不同的含义，其含义说明如下：
BACKEND：
定义模板引擎，用于识别模板里面的变量和指令。内置的模板引擎有Django Templates和jinjia2.jinja2，每个模板引擎
都有自己的变量和指令语法。 DIRS：
设置模板所在路径，告诉Django在哪个地方查找模板的位置，默认为空列表。
模板配置通常配置DIRS路径即可。在项目的根目录和index下分别创建template文件夹。根目录的templates通常存放共用
的模板文件，能够供各个App的模板文件调用，该模式符合代码重复使用的原则。如HTML的<head>部分。index的templates是存
放当前App所需要使用的模板文件。模板的配置如下所示。 APP_DIRS：
是否在App里查找模板文件。 OPTIONS：
用于填充在RequestContext中上下文的调用函数，一般情况下不做任何修改。 '''
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [
os.path.join(BASE_DIR, 'templates'),
os.path.join(BASE_DIR,'index/index_templates')
],
'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提供4种数据库引擎：'django.db.backends.postgresql'，'django.db.backends.mysql'，'django.db.backends.sqlite3'和'django.db.backends.oracle'。创建项目是默认使用Sqlite3数据库配置信息如下：
'''
DATABASES：
指定数据库的类型，如下所示，默认是使用sqlite3。
'''
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
如果把上面的链接信息改为MySQL数据库，首先安装MySQL链接模块，由于mysqldb不支持Python3，因此Django2.0不在使用mysqldb作为MySQL的链接模块，而选择了mysqlclient模块，两者之间在使用上并没有太大的差异。在配置MySQL之前，首先安装mysqlclient模块，这里以pip安装方法为例，打开CMD窗口并输入安装指令“pip install mysqlclient”，等待模块安装完成。然后检测mysqlclient的版本信息，如果mysqlclient版本信息过低，就不符合Django的使用要求。在CMD窗口进入Python交互解释器进行版本验证，如下图所示：
Microsoft Windows [版本 6.1.7601]
版权所有 (c) 2009 Microsoft Corporation。保留所有权利。 C:\Users\yinzhengjie>pip install mysqlclient
Collecting mysqlclient
Downloading https://files.pythonhosted.org/packages/6f/d5/fee36b78367c275d7542181bd522d7204dbfb4bc2ad2c6de72a738059a92/mysqlclient-1.3.14-cp36-cp36m-win_amd64.whl (266kB)
100% |████████████████████████████████| 276kB 57kB/s
Installing collected packages: mysqlclient
Successfully installed mysqlclient-1.3.14 C:\Users\yinzhengjie>
C:\Users\yinzhengjie>pip install mysqlclient
一般情况下，使用pip安装mysqlclient模块都能符合Django的使用要求。如果在开发过程中发现Django提示mysqlclient版本过低，而且mysqlclient的版本又大于1.3.7版本，那么可以对Django的源码进行修改，在Python的安装目录下找到base文件（“C:\Users\yinzhengjie\softwares\python36\Lib\site-packages\django\db\backends\mysql\base.py”）。
完成mysqlclient模块的安装后，在项目的配置文件setting.py中配置MySQL数据库链接信息，代码如下：
'''
DATABASES
标识指定数据库的配置信息
ENGINE
指定数据库的类型，此处我们指定的是mysql。
NAME
指定数据库的名称
USER
指定数据库的用户名
PASSWORD
指定数据的密码
HOST
指定数据的主机IP地址
POST
指定数据库的端口信息 '''
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'yinzhengjie',
'USER':'root',
'PASSWORD':'yinzhengjie',
'HOST':'172.30.1.2',
'POST': '',
}
}
上述链接方式用于链接MySQL里面一个名为“yinzhengjie”的数据库，上述配置只是链接了一个“yinzhengjie”的数据库，在日常的开发中，有时候链接需要多个数据库，实现方法如下：
DATABASES = {
#第一个数据库
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
},
#第二个数据库为mysql
'yinzhengjie': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'yinzhengjie',
'USER':'root',
'PASSWORD':'yinzhengjie',
'HOST':'172.30.1.2',
'POST': '',
},
#第三个数据库
'MyDjango': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'MyDjango_db',
'USER': 'root',
'PASSWORD': 'yinzhengjie',
'HOST': '172.30.1.2',
'POST': '',
}
}
上述代码供链接了三个数据库，分别是“yinzhengjie”,"MyDjango_db"和“db.sqlite3”。“yinzhengjie”,"MyDjango_db"均属于MySQL数据库系统，“db.sqlite3”属于Sqlite3数据库系统。从DATABASES的数据类型可以发现是一个数据字典，也就是说如果需要链接多个数据库，只需要属性DATABASES中设置不同的键值对即可实现。
值得注意的是，本片博客是以MySQL的5.7版本为例进行介绍的。如果读者使用的是5.7以上的版本，在Django链接MySQL数据库时会提示“django.db.utils.OperationalError”的错误信息，这是因为MySQL8.0版本的密码加密方式发生了改变，8.0版本的用户密码采用的是cha2加密方法。为了解决这Django链接MySQL数据的错误问题。在MySQL的可视化工具中允许以下SQL语句：
ALTER USER 'root'@'172.30.1.%' IDENTIFIED WITH mysql_native_password BY 'yinzhengjie'; FLUSH PRIVILEGES;
Django除了支持PostgreSQL，Sqlite3，MySQL和Oracle之外，还支持SQLServer和MangoDB的链接。由于不同的数据库有不同的链接方式，此处不过多介绍，本篇博客以MYSQL链接为例，若需了解其他数据库的链接方式，可自行搜索相关资料。
五.中间件
中间件（Middleware）是处理Django的request和response对象的钩子，当用户在网站中进行单击某个按钮等操作时，这个动作是用户向网站发送请求（request）；而网页会根据用户的操作返回相关的网页内容，这个过程称为响应处理（response）。从请求到响应的过程中，当Django接受到用户请求时，Django首先经过中间件 处理请求信息，执行相关的处理，然后将处理结果返回给用户，中间件执行流程如下图所示：
从上图能清晰的看到，中间件的作用主要是处理用户请求信息。开发者也可以根据自己的开发需求自定义中间件，只要将自定义的中间件添加到配置属性MIDDLEWARE中即可激活。一般情况下，Django默认的中间件配置均可满足大部分的开发需求。在项目的MINDDELEWARE中添加LocalMiddleware中间件，使得Django内置的功能支持中文显示，代码如下：
'''
MIDDLEWARE
配置属性MIDDLEWARE的数据格式为列表类型，每个中间件的设置顺序是固定的，如果随意变更中间件很容易导致呈现异常。
SecurityMiddleware：
内置的安全机制，保护用户与网站的通信安全。
SessionMiddleware：
会话Session功能。
LocalMiddleware:
支持中文语言。
CommonMiddleware：
处理请求信息，规范化请求内容。
CsrfViewMiddleware：
开启CSRF防护功能。
AuthenticationMiddleware：
开启内置的用户认证系统。
MessageMiddleware：
开启内置的信息提示功能。
XFrameOptionsMiddleware：
防止恶意程序点击劫持。 '''
MIDDLEWARE = [
'django.middleware.security.SecurityMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.local.LocalMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
]