项目基础（一）

01-01 路飞学城

一. 企业的web项目类型

1. 商城
   1.1 B2C 直销商城 商家与会员直接交易 ( Business To Customer )
   1.2 B2B 批发商城 商家与商家直接交易
   1.3 B2B2C 购物平台 商家和会员在另一个商家提供的平台上面进行交易
   1.4 C2B 定制商城 会员向商家发起定制商品的需求，商家去完成。
   1.5 O2O 线上线下交易平台
   1.6 C2C 二手交易平台
2. 门户网站[企业站和门户站]
3. 社交网络
4. 资讯论坛
5. 内部系统
6. 个人博客
7. 内容收费站

二. 企业项目开发流程

三. 立项申请阶段

立项其实就是对产品项目能不能做和怎么做，提出理论基础。大的互联网公司都有比较正规的立项流程。

通常公司内部要研发一款软硬件的产品之前，都要经过市场评估和调研分析，产生一份产品项目立项报告给公司。

产品项目立项报告一般包含以下内容：

项目概述
需求市场
需求分析和项目建设的必要性
业务分析
总体建设方案
项目风险和风险管理
可行性分析阶段

参考资料：https://blog.csdn.net/m0_37370820/article/details/81077886

四. 需求分析

1. 首页

功能：导航菜单、轮播图、退出登录

2. 登录注册

功能：用户登录、极验验证码、多条件登录、记住密码、短信发送、短信冷却倒计时、jwt认证

3. 课程列表

功能：课程分类、课程列表、课程多条件筛选展示、课程分类展示、课程分页展示、课程章节课时展示、课程优惠策略

4. 课程详情

功能：课程信息展示、视频播放、富文本编辑器

5. 购物车

功能：购物车商品列表、添加商品、删除商品、勾选商品状态、商品结算、订单生成、唯一订单号生成

6. 商品结算

功能：订单商品信息列表、订单信息展示、积分计算功能、优惠券策略、课程有效期计算、第三方支付平台接口

7. 购买成功

8. 个人中心

功能列表：我的订单、订单状态改变

9. 视频播放

功能：视频加密播放

01-02 pip源

一. 介绍

1、采用国内源，加速下载模块的速度
2、常用pip源：
    -- 豆瓣：https://pypi.douban.com/simple
    -- 阿里：https://mirrors.aliyun.com/pypi/simple
3、加速安装的命令：
    -- >: pip install -i https://pypi.douban.com/simple 模块名

二. 永久配置安装源

1. Windows

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

提示: 如果你不在路径栏里面输入%APPDATA%, 而是直接到文件中找, 可能会出现找不到C:\Users\电脑用户\一下的AppData目录的情况.

很可能是该文件夹被隐藏了, 打开即可!

2. MacOS、Linux

1、在用户根目录下 ~ 下创建 .pip 隐藏文件夹，如果已经有了可以跳过
    -- mkdir ~/.pip
2、进入 .pip 隐藏文件夹并创建 pip.conf 配置文件
    -- cd ~/.pip && touch pip.conf
3、启动 Finder(访达) 按 cmd+shift+g 来的进入，输入 ~/.pip 回车进入
4、新增 pip.conf 配置文件内容

3. 配置文件内容

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

三. 拓展

1. pip离线下载安装第三方包

# pip下载第三方包
pip download 你的包名 -d "下载的路径(windows下双引号来表示文件夹)"

# 举个栗子：
pip download pymysql -d "D:\pipDownloadTest"

# pip离线安装
pip install <包名>

# 举个栗子： 切换终端在待安装文件目录下（D:\pipDownloadTest）
pip install PyMySQL-0.9.3-py2.py3-none-any.whl

2. 在pip安装失败的时候直接使用whl文件安装

提示: 其实本质上windows上安装的模块, 都是xxx.whl文件

搜索网址: https://www.lfd.uci.edu/~gohlke/pythonlibs/#twisted

指定版本和平下载: 如图

安装:

# 下载到本地以后直接使用如下命令: 
pip install 你下好的.whl文件的路径        

3. 使用pip命令自动生成requirement.txt项目依赖的模块

# 查看pip安装的包
pip list

# 注意: 先切换到到apps文件夹下, 在Terminal中执行以下命令. > 指向的是当前目录下将项目依赖的模块的文件
pip freeze >requirement.txt      

4. 使用pip命令自动下载requirements.txt项目依赖的模块

pip install -r requirements.txt -i 源

（1）阿里云:  http://mirrors.aliyun.com/pypi/simple/
（2）豆瓣:    http://pypi.douban.com/simple/
（3）清华大学:  https://pypi.tuna.tsinghua.edu.cn/simple/
（4）中国科学技术大学 http://pypi.mirrors.ustc.edu.cn/simple/
（5）华中科技大学:    http://pypi.hustunique.com/

