创建一个Django项目的基本操作
下载IDE，如：pycharm，
数据库、其他中间件等
2-创建虚拟环境
需要制定虚拟环境，环境中安装好Django的版本，可pip install 安装好
如果在pycharm中可以直接拖进去当前目录即可安装依赖包，可直接settings创建虚拟环境
命令：mkvirtualenv django_py3 -p python3
3-创建工程
进入某文件或者创建某文件目录下，django-admin.py startproject 工程名
4-创建子应用
子应用最好装在一个apps目录下，这样比较方便写接口代码
注意将apps设定为导包路径
python manage.py startapp 子应用名字
（这个地方要注意寻找到manage.py的文件路径，通常我的是../../manage.py）
5-运行工程
python manage.py runserver ip：端口
或： python manage.py runserver
下面为配置文件的配置项
6-注册安装子应用
\'rest_framework\', # DRF 第三方包写在中间，自己的包写最下面
\'users.apps.UsersConfig\'。
用到第三方包的话也要注册第三方应用 注册与配置文件中
7-工程配置
1、修改配置文件，创建settings目录，存放dev开发模式，prod线上模式，两个配置分别存放。
将settings.py文件的配置cv过来，修改manag.py的默认配置
os.environ.setdefault("DJANGO_SETTINGS_工程名", "同名工程名.settings.dev")
8-修改导包路径
我们将配置文件改为放在settings子目录下，所以 配置文件中的BASE_DIR指向的变为了存放工程的文件夹/工程名字/工程同名目录。
使用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\'))
9-数据库
于配置文件修改
DATABASES = {
\'default\': {
\'ENGINE\': \'django.db.backends.mysql\',
\'HOST\': \'*.*.*.*\', # 数据库主机
\'PORT\': 3306, # 数据库端口
\'USER\': \'gaap\', # 数据库用户名
\'PASSWORD\': \'gaap\', # 数据库用户密码
\'NAME\': \'gaap\' # 数据库名字
}
}
注意：
记得在存放工程的文件夹/工程名/__init__.py文件中添加
import pymysql
pymysql.install_as_MySQLdb()
10-安装djang-redis并配置
CACHES = {
"default": {
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://*.*.*.*:6379/0",
"OPTIONS": {
"CLIENT_CLASS": "django_redis.client.DefaultClient",
}
},
"session": {
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://*.*.*.*:6379/1",#ip地址：端口/redis的库名之一
"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站点使用。
11-语言
LANGUAGE_CODE = \'zh-hans\'
TIME_ZONE = \'Asia/Shanghai\'
12-日志
LOGGING = {
\'version\': 1,
\'disable_existing_loggers\': False, # 是否禁用已经存在的日志器
\'formatters\': { # 日志信息显示的格式
\'verbose\': {
\'format\': \'%(levelname)s %(asctime)s %(gaap)s %(lineno)d %(message)s\'
},
\'simple\': {
\'format\': \'%(levelname)s %(gaap)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/gaap.log"), # 日志文件的位置
\'maxBytes\': 300 * 1024 * 1024,
\'backupCount\': 10,
\'formatter\': \'verbose\'
},
},
\'loggers\': { # 日志器
\'django\': { # 定义了一个名为django的日志器
\'handlers\': [\'console\', \'file\'], # 可以同时向终端与文件中输出日志
\'propagate\': True, # 是否继续传递日志信息
\'level\': \'INFO\', # 日志器接收的最低日志级别
},
}
}
13-异常处理
修改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
需要配置
如果我们新建utils文件中自定义异常处理了，那么我需要在配置文件中添加配置：
REST_FRAMEWORK = {
# 异常处理
\'EXCEPTION_HANDLER\': \'工程名.utils.exceptions.exception_handler\',
}#主要是指定好路径
14-追加apps为导包路径
创建一个apps包，来写程序应用。但是需要source root添加到导包路径中，才可以导包。而导包路径默认的是Django的路径。
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(file))) （ 上一级/上一级/当前文件）
当前工程的根目录，Django会依此来定位工程内的相关文件，我们也可以使用该参数来构造文件路径。
1.提示 上⾯AUTH_USER_GAAP = \'users.User\'的⽅式的导包路径，默认是不会被识别的，需要追加导包路径
2.查看默认的导包路径
import sys
print(sys.path)
3.追加导包路径 sys.path.insert(0, os.path.join(BASE_DIR, \'apps\'))
15-自定义用户模型
Django提供了django.contrib.auth.models.AbstractUser用户抽象模型类允许我们继承，扩展字段来使用Django认证系统的用户模型类。
在 工程名/工程同名目录/apps中创建Django应用users，并在配置文件中注册users应用。
在创建好的应用models.py中定义用户的用户模型类。
-
class User(AbstractUser): """用户模型类""" mobile = models.CharField(max_length=11, unique=True, verbose_name=\'手机号\')
-
class Meta: db_table = \'tb_users\' verbose_name = \'用户\' verbose_name_plural = verbose_name
我们自定义的用户模型类还不能直接被Django的认证系统所识别，需要在配置文件中告知Django认证系统使用我们自定义的模型类。
在配置文件中进行设置
settings的dev.py更改配置l（底层要求必须按这个格式写应用名.模型名的格式）
AUTH_USER_GAAP = \'users.User\'