Django项目: 项目环境搭建 ---- 二、django项目设置

1.配置模板文件

templates = [
    {
        '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',
            ],
            # 将模板标签内置到模板中 https://docs.djangoproject.com/en/2.1/topics/templates/
            'builtins': ['django.templatetags.static'],
        },
    },
]

 

2.配置mysql数据库

1. 创建数据库

   mysql> create database tzproject charset=utf8mb4;
   query ok, 1 row affected (0.00 sec)

2. 创建用户

   mysql> create user 'dj_user'@'%' identified by 'pythonvip';
   query ok, 1 row affected (0.00 sec)

3. 授权

   mysql> grant all privileges on tzproject.* to 'dj_user'@'%';
   query ok, 0 rows affected (0.03 sec)
   mysql> flush privileges;
   query ok, 0 rows affected (0.02 sec)
   # 授权创建一起写
   grant all privileges on tzproject.* to 'xinlan'@'%' identified by 'pythonvip'

4. 配置settings

   方法一：直接在settings.py文件中添加数据库配置信息

   databases = {
       'default': {
           'engine': 'django.db.backends.mysql',               # 数据库引擎
           'name': 'tzproject',                                # 数据库名
           'user': 'dj_user',                                  # 用户名
           'password': 'pythonvip',                            # 密码
           'host': '127.0.0.1',                                # 主机ip
           'port': 3306                                        # 端口
       }
   }

   方法二：将数据库配置信息存到一个文件，在settings文件中将其引入。（推荐）

   新建数据库配置文件db.cnf(名字随意)

   db.cnf文件内容：

   [client]
   database = tzproject
   user = dj_user
   password = pythonvip
   host = 127.0.0.1
   port = 3306
   default-character-set = utf8

   
   在settings.py文件中引入db.cnf

   databases = {
       'default': {
           'engine': 'django.db.backends.mysql',
           'options':{
               'read_default_file': 'utils/db/db.cnf'，
           }
       }
   }

   
   官方文档：
   

3.安装mysql数据库的python驱动

⚠️mysql数据库配置完成后，运行django服务会报如下错误，官方推荐安装mysqlclient1.3.7以上版本，也可以安装pymysql，并且需要在settings.py文件所在目录包中的__init__.py中导入pymysql。

 

1. 安装mysqlclient

# 首先更新ubuntu
sudo apt-get update 

# 然后按照依赖库
sudo apt-get install default-libmysqlclient-dev

# 再切换到虚拟环境中
workon tzproject

# 最后安装mysqlclient
pip install mysqlclient -i https://pypi.doubanio.com/simple

2.安装pymysql

# 安装pymysql
pip install pymysql -i https://pypi.doubanio.com/simple

　　在settings.py文件所在目录下的__init__.py导入

 

 

推荐使用第一种方式，mysqlclient更快更安全，官方推荐。

4.配置redis缓存

用于存放用户session信息，以及需要缓存的各种信息。

# 在虚拟机中安装django-redis
pip install django-redis    

# settings.py文件中指定redis配置

caches = {
    "default": {
        "backend": "django_redis.cache.rediscache",
        "location": "redis://127.0.0.1:6379/0",
        "options": {
            "client_class": "django_redis.client.defaultclient",
        }
    },
    'session': {
        'backend': 'django_redis.cache.rediscache',
        'location': 'redis://127.0.0.1:6379/1',
        'options': {
            'client_class': 'django_redis.client.defaultclient',
        }
    },
}

# session存储缓存设置
session_engine = 'django.contrib.sessions.backends.cache'
session_cache_alias = 'session'

文档地址：https://django-redis-chs.readthedocs.io/zh_cn/latest/

django文档：

5.配置日志器

用于记录系统运行过程中的各种日志信息。

在项目根目录中创建一个logs文件夹，用于存放日志文件

# 日志
logging = {
    # 版本
    'version': 1,
    # 是否禁用已存在的日志器
    'disable_existing_loggers': false,
    'formatters': {
        'verbose': {
            'format': '{levelname} {asctime} {module} {lineno:d} {message}',
            'style': '{',
        },
        'simple': {
            'format': '{levelname} {module} {lineno:d} {message}',
            'style': '{',
        },
    },
    'filters': {
        'require_debug_true': {
            '()': 'django.utils.log.requiredebugtrue',
        },
    },
    'handlers': {
        'console': {
            'level': 'debug',
            'filters': ['require_debug_true'],
            'class': 'logging.streamhandler',
            'formatter': 'simple'
        },
        'file': {
            'level': 'info',
            # 这个handler可以记录一组日志文件
            'class': 'logging.handlers.rotatingfilehandler',
            'filename': os.path.join(base_dir, 'logs/tz_django.log'),
            # 单个日志文件最大字节数
            'maxbytes': 300*1024*1024,
            # 日志文件个数
            'backupcount': 10,
            'formatter': 'verbose'
        },
    },
    'loggers': {
        'django': {
            'handlers': ['console', 'file'],
            'level': 'info',  # 日志器接收的最低级别
            'propagate': true,
        },
    },
}

使用方法

# 使用方法
# import the logging library
import logging

# get an instance of a logger
# 此处的django为，settings.py文件中，logging配置下的loggers中定义的日志器名称
logger = logging.getlogger('django')    

def my_view(request, arg1, arg):
    ...
    if ***:
        # log an error message
        logger.error('something went wrong!')

官方文档：

6.时区配置

# 修改语言
language_code = 'zh-hans'
# 修改时区
time_zone = 'asia/shanghai'

use_i18n = true

use_l10n = true
# 使用时区
use_tz = true

7.静态文件配置

在项目根目录创建一个static目录，用于存放静态文件(css, js, image, font等)

static_url = '/static/'
staticfiles_dirs = [
    os.path.join(base_dir, 'static')
]

8.创建应用

本项目主要由4个模块组成，分别为新闻文章模块，课程视频播放模块，文档下载模块，用户管理模块等。在项目根目录下创建一个apps目录用于存放各子应用。

 

 然后cd到apps目录创建各子应用

~$ cd ~/code/tztz/apps/
~/code/tztz/apps$ workon tzproject
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp news
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp course
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp doc
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp user

再到settings文件中，加入如下设置

import sys

# 创建应用之后，把apps目录加入到sys.path中
sys.path.insert(0, base_dir)
sys.path.insert(1, os.path.join(base_dir, 'apps'))

接着分别在apps文件夹和项目根目录文件夹上右键，加入到source root中，优化导入路径(pycharm提示)。

 

 

 最后将应用添加到installed_apps列表中

installed_apps = [
    # ...
    'user',
    'news',
    'doc',
    'course'
]