5. pip下载设置超时时间

pip install -U https://codeload.github.com/sshwsfc/xadmin/zip/django2 --default-timeout=1000

6. 拓展: 使用pipreq下载项目依赖的模块

优点: 只会下载项目依赖的模块, 不会如pip freeze >requirements.txt命令一样将模块依赖的包全部都下载到文件中

# 下载
pip3 install pipreqs 

# windows中操作系统默认GBK编码, 需要指定编码
pipreqs ./ --encoding=utf-8

01-03 虚拟环境的搭建

一. 优点

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

二. windows

1. 安装

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

2. 配置虚拟环境管理器工作目录

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

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

三. MacOS、Linux

1. 安装

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

2. 工作文件

# 先找到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

3. 配置

# 在 ~/.bash_profile 完成配置，virtualenvwrapper的默认默认存放虚拟环境路径是 ~/.virtualenvs
# WORKON_HOME=自定义存放虚拟环境的绝对路径，需要自定义就解注
VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3
source /usr/local/bin/virtualenvwrapper.sh

# 在终端让配置生效：
    -- source ~/.bash_profile

四. 使用

# 在终端工作的命令

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

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

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

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

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

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

五. pycharm使用

1. 新建项目

六. 拓展

1. 批处理文件: bat & .sh

windows批处理文件格式: xx.bat

mac或者linux批处理文件格式: xx.sh

 # 在使用pip3 install virtualenvwrapper-win命令的时候我们发现还需要安装一个`-win`结尾
-win的结尾表示在windows中会生成.bat  批处理文件
不加表示在mac或者linux中生成.sh      批处理文件

01-04 luffy后台-Django项目创建

一. 环境

# 为luffy项目创建一个虚拟环境
>: mkvirtualenv luffy

# 按照基础环境依赖
>: pip install django==2.2.2     # 安装2.0.7以上的版本, 使用mysql数据库的时候会出现异常, 我们接下来修改源码来解决这种问题
>: pip install djangorestframework
>: pip install pymysql

二. 创建项目

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

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

三. 重构项目目录

重构前:

重构后:

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

四. 重构后的配置

1. 修改 wsgi.py 与 manage.py 两个文件
# manage.py 项目没上线时runserver走的配置 (见图一)
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'luffyapi.settings.dev')
# wsgi.py   项目上线时runserver走的配置   (见图二)
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'luffyapi.settings.prod')
# manage_prod.py
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'luffyapi.settings.prod')

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)

图一: settings.py文件修改以后在项目没上线时走manage.py的设置:

图二: 如果点击pycharm的启动按钮, 而不是输入命令启动, 出现启动问题的配置:

PYTHONUNBUFFERED=1;DJANGO_SETTINGS_MODULE=luffyapi.settings.dev

图三: settings.py文件修改以后在项目上线时走wsgi.py的设置:

五. 指定.py文件出现问题

启动如下命令出现错误:

from django.conf import settings
print(settings)

'''
django.core.exceptions.ImproperlyConfigured: Requested settings, but settings are not configured. 
You must either define the environment variable DJANGO_SETTINGS_MODULE or call settings.configure() before accessing settings.
'''

解决： 到编辑配置 -> Templdates -> Python -> Environment variables输入

PYTHONUNBUFFERED=1;DJANGO_SETTINGS_MODULE=luffyapi.settings.dev

# .py文件中执行
from django.conf import settings
print(settings)

'''
<Settings "luffyapi.settings.dev">
<Settings "luffyapi.settings.dev">
'''

01-05 luffy后台-路径配置及其他

一. 环境变量

1. 开发dev.py中路径的处理

问题: 应用的创建, dev.py中注册路径无法生效了

# 先切换到apps目录, 再执行以下命令
cd luffyapi\apps\

# 创建应用: 提示, startapp在哪执行，就把app创建在哪
python3.6 ../../manage.py startapp home
python3.6 ../../manage.py startapp user

dev.py 中配置

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


# 2. 把当前项目中与项目名同名的小的luffyapi的这个路径加入到环境变量。 目的： 提供INSTALLED_APPS中应用的注册， 在项目启动时会被项目加载。
print(sys.path)
sys.path.insert(0, BASE_DIR)   
# 3. 把apps的路径加入到环境变量。 目的： 提供在应用下导入语法 from views import aaa
sys.path.insert(1, os.path.join(BASE_DIR, 'apps'))
print(sys.path)

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 4. 现在就可以将刚刚的引用注册生效了。
    'user',
    'home'
]

2. 解决不在项目中导入的飘红的问题。

