一、创建虚拟环境

作用：虚拟环境用来安装Django项目的依赖包，能够与其他不想干的环境中的版本做好隔离。
注意：创建虚拟环境时需要联网

# 创建基于python3的Django环境
mkvirtualenv py3_Django -p python3

# 虚拟环境相关命令
mkvirtualenv  # 创建虚拟环境
rmvirtualenv  # 删除虚拟环境
workon  # 进入虚拟环境、查看所有虚拟环境
deactivate  # 退出虚拟环境

# pip相关命令
pip install  # 安装依赖包
pip uninstall  # 卸载依赖包
pip list  # 查看已安装的依赖包
pip freeze  # 冻结当前环境的依赖包

二、安装Django

版本：使用Django1.11.11
注意：需要联网

# 先进入虚拟环境
workon py3_Django   
# 安装相应的版本
pip install django==1.11.11

三、工程搭建

1、创建工程

创建空工程时，直接cd到相应的项目demo1，执行创建命令即可
先git之后的工程需要另外注意，只需要创建子应用即可

cd ~/Desktop/Django_pro/demo1
django-admin startproject my_demo1

2、工程目录说明

项目目录
执行完创建任务之后，会生成如图所示，文件目录：

1 代表项目名称
2 代表与项目同名的目录，其下面有重要的项目配置和路由文件
3 项目的配置文件
4 项目主要的URL配置文件
5 web服务器入口和项目管理文件

3、运行开发服务器

我们需要找到项目的管理文件manage.py通过此文件启动管理项目。

cd my_demo1
python manage.py runserver ip:端口号
或者
python manage.py runserver
# 默认端口号为8000

四、修改配置为dev&prod

在项目同名目录下新建settings包，将配置信息拷贝到新建的dev.py和prod.py文件中。需要修改配置文件中默认的配置文件路径到目前的dev.py路径。

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

五、restful风格

# 安装django-restframework
pip install djangorestframework
# 配置文件中，添加restful应用
INSTALLED_APPS = [
    'rest_framework'
    ...
]

六、创建数据库

create database shopping_mall charset=utf8;
# 为项目创建用户，避免使用root用户
create user shopper identified by 'shopper'; 
grant all on shopping_mall.* to 'shopper'@'%'; 
flush privileges;

七、基本配置

我们开发环境下，修改settings/dev.py文件，加入我们需要使用的配置信息。

1、配置接口路径apps

将apps路径加到系统的路径中，方便直接找到apps中的接口，当在配置中注册接口的时候就可以直接使用apps的相对路径注册即可。

import sys
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))
# 我们可以通过输出sys.path来验证添加是否成功
# 从insert不难看出系统路径使用列表存储

2、配置MySQL数据库

首先我们需要到使用的虚拟环境中安装PyMySQL，并python3的版本支持修改

# 安装
pip install PyMySQL

# 修改BASE_DIR文件路径下的__init__.py文件
from pymysql import install_as_MySQLdb
install_as_MySQLdb()

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

3、配置Redis

# 安装django-redis
pip install django-redis

# 配置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"

4、配置日志

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',  # 日志器接收的最低日志级别
        },
    }
}

5、配置restful异常处理

首先修改settings/dev.py

REST_FRAMEWORK = {
    # 异常处理
    'EXCEPTION_HANDLER': 'meiduo_mall.utils.exceptions.exception_handler',
}

然后新建utils/exceptions.py，并添加以下代码，主要是重写了默认exception_hanlder方法，实现了mysql和redis异常处理。

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

八、到此我们就可以根据自己的业务逻辑，添加我们自己需要功能了

Django项目搭建步骤