django中的配置文件

摘要：默认的，及使用它的号数据库此处使用号数据库，在客户端查看记得切换数据库存储在本机内存中，比数据库的方式读写快很多默认的配置项，采用号库。状态保持的配置项，采用号库。使用名为的配置项存储数据。配置完成后运行程序，测试结果。

当进入虚拟环境，通过django_admin创建一个项目后，会在项目同名目录生成一个setting.py文件。而实际项目过程中会有不同的环境，如开发环境、生产环境；所有不同的环境各自使用不同的配置显得很重要。

开发环境：用于编写和调试项目代码。

生产环境：用于项目线上部署运行。

1.1 新建配置文件

准备配置文件目录

在项目同名目录里名新建包，命名为settings，作为配置文件目录

准备开发和生产环境配置文件

在配置包settings中，新建开发环境配置文件

准备开发环境配置内容

将默认的配置文件settings.py中内容拷贝至setting包中，并命名为dev.py

1.2 指定开发环境配置文件

在项目文件manage.py中做如下修改：

# os.environ.setdefault("DJANGO_SETTINGS_MODULE", "meiduo_mall.settings") #默认找setting.py,此处注释掉
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "meiduo_mall.settings.dev")

2.1 安装Jinja2扩展包

pip install Jinja2

Jinja2模板渲染速度比django默认模板渲染速度要快很多。

2.2 配置Jinja2模板引擎

在前面配置好的开发环境dev.py中加入如下代码，后续配置不说明也默认指在该文件中做修改。

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.jinja2.Jinja2",  # jinja2模板引擎
        "DIRS": [os.path.join(BASE_DIR, "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",
            ],
            # Jinja2模板引擎环境
            "environment": "项目名.utils.jinja2_env.jinja2_environment", # 项目名修改为你项目的名字
        },
    },
]

2.1 编写Jinja2模板引擎环境配置代码

在项目同名应用中新建一个utils包，在包里新建一个jinja2_environment.py文件，文件里内容如下：

from jinja2 import Environment
from django.contrib.staticfiles.storage import staticfiles_storage
from django.urls import reverse


def jinja2_environment(**options):
    env = Environment(**options)
    env.globals.update({
        "static": staticfiles_storage.url, # 确保模板引擎中可以使用{{ url("") }} {{ static("") }}这类语句 
        "url": reverse,
    })
    return env

此时你会发现django中的默认站点admin已经不能访问了，我们要继续使用django强大的后台站点功能做如下修改：

TEMPLATES = [
    {
        # django 默认 template 模板配置
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [os.path.join(BASE_DIR, "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",
            ],
        },
    },
    {
        "BACKEND": "django.template.backends.jinja2.Jinja2",  # jinja2模板引擎
        "DIRS": [os.path.join(BASE_DIR, "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",
            ],
            # Jinja2模板引擎环境
            "environment": "项目名.utils.jinja2_env.jinja2_environment",
        },
    },
]

3.1 本地MySQL配置

先确保你本地MySQL有所需要的数据库名，然后进行连接，下面语句进入MySQL客户端后可新建一个数据库。

create database 数据库名 charset=utf8;

默认连接MySQL都是root用户权限级别太高，拥有操作所有数据库的权限，下面介绍MySQL新建用户并赋予操作多带带一个数据库的权限。

 create user tom identified by "123456";   --新建tom用户，密码123456 
 grant all on mall.* to "tom"@"%";         --授权tom用户操作mall数据库使用权限 
 flush privileges;                         --刷新权限

3.2 配置MySQL数据库

django默认使用sqlite3数据库，这是一个轻量级关系型数据库，我们下面替换掉它，在dev.py中做如下配置：

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.mysql", # 数据库引擎
        "HOST": "127.0.0.1", # 数据库主机，填项目中数据库真实ip
        "PORT": 3306, # 数据库端口
        "USER": "tom", # 数据库用户名
        "PASSWORD": "123456", # 数据库用户密码
        "NAME": "mall" # 数据库名字
    },
}

3.3 安装PyMySQL扩展包

pip install pymysql

在工程同名子目录的__init__.py文件中，添加如下代码：

from pymysql import install_as_MySQL

db​​install_as_MySQLdb()

配置完成后：运行程序，测试结果。

首先确保安装了redis数据库，然后在虚拟环境中安装redis，同样是通过pip安装。安装完以后还有安装redis的django扩展包django-redis。

pip install redis
pip install django-redis

在dev.py中配置redis，此处用它来做session缓存。

