Django项目的项目准备

灰太狼 2022-05-12 08:48 216阅读 0赞

# 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

![安装node][node]

安装live-server

npm install -g live-server

![安装live-server][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

![设置默认导包路径][70]

#### 11.注册rest\_framework应用 ####

INSTALLED_APPS = [
        ...
        'rest_framework',
    ]

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

编辑环境变量，点击+ ，新增Django server  
![选择Django server][Django server]

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

![启动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',
    }

[node]: /images/20220512/0966bfa942834e9eb10bb3e59f20ff8b.png
[live-server]: /images/20220512/950c367646d147fbbc9d56eeb1eab7a7.png
[70]: /images/20220512/5ce8b1bc69d44492bcb4fcc0bec1c421.png
[Django server]: /images/20220512/31a4cb688efc48b9876a044bceabfa40.png
[Django]: /images/20220512/a11e68fc10164ad9991b98771684e9fd.png