Python-Django:项目settings详细配置

1. 修改settings/dev.py 文件中的路径信息 

import os


# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
# E:\meiduo\meiduo_all\meiduo_all
import datetime


BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# print(BASE_DIR)
# 追加导包路径：执行E:\meiduo\meiduo_all\meiduo_all\apps
import sys


# sys.path = ['导包的路径1', '导包的路径1', '导包的路径1', '导包的路径1']
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))

2. INSTALLED_APPS

INSTALLED_APPS = [
# 安装后台
    'django.contrib.admin',
    # 安装用户的登录认证，认证框架的核心和默认的类型
    'django.contrib.auth',
    # 内容类型系统，它允许权限和你创建的模型类关联
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',


    # 安装rest_framework---DRF
    'rest_framework',
    # 安装跨域请求 cors
    'corsheaders',
    # 富文本编辑器
    'ckeditor',
    # 富文本编辑器上传图片模块
    'ckeditor_uploader',
    # 安装定时任务
    'django_crontab',


    # 注册用户模块应用
    'users.apps.UsersConfig',
    # 安装验证码应用
    'verifications.apps.VerificationsConfig',
    # 安装省市县三级李娜动应用
    'areas.apps.AreasConfig',
    # 安装第三方登录应用
    'oauth.apps.OauthConfig',
    # 安装广告应用
    'contents.apps.ContentsConfig',
    # 安装商品应用
    'goods.apps.GoodsConfig',

]

3. 数据库

        DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'HOST': '127.0.0.1',  # 数据库主机
        'PORT': 3306,  # 数据库端口
        'USER': 'meiduo',  # 数据库用户名
        'PASSWORD': 'meiduo',  # 数据库用户密码
        'NAME': 'meiduo_mall'  # 数据库名字
    }

}

注意：记得在meiduo/meiduo_mall/__init__.py文件中添加
import pymysql
pymysql.install_as_MySQLdb()

4. Redis

    # 配置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",
        }
    },
    "verify_codes": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/2",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
}
# 找到CACHES执行
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
# 找到session执行
SESSION_CACHE_ALIAS = "session"

5. 本地化语言与时区

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

6. 日志

# 日志的配置
# 等级由高到底：
# OFF:关闭所有日志记录
# FATAL:致命的错误，会导致程序的崩溃
# ERROR:有错，但是不影响程序的正常运行
# INFO:突出运行的过程
# DEGUG:调试
# TRACE:也是调试，但是比DEGUB更加细致
# ALL:记录所有
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.utils.log.RequireDebugTrue',
        },
    },
    'handlers': {
        'console': {
            'level': 'DEBUG',
            '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/meiduo.log"),  # 日志文件的位置
            'maxBytes': 300 * 1024 * 1024,
            'backupCount': 10,
            'formatter': 'verbose'
        },
    },
    'loggers': {
        'django': {  # 定义了一个名为django的日志器
            'handlers': ['console', 'file'],
            'propagate': True,
            'lever': 'DEBUG',   # 指定最低日志等级， 不然console不会记录，还有会默认info中的INFO等级
        },
    }

}

7. 异常处理

修改Django REST framework的默认异常处理方法，补充处理数据库异常和Redis异常。
新建utils/exceptions.py
from rest_framework.views import exception_handler as drf_exception_handler
import logging
from django.db import DatabaseError
from redis.exceptions import RedisError
from rest_framework.response import Response
from rest_framework import status
# 获取在配置文件中定义的logger，用来记录日志
logger = logging.getLogger('django')
def exception_handler(exc, context):
    """
    自定义异常处理
    :param exc: 异常
    :param context: 抛出异常的上下文
    :return: Response响应对象
    """
    # 调用drf框架原生的异常处理方法
    response = drf_exception_handler(exc, context)
    if response is None:
        view = context['view']
        if isinstance(exc, DatabaseError) or isinstance(exc, RedisError):
            # 数据库异常
            logger.error('[%s] %s' % (view, exc))
            response = Response({'message': '服务器内部错误'}, status=status.HTTP_507_INSUFFICIENT_STORAGE)
    return response
配置文件中添加
REST_FRAMEWORK = {
    # 异常处理
    'EXCEPTION_HANDLER': 'meiduo_mall.utils.exceptions.exception_handler',

}