CACHES = {
    "default": { # 默认
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/0",  # redis的ip，及使用它的0号数据库
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
    "session": { # session
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/1",  # 此处使用1号数据库，在客户端查看记得select 1,切换数据库
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
}
SESSION_ENGINE = "django.contrib.sessions.backends.cache" # 存储在本机内存中，比数据库的方式读写快很多
SESSION_CACHE_ALIAS = "session"

default：

默认的Redis配置项，采用0号Redis库。

session：

状态保持的Redis配置项，采用1号Redis库。

SESSION_ENGINE

修改session存储机制使用Redis保存。

SESSION_CACHE_ALIAS：

使用名为"session"的Redis配置项存储session数据。

配置完成后：运行程序，测试结果。

关于对session缓存策略的说明：

本地缓存

存储在本机内存中，如果丢失则不能找回，比数据库的方式读写更快。

SESSION_ENGINE="django.contrib.sessions.backends.cache"

混合存储

优先从本机内存中存取，如果没有则从数据库中存取。

SESSION_ENGINE="django.contrib.sessions.backends.cached_db"

默认存储

存储在数据库中，如下设置可以写，也可以不写。

SESSION_ENGINE="django.contrib.sessions.backends.db"

下面介绍使用logging记录项目的日志。在dev.py中做如下设置：

LOGGING = {
    "version": 1,
    "disable_existing_loggers": False,  # 是否禁用已经存在的日志器
    "formatters": {  # 日志信息显示的格式
        "verbose": {
            "format": "%(levelname)s %(asctime)s %(module)s %(lineno)d %(message)s"
        },
        "simple": {
            "format": "%(levelname)s %(module)s %(lineno)d %(message)s"
        },
    },
    "filters": {  # 对日志进行过滤
        "require_debug_true": {  # django在debug模式下才输出日志
            "()": "django.utils.log.RequireDebugTrue",
        },
    },
    "handlers": {  # 日志处理方法
        "console": {  # 向终端中输出日志
            "level": "INFO",
            "filters": ["require_debug_true"],
            "class": "logging.StreamHandler",
            "formatter": "simple"
        },
        "file": {  # 向文件中输出日志
            "level": "INFO",
            "class": "logging.handlers.RotatingFileHandler",
            "filename": os.path.join(os.path.dirname(BASE_DIR), "logs/mall.log"),  # 日志文件的位置
            "maxBytes": 300 * 1024 * 1024,
            "backupCount": 10,
            "formatter": "verbose"
        },
    },
    "loggers": {  # 日志器
        "django": {  # 定义了一个名为django的日志器
            "handlers": ["console", "file"],  # 可以同时向终端与文件中输出日志
            "propagate": True,  # 是否继续传递日志信息
            "level": "INFO",  # 日志器接收的最低日志级别
        },
    }
}

然后在项目目录中建立一个logs的目录，然后在目录中建立一个mall.log文件。名字可以任意起，记得很上面file中filename对应起来即可。

当然实际开发中大都是使用git来管理项目的，每个人调试产出的log不太一样，开发中可以先将其加入忽略文件中。在项目文件.gitignioe中新增如下信息：

*.log

然后在logs目录中建立一个.gitkeep文件，保证logs目录能被git管理。

前面提了一下项目中的html模板文件是配置在templates中,需要在项目同名子应用中建立一个templates目录，项目中需要使用静态文件，比如 css、images、js 等等，需要专门使用配置一个目录。在里面建立不同的目录来存放不同的文件。

STATIC_URL = "/static/" # 静态文件的路由​# 配置静态文件加载路径
STATICFILES_DIRS = [os.path.join(BASE_DIR, "static")] # 在项目同名子引用中建立一个static目录

STATICFILES_DIRS是一个列表，这样我们就可以配置多个目录来存放静态文件。如：

# 配置静态文件加载路径
STATICFILES_DIRS = [os.path.join(BASE_DIR, "static"),os.path.join(BASE_DIR, "static2")] 

在项目同名目录中，也就是setting包同级目录中新建一个apps的包，然后进入到apps的目录中，在终端执行如下命令，创建一个users应用。

python ../../manage.py startapp users

然后在dev.py中注册应用：

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    # 注册
     "mall.apps.users.apps.UsersConfig", # 用户模块应用
]

下面介绍一下python中sys模块，在dev.py的BASE_DIR下新增：

import sys

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, os.path.join(BASE_DIR, "apps")) # 追加项目路径

这样注册应用就能简化成如下方式了：

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    # 注册
    # "mall.apps.users.apps.UsersConfig", # 用户模块应用
    "users", # 用户模块应用
]