luffy项目：基于vue与drf先后台分离项目（1）

"""
一、业务逻辑：登陆注册 - 主页（基础信息展现） - 课程页（复杂信息展现）- 课程订单生产与支付 - 上线订单生成
二、实际项目开发的技术点：
    git版本控制
    第三方短信认证
    接口缓存 - redis数据库
    celery异步任务，接口缓存异步同步数据
    支付宝支付
    真实服务器项目上线
    
三、前台：页面现成的、先后台的数据交互代码、element-ui、jq、bootstrap、原生
"""

pip安装源

"""
一、采用国内源，加速下载模块的速度
二、经常使用pip源：
    -- 豆瓣：https://pypi.douban.com/simple
    -- 阿里：https://mirrors.aliyun.com/pypi/simple
　　 _清华源：https://pypi.tuna.tsinghua.edu.cn/simple/
三、加速安装的命令：
    -- >: pip install -i https://pypi.douban.com/simple 模块名
"""

 

永久配置安装源

　　全局配置，不仅是在pycharm里换，这样之后在终端也会执行换源后的镜像来加载。

Windows

"""
一、文件管理器文件路径地址栏敲：%APPDATA% 回车，快速进入 C:\Users\电脑用户\AppData\Roaming 文件夹中
二、新建 pip 文件夹并在文件夹中新建 pip.ini 配置文件
三、新增 pip.ini 配置文件内容
"""

 

MacOs、Linux

"""
一、在用户根目录下 ~ 下建立 .pip 隐藏文件夹，若是已经有了能够跳过
    -- mkdir ~/.pip
二、进入 .pip 隐藏文件夹并建立 pip.conf 配置文件
    -- cd ~/.pip && touch pip.conf
三、启动 Finder(访达) 按 cmd+shift+g 来的进入，输入 ~/.pip 回车进入
四、新增 pip.conf 配置文件内容
"""

 

配置文件内容

　　复制到新建的pip.ini 配置文件 便可。

"""
[global]
index-url = http://pypi.douban.com/simple
[install]
use-mirrors =true
mirrors =http://pypi.douban.com/simple/
trusted-host =pypi.douban.com
"""

 

虚拟环境的搭建

为何要使用虚拟环境？　　

优势

1、使不一样应用开发环境相互独立
2、环境升级不影响其余应用，也不会影响全局的python环境
三、防止出现包管理混乱及包版本冲突

 

windows

安装

# 建议使用pip3安装到python3环境下
pip3 install virtualenv
pip3 install virtualenvwrapper-win

配置虚拟环境管理器工具目录

　　添加到环境变量

# 配置环境变量：
# 控制面板 => 系统和安全 => 系统 => 高级系统设置 => 环境变量 => 系统变量 => 点击新建 => 填入变量名与值
变量名：WORKON_HOME  变量值：自定义存放虚拟环境的绝对路径
eg: WORKON_HOME: D:\Virtualenvs  

# 同步配置信息：
# 去向Python3的安装目录 => Scripts文件夹 => virtualenvwrapper.bat => 双击 加载

 

MacOS、Linux

安装

# 建议使用pip3安装到python3环境下
pip3 install -i https://pypi.douban.com/simple virtualenv
pip3 install -i https://pypi.douban.com/simple virtualenvwrapper

工做文件

# 先找到virtualenvwrapper的工做文件 virtualenvwrapper.sh，该文件能够刷新自定义配置，但须要找到它
# MacOS可能存在的位置 /Library/Frameworks/Python.framework/Versions/版本号文件夹/bin
# Linux可能所在的位置 /usr/local/bin  |  ~/.local/bin  |  /usr/bin
# 建议无论virtualenvwrapper.sh在哪一个目录，保证在 /usr/local/bin 目录下有一份
# 若是不在 /usr/local/bin 目录，如在 ~/.local/bin 目录，则复制一份到 /usr/local/bin 目录
    -- sudo cp -rf ~/.local/bin/virtualenvwrapper.sh /usr/local/bin

使用

# 在终端工做的命令

# 一、建立虚拟环境到配置的WORKON_HOME路径下
# 选取默认Python环境建立虚拟环境：
    -- mkvirtualenv 虚拟环境名称
# 基于某Python环境建立虚拟环境：
    -- mkvirtualenv -p python2.7 虚拟环境名称
    -- mkvirtualenv -p python3.6 虚拟环境名称

# 二、查看已有的虚拟环境
    -- workon