提示： 在apps中的应用下， 使用from viwes import aaa这种导入就是会飘红，但是导入没有错误，只是不在项目中的导入， 就会出现这种问题.

二. 封装logger

1. 开发人员

真实项目上线后，日志文件打印级别不能过低，因为一次日志记录就是一次文件io操作

dev.py

# 日志的配置
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': 'ERROR',
            '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,  # 是否让日志信息继续冒泡给其他的日志处理系统
        },
    }
}

2. utils / logging.py

# 如果加了名字这里就是配置文件中日志对象loggers下的名字要对应
'''
'loggers': {
        'django': {
            'handlers': ['console', 'file'],
            'propagate': True, # 是否让日志信息继续冒泡给其他的日志处理系统
        },
    }
'''

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

三. 封装项目异常处理

1. utils / exception.py

# 'EXCEPTION_HANDLER': 'rest_framework.views.exception_handler'
from rest_framework.views import exception_handler
from rest_framework import status
from .response import APIResponse
from .logging import logger


def common_exception_handler(exc, context):
    # 记录日志: context['view']  是TextView的对象，想拿出这个对象对应的类名
    logger.error('view是：{}，错误是{}'.format(context['view'].__class__.__name__, str(exc)))
    obj = None
    res = exception_handler(exc, context)
    if not res:  # drf内置处理不了，丢给django的，我们自己来处理的
        if isinstance(exc, AttributeError):
            obj = APIResponse(code=0, msg='失败', error=str(exc), result=str(context), status=status.HTTP_403_FORBIDDEN)
        elif isinstance(exc, ImportError):
            obj = APIResponse(code=0, msg='失败', error=str(exc), results=str(context), status=status.HTTP_403_FORBIDDEN)
        elif isinstance(exc, TypeError):
            obj = APIResponse(code=0, msg='失败', error=str(exc), results=str(context), status=status.HTTP_403_FORBIDDEN)
        elif isinstance(exc, Exception):
            obj = APIResponse(code=0, msg='失败', error=str(exc), results=str(context), status=status.HTTP_403_FORBIDDEN)
    else:
        obj = APIResponse(code=0, msg='失败', error=res.data.get('detail'), result=str(context),
                          status=status.HTTP_403_FORBIDDEN)
    return obj

2. dev.py

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': 'utils.exception.common_exception_handler',
}

四. 封装Response模块

utils / response.py

from rest_framework.response import Response


class APIResponse(Response):
    def __init__(self, code=1, msg="成功", result=None, status=None, headers=None, content_type=None, **kwargs):
        dic = {
            'code': code,
            'msg': msg
        }
        if result:
            dic['result'] = result
        dic.update(kwargs)
        super().__init__(data=dic, status=status, headers=headers, content_type=content_type)

01-06 luffy数据库

一. 创建数据库

# 1.管理员连接数据库
mysql -uroot -p密码

# 2.创建数据库
create database luffy default charset=utf8;

# 3.查看用户
select user,host,password from mysql.user;

# 5.7之上的的版本查看命令 （提示： 5.7之后password字段变成了authentication_string字段）
select user,host,authentication_string from mysql.user;

二. 为指定数据库配置指定账户

提示： 以下的所有操作都是基于Root用户

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

# 1.配置任意ip都可以连入数据库的账户 (提示：%表示任意的地址都可以远程链接)
grant all privileges on luffy.* to 'luffyapi'@'%' identified by 'Luffy123?';

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

# 3.刷新一下权限。 （提示： 如果不刷新，只会在下次登录时生效。）
flush privileges;

# 只能操作luffy数据库的账户
账号：luffyapi
密码：Luffy123?

三. 配置文件配置

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'luffy',
        'HOST': '127.0.0.1',
        'PORT': 3306,
        'USER': 'luffyapi',
        'PASSWORD': 'Luffy123?',
        'CHARSET': 'utf8',
    }
}

# 提示： 这里放在__init__.py或者配置文件中也可以。 本质只要是项目启动时加载文件会加载到它即可
import pymysql
pymysql.install_as_MySQLdb()

拓展：项目上线， PASSWORD密码不因该存放到prod.py配置文件中。

因此存放到服务器中， 通过环境变量的获取存放。

# 伪代码实例
password = sys.path.get('mysql_password', 'xxxx')


DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'luffy',
        'USER': 'luffy',
        'PASSWORD': password,
        'HOST': 'localhost',
        'PORT': 3306
    }
}

四. Django2.0.7版本之后使用pymysql启动项目时出现的2个问题

提示： Django采用2.0.7版本之后很可能出现以下问题，需要修改源代码

第一步： 注释抛出的异常的2行代码。

第二步： 把decode修改成encode， 再将之前的那一行注释。