《玩转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:Usersyinzhengjie>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:Usersyinzhengjie>
一般情况下，使用pip安装mysqlclient模块都能符合Django的使用要求。如果在开发过程中发现Django提示mysqlclient版本过低，而且mysqlclient的版本又大于1.3.7版本，那么可以对Django的源码进行修改，在Python的安装目录下找到base文件（“C:Usersyinzhengjiesoftwarespython36Libsite-packagesdjangodbackendsmysqlase.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': '3306', } }
上述链接方式用于链接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': '3306', }, #第三个数据库 'MyDjango': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'MyDjango_db', 'USER': 'root', 'PASSWORD': 'yinzhengjie', 'HOST': '172.30.1.2', 'POST': '3306', } }
上述代码供链接了三个数据库，分别是“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', ]