Django项目的项目准备

Django项目准备

1.创建工程

1.在git平台创建远程仓库

• 创建公有仓库
• 不添加开源许可证
• 不使用readme文件初始化项目

2.克隆远程仓库到本地

git clone https://gitee.com/linzi1994/Django_mall.git

3.添加前端文件

将前端文件目录front_end_pc 添加到Django_mall目录下

4.前端文件开发预览

可以使用前端node.js 提供的服务器live-server作为前端开发服务器使用。

安装node.js的版本控制工具nvm，在终端中执行

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

重新进入终端，使用nvm安装最新版本的node.js

nvm install node

安装live-server

npm install -g live-server

使用

# 在静态文件目录front_end_pc下执行
live-server

live-server运行在8080端口下，可以通过127.0.0.1:8080来访问静态页面。

5.创建虚拟环境

mkvirtualenv django_py3_1.11 -p python3

6.进入虚拟环境，创建Django项目

django-admin startproject meiduo_mall

7.工程目录调整

• 在项目同名目录下，创建apps包，存放项目的应用
• 在项目同名目录下，创建settings包，存放项目的配置文件的目录
  
  • 开发环境配置文件dev.py和线上环境配置文件prod.py
• 在项目同名目录下，创建utils包，存放项目自己定义的公共函数或类等
• 在项目同名目录下，创建libs包，存放第三方的库文件

8.修改manage.py

修改manage.py，使用settings中的dev配置

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "meiduo_mall.settings.dev")

9.创建数据库

reate database meiduo_mall default charset=utf8;

为本项目创建数据库用户（不再使用root账户）

create user meiduo identified by 'meiduo'; 
grant all on meiduo_mall.* to 'meiduo'@'%'; 
flush privileges;

说明：

• 第一句：创建用户账号 meiduo, 密码 meiduo (由identified by 指明)
• 第二句：授权meiduo_mall数据库下的所有表（meiduo_mall.*）的所有权限（all）给用户meiduo在以任何ip访问数据库的时候（’meiduo’@’%’）
• 第三句：刷新生效用户权限

2.项目配置

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

工程目录调整以后，将配置文件改为放在settings子目录下，所以 配置文件中的BASE_DIR指向的变为了DJango_mall/meiduo_mall/meiduo_mall

使用sys.path添加<BASE_DIR>/apps目录，即可添加apps应用的导包路径。

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 添加导包路径
import sys
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))

设置apps为pycharm认可的导包路径，避免pycharm内语法警告

apps-右键-Mark Directory as-Sources Root

11.注册rest_framework应用

INSTALLED_APPS = [
    ...
    'rest_framework',
]

在pycharm中设置当前项目为Django项目，使得注册app时有智能提示

编辑环境变量，点击+ ，新增Django server

在pycharm的 File | Settings | Languages & Frameworks | Django 启用Django支持

12.配置数据库

在settings/dev.py 添加数据库配置

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

在Django_mall/meiduo_mall/meiduo_mall/__init__.py注册数据库驱动

from pymysql import install_as_MySQLdb
install_as_MySQLdb()

13.配置Redis

CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://10.211.55.5:6379/0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
    "session": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://10.211.55.5:6379/1",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    }
}
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
SESSION_CACHE_ALIAS = "session"

• 除了名为default的redis配置外，还补充了名为session的redis配置，分别使用两个不同的redis库。
• 同时修改了Django的Session机制使用redis保存，且使用名为’session’的redis配置。
• 此处修改Django的Session机制存储主要是为了给Admin站点使用。

14.本地化语言与时区

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

15.配置日志

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/meiduo.log"),  # 日志文件的位置
            'maxBytes': 300 * 1024 * 1024,
            'backupCount': 10,
            'formatter': 'verbose'
        },
    },
    'loggers': {  # 日志器
        'django': {  # 定义了一个名为django的日志器
            'handlers': ['console', 'file'],  # 可以同时向终端与文件中输出日志
            'propagate': True,  # 是否继续传递日志信息
            'level': 'INFO',  # 日志器接收的最低日志级别
        },
    }
}

16.自定义异常处理

修改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',
}