Django笔记三十九之settings配置介绍

本文首发于公众号:Hunter后端

原文链接:Django笔记三十九之settings配置介绍

这一篇笔记介绍 Django 里 settings.py 里一些常用的配置项,这些配置有一些是在之前的笔记中有过介绍的,比如 logging 的日志配置,session 的会话配置等,这里就只做一下简单的回顾,有一些是之前没有介绍过的就着重介绍一下。

以下是本篇笔记目录:

  1. 邮箱配置
  2. 允许访问地址配置
  3. 数据库配置
  4. 调试模式配置
  5. 注册应用程序配置
  6. 时区时间配置
  7. 会话配置
  8. 其他配置

1、邮箱配置

在前一篇笔记发送邮件的介绍中,有过详细的介绍,比如 EMAIL_BACKEND,EMAIL_HOST 等,这里额外再介绍一个参数 ADMINS

这个参数其实在第三十篇笔记 log 日志记录中有过介绍,当我们设置的日志发送邮件模块有指定等级的日志发生时,会将邮件发送至 ADMINS 中定义的收件人列表。

这个参数是一个列表,每个元素也是一个元组或列表,第一个参数为收件人的名称,第二个为收件人邮箱:

ADMINS = [
    ("Hunter", "120460xxx@qq.com"),
]

2、允许访问地址配置

我们的系统是可以设置允许访问的地址的,可以设置域名或者 IP,比如:

ALLOWED_HOSTS = ["192.168.1.9"]

这个参数的默认值为空列表,则说明只允许该系统所在的服务器地址的其他服务可以访问到 Django 服务。

如果想设置所有地址都可以访问到我们的服务,可以如此设置:

ALLOWED_HOSTS = ["*"]

3、数据库配置

前面连接数据库的时候,没有做过多的介绍,都是直接使用,这里再做一下详细的介绍,以下是一个示例:

DATABASES = {
    'default': {
        'ENGINE': "django.db.backends.mysql",
        "HOST": "192.168.1.31",
        'NAME': "func_test",
        "USER": "root",
        "PASSWORD": "123456",
        "PORT": 3306,
        "OPTIONS": {},
        "TEST": {},
    },
}

在 DATABASES 中,必须设置一个 default 数据库,也可以在里面添加其他数据库连接,比如之前的多数据库连接操作的笔记示例

其中,ENGINE 表示连接的数据库类型,这里我们设置的是 MySQL,也可以设置成 postgresql,oracle,sqlite3。

这里我们连接使用的都是 MySQL,所以下面的配置项都是基于 MySQL 做的介绍。

HOST 表示连接数据库的主机

NAME 表示要使用的数据库名称,比如我们这里 MySQL 的 func_test。如果使用的是 SQLite,那么这个地址应该是一个完整路径,下面是一个使用 SQLite 作为数据库的示例:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': '/Users/hunter/…/sqlite3.db'
    }
}

USER 表示的是连接 MySQL 用到的用户名

PASSWORD 则是密码

PORT MySQL 一般是 3306,如果是映射的其他端口改成其他端口即可

CONN_MAX_AGE

还有一个参数为 CONN_MAX_AGE,表示一个数据库连接的寿命,以秒为整数,默认为 0,表示每次数据库请求结束之后即关闭数据库连接。

如果设置为 60,那么数据库连接在开启之后 60s 即关闭此连接,在此期间,其他请求可以复用此连接。

如果设置为 None,则表示一直处于连接状态。

OPTIONS

是用于添加连接数据库时额外的参数,比如我们的 MySQL 的连接配置不直接在 DATABASES 中定义,而是通过配置文件的方式使用,如下官方文档的一个使用示例:

# settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'OPTIONS': {
            'read_default_file': '/path/to/my.cnf',
        },
    }
}


# my.cnf
[client]
database = NAME
user = USER
password = PASSWORD
default-character-set = utf8

这里的意思是,DATABASES 里的 default 数据库连接使用的都是 my.cnf 里的配置选项

如果同时我们在 DATABASES["default"] 中也配置了 NAME,USER,PASSWORD 等参数,连接应该以哪个为准呢?

是以 OPTIONS 里的参数为准,这里默认的读取配置顺序是 OPTIONS > NAME, USER, PASSWORD, HOST, PORT

我们还可以在 OPTIONS 里设置数据库的隔离等级:

* 'read uncommitted' 读未提交
* 'read committed' 读已提交
* 'repeatable read' 可重复读
* 'serializable' 串行化

TEST

TEST 参数默认也是一个空 dict,之前在单元测试那篇笔记中有过介绍,可以设置测试数据库的字符集编码,指定测试数据库名称等信息,示例如下:

DATABASES = {
    'default': {
        ...
        "TEST": {
            "CHARSET": "utf8",
            "NAME": "test_default_db",
        },
    }
}

4、调试模式配置

我们通过 settings 中的 DEBUG 参数来控制 Django 系统是否处于调试模式,DEBUG=True 则表示系统处于调试模式。

注意:永远不要在 DEBUG=True 的情况下将网站部署到生产环境

调试模式的主要功能之一就是显示详细的错误页面,比如在 DEBUG=True 的情况下,如果我们的接口发生异常,Django会显示一个详细的回溯,比如下面的信息:

热门相关:帝少的专属:小甜心,太缠人   战神   惊世毒妃:轻狂大小姐   最强装逼打脸系统   学霸女神超给力