# 三、使用某个虚拟环境
    -- workon 虚拟环境名称
    
# 四、进入|退出 该虚拟环境的Python环境
    -- python | exit()

# 五、为虚拟环境安装模块
    -- pip或pip3 install 模块名

# 六、退出当前虚拟环境
    -- deactivate

# 七、删除虚拟环境(删除当前虚拟环境要先退出)
    -- rmvirtualenv 虚拟环境名称

 

查看安装模块名

使用虚拟环境安装django

查看虚拟环境下安装的全部模块

 

pycharm使用

　　添加在终端手动建立的虚拟环境变量

 

 以虚拟环境建立django项目

 后台：Django项目的建立

　　环境建立

"""
为luffy项目建立一个虚拟环境
>: mkvirtualenv luffy
"""

"""
按照基础环境依赖
>: pip install django==2.0.7
>: pip install djangorestframework
>: pip install pymysql
"""

 

在cmd终端执行命令，建立名为luffy的虚拟环境

在此虚拟环境之下安装一些项目依赖的模块

在次虚拟环境下建立django项目：luffyapi

 建立项目

"""
前提：在目标目录新建luffy文件夹
>: cd 创建的luffy文件夹
>: django-admin startproject luffyapi

开发：用pycharm打开项目，并选择提早备好的虚拟环境 """

 

建立好项目后用pycharm打开luffyapi项目

 

 修改项目结构，利于开发环境的使用

 

 重构项目目录

"""
├── luffyapi
    ├── logs/                # 项目运行时/开发时日志目录 - 文件夹
    ├── manage.py            # 脚本文件
    ├── luffyapi/              # 项目主应用，开发时的代码保存 - 包
         ├── apps/              # 开发者的代码保存目录，以模块[子应用]为目录保存 - 包
        ├── libs/              # 第三方类库的保存目录[第三方组件、模块] - 包
        ├── settings/          # 配置目录 - 包
            ├── dev.py       # 项目开发时的本地配置
            └── prod.py      # 项目上线时的运行配置
        ├── urls.py            # 总路由
        └── utils/             # 多个模块[子应用]的公共函数类库[本身开发的组件]
    └── scripts/               # 保存项目运营时的脚本文件 - 文件夹
"""

 

配置开发环境

"""
1.修改 wsgi.py 与 manage.py 两个文件：
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'luffyapi.settings.dev')

2.将settings.py删除或更名，内容拷贝到settings/dev.py中

3.修改dev.py文件内容
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
USE_TZ = False

4.修改启动配置：见插图

5.在任何一个__init__.py文件中测试默认配置文件是不是dev.py文件
from django.conf import settings
print(settings)
"""

 

启动Django环境的配置改成setings.dev

注意事项：

　　新建settings文件下，新建的的dev和prod文件的配置，开发前和上线后的修改，在相应的wsig.py和manage.py修改。

manage.py

 

 wsig.py

 

国际化配置

 

配置loggin日志

# 官网：https://docs.djangoproject.com
# 中文loggin配置：https://docs.djangoproject.com/zh-hans/2.2/topics/logging/
# 在项目的 dev.py 中配置 Django 项目的log日志，那Django本身出现的打印记录不只能够输出到控制台，还能够记录到日志文件，当项目上线记录日志时及其重要的

 

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': {
            # 实际开发建议使用WARNING
            'level': 'INFO',
            'class': 'logging.handlers.RotatingFileHandler',
            # 日志位置,日志文件名,日志保存目录必须手动建立，注：这里的文件路径要注意BASE_DIR表明的是小luffyapi
            'filename': os.path.join(os.path.dirname(BASE_DIR), "logs", "luffy.log"),
            # 日志文件的最大值,这里咱们设置300M
            'maxBytes': 300 * 1024 * 1024,
            # 日志文件的数量,设置最大日志数量为10
            'backupCount': 10,
            # 日志格式:详细格式
            'formatter': 'verbose',
            # 文件内容编码
            'encoding': 'utf-8'
        },
    },
    # 日志对象
    'loggers': {
        'django': {
            'handlers': ['console', 'file'],
            'propagate': True, # 是否让日志信息继续冒泡给其余的日志处理系统
        },
    }
}

 

官网翻译中文

 

 loggin日志配置的注意点

 

 日志的提示的等级

 luffy后台配置

　　环境变量

dev.py

# 环境变量操做：小luffyapiBASE_DIR与apps文件夹都要添加到环境变量


