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, # 用户模块应用
]