8- 配置DRF
REST_FRAMEWORK = {
    # 异常处理
    'EXCEPTION_HANDLER': 'meiduo_all.utils.exceptions.exception_handler',
    # 配置JWT作为验证的后端
    'DEFAULT_AUTHENTICATION_CLASSES': (
            # 主要进行加密处理--最外面--优先JWT
            'rest_framework_jwt.authentication.JSONWebTokenAuthentication',
            'rest_framework.authentication.SessionAuthentication',
            'rest_framework.authentication.BasicAuthentication',
    ),


}


9-DRF扩展
REST_FRAMEWORK_EXTENSIONS = {
    # 缓存时间
    'DEFAULT_CACHE_RESPONSE_TIMEOUT': 60 * 60,
    # 缓存存储
    'DEFAULT_USE_CACHE': 'default',
}

10-告诉django用户认证系统, 用户模型类是users下的User模型类


AUTH_USER_MODEL = 'users.User'


11- CORS
CORS_ORIGIN_WHITELIST = (
    '127.0.0.1:8080',
    'localhost:8080',
    'www.meiduo.site:8080',
    'api.meiduo.site:8080'

)

12- 允许携带cookie
CORS_ALLOW_CREDENTIALS = True


13-指明token的有效期--追加响应字段
JWT_AUTH = {
    # 指明token的有效期
    'JWT_EXPIRATION_DELTA': datetime.timedelta(days=1),
    # 追加响应字段
    'JWT_RESPONSE_PAYLOAD_HANDLER': 'users.utils.jwt_response_payload_handler',
}

14-在配置文件中告知Django使用我们自定义的认证后端
AUTHENTICATION_BACKENDS = [
    'users.utils.UsernameMobileAuthBackend',
]


15-QQ登录参数
QQ_CLIENT_ID = '101474184'
QQ_CLIENT_SECRET = 'c6ce949e04e12ecc909ae6a8b09b637c'
QQ_REDIRECT_URI = 'http://www.meiduo.site:8080/oauth_callback.html'
QQ_STATE = '/'


16-配置邮箱信息
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.163.com'
EMAIL_PORT = 25
# 发送邮件的邮箱
EMAIL_HOST_USER = '[email protected]'
# 在邮箱中设置的客户端授权密码
EMAIL_HOST_PASSWORD = 'lihao19930829'
# 收件人看到的发件人
EMAIL_FROM = 'ssxrh<[email protected]>'

17-django文件存储
DEFAULT_FILE_STORAGE = 'meiduo_all.utils.fastdfs.fdfs_storage.FastDFSStorage'


18- FastDFS
FDFS_BASE_URL = 'http://192.168.219.128:8888/'
FDFS_CLIENT_CONF = os.path.join(BASE_DIR, 'utils/fastdfs/client.conf')


19-富文本编辑器ckeditor配置
CKEDITOR_CONFIGS = {
    'default': {
        'toolbar': 'full',  # 工具条功能
        'height': 300,  # 编辑器高度
        # 'width': 300,  # 编辑器宽
    },
}
20- 上传图片保存路径，使用了FastDFS，所以此处设为''
CKEDITOR_UPLOAD_PATH = ''


21-生成的静态主页html文件保存目录
GENERATED_STATIC_HTML_FILES_DIR = os.path.join(os.path.dirname(os.path.dirname(BASE_DIR)), 'front_end_pc')


22-定时任务
CRONJOBS = [
    # 每5分钟执行一次生成主页静态文件
    ('*/5 * * * *', 'contents.crons.generate_static_index_html', '>> /home/python/meiduo/meiduo_all/logs/crontab.log')
]

23- 解决crontab中文问题

一旦出现页面加载为空，那么检查中文解析：{

                1-CRONTAB_COMMAND_PREFIX = 'LANG_ALL=zh_cn.UTF-8'

                2-你创建的应用contents中crons.py文件（该应用是定时任务的任务）中的

                        with open(file_path, 'w'，encoding='utf-8') as f: 

                                    f.write(html_text)

}

CRONTAB_COMMAND_PREFIX = 'LANG_ALL=zh_cn.UTF-8'