import sys
sys.path.insert(0, BASE_DIR)
APPS_DIR = os.path.join(BASE_DIR, 'apps')
sys.path.insert(1, APPS_DIR)

 

在写项目直接直接导入utils文件夹下面也不会“错误提示”的解决办法

 

 解决报错的操做：告诉djang当前加载的模块在环境变量中。

 

 封装logger

dev.py:修改logging日志的参数配置

# 真实项目上线后，日志文件打印级别不能太低，由于一第二天志记录就是一次文件io操做
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': {
            # 实际开发建议使用WARNING
            'level': 'DEBUG', 'filters': ['require_debug_true'],
            'class': 'logging.StreamHandler',
            'formatter': 'simple'
        },
        'file': {
            # 实际开发建议使用ERROR
            'level': 'INFO', 'class': 'logging.handlers.RotatingFileHandler',
            # 日志位置,日志文件名,日志保存目录必须手动建立，注：这里的文件路径要注意BASE_DIR表明的是小luffyapi
            'filename': os.path.join(os.path.dirname(BASE_DIR), "logs", "luffy.log"),
            # 日志文件的最大值,这里咱们设置300M
            'maxBytes': 300 * 1024 * 1024,
            # 日志文件的数量,设置最大日志数量为10
            'backupCount': 10,
            # 日志格式:详细格式
            'formatter': 'verbose',
            # 文件内容编码
            'encoding': 'utf-8'
        },
    },
    # 日志对象
    'loggers': {
        'django': {
            'handlers': ['console', 'file'], 'propagate': True, # 是否让日志信息继续冒泡给其余的日志处理系统
        },
    }
}

 

utils/logging.py

　　新建的logging管理日志下

import logging
logger = logging.getLogger('django')

 

封装项目异常处理

　　utils/exception.py

from rest_framework.views import exception_handler as drf_exception_handler
from rest_framework.views import Response
from rest_framework import status
from utils.logging import logger
def exception_handler(exc, context):
    response = drf_exception_handler(exc, context)
    if response is None:
        logger.error('%s - %s - %s' % (context['view'], context['request'].method, exc))  # 主要修改这句话
        return Response({
            'detail': '服务器错误'
        }, status=status.HTTP_500_INTERNAL_SERVER_ERROR, exception=True)
    return response

 

二次封装Response模块  相应模块配置等统一放到utils公共的文件内

from rest_framework.response import Response

class APIResponse(Response):
    def __init__(self, data_status=0, data_msg='ok', results=None, http_status=None, headers=None, exception=False, **kwargs):
        data = {
            'status': data_status,
            'msg': data_msg,
        }
        if results is not None:
            data['results'] = results
        data.update(kwargs)

        super().__init__(data=data, status=http_status, headers=headers, exception=exception)

 数据库的配置

在cmd终端以管理员的身份建立专属的数据库，惟一的密码操做单一的数据库。

"""
1.管理员链接数据库
>: mysql -uroot -proot

2.建立数据库
>: create database luffy default charset=utf8;

3.查看用户
>: select user,host,password from mysql.user;
"""

 

为指定数据库配置指定帐户

"""
设置权限帐号密码
# 受权帐号命令：grant 权限(create, update) on 库.表 to '帐号'@'host' identified by '密码'

1.配置任意ip均可以连入数据库的帐户
>: grant all privileges on luffy.* to 'luffy'@'%' identified by 'Luffy123?';

2.因为数据库版本的问题，可能本地还链接不上，就给本地用户单独配置
>: grant all privileges on luffy.* to 'luffy'@'localhost' identified by 'Luffy123?';

3.刷新一下权限
>: flush privileges;

只能操做luffy数据库的帐户
帐号：luffy
密码：Luffy123?
"""

 

设置权限管理数据库

 

 退出管理员，用帐号 luffy 密码 luffy 登入开发

>: exit
>: mysql -uluffy -pluffy

后台项目数据库的配置

#.luffyapi/settings/dev.py配置

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.mysql",
        "HOST": "127.0.0.1",
        "PORT": 3306,
        "USER": "luffy",
        "PASSWORD": "luffy123？",
        "NAME": "luffy",
    }
}

 

luffypai/任意__init__.py

import pymysql
pymysql.install_as_MySQLdb()

 

settings.py/dev.py

 

 

 Django2.x一些版本pymysql兼容问题：以下两张截图。

Django不采用2.0.7版本极可能出现如下问题，须要修改源代码