【Django开发】开发美多商城项目第1篇：项目结构设计和工程创建（附代码，已分享）
本系列文章md笔记（已分享）主要讨论django商城项目相关知识。项目利用Django框架开发一套前后端不分离的商城项目（4.0版本）含代码和文档。功能包括前后端不分离，方便SEO。采用Django + Jinja2模板引擎 + Vue.js实现前后端逻辑，Nginx服务器（反向代理）Nginx服务器（静态首页、商品详情页、uwsgi服务器（美多商场业务场景），后端服务：MySQL、Redis、Celery、RabbitMQ、Docker、FastDFS、Elasticsearch、Crontab，外部接口：容联云、QQ互联、支付宝。
项目笔记和代码自取地址： https://gitee.com/yinuo112/Backend/tree/master/Django/美多商城/1.md
感兴趣的小伙伴可以自取哦，欢迎大家点赞转发~
共 11 章，132 子模块
欢迎来到美多商城！
项目准备
项目介绍
项目需求分析
需求分析原因：
- 可以整体的了解项目的业务流程和主要的业务需求。
- 项目中，需求驱动开发。即开发人员需要以需求为目标来实现业务逻辑。
需求分析方式：
- 企业中，借助 产品原型图 分析需求。
- 需求分析完后，前端按照产品原型图开发前端页面，后端开发对应的业务及响应处理。
需求分析内容：
- 页面及其业务流程和业务逻辑。
提示：
- 我们现在借助 示例网站 作为原型图来分析需求。
1. 项目主要页面介绍
1.首页广告
2.注册
3.登录
4.QQ登录
5.个人信息
6.收货地址
7.我的订单
8.修改密码
9.商品列表
10.商品搜索
11.商品详情
12.购物车
13.结算订单
14.提交订单
15.支付宝支付
16.支付结果处理
17.订单商品评价
2. 归纳项目主要模块
为了方便项目管理及多人协同开发，我们根据需求将功能划分为不同的模块。
将来在项目中，每个**模块都会对应一个子应用进行管理和解耦**。
| 模块 | 功能 |
|---|---|
| 验证 | 图形验证、短信验证 |
| 用户 | 注册、登录、用户中心 |
| 第三方登录 | QQ登录 |
| 首页广告 | 首页广告 |
| 商品 | 商品列表、商品搜索、商品详情 |
| 购物车 | 购物车管理、购物车合并 |
| 订单 | 确认订单、提交订单 |
| 支付 | 支付宝支付、订单商品评价 |
| MIS系统 | 数据统计、用户管理、权限管理、商品管理、订单管理 |
3. 知识要点
- 需求分析原因：需求驱动开发。
- 需求分析方式：企业中，使用产品原型图。
- 需求分析内容：页面及业务逻辑。
- 需求分析结果：划分业务模块，明确每个模块下的主要功能，并以子应用的形式进行管理。
项目架构设计
1. 项目开发模式
| 选项 | 技术选型 |
|---|---|
| 开发模式 | 前后端不分离 |
| 后端框架 | Django + Jinja2模板引擎 |
| 前端框架 | Vue.js |
说明：
- 前后端不分离的开发模式，是为了提高搜索引擎排名，即SEO。特别是首页，详情页和列表页。
- 页面需要整体刷新：我们会选择使用Jinja2模板引擎来实现。
- 页面需要局部刷新：我们会选择使用Vue.js来实现。
2. 项目运行机制
3. 知识要点
-
项目开发模式
- 前后端不分离，方便SEO。
- 采用Django + Jinja2模板引擎 + Vue.js实现前后端逻辑。
-
项目运行机制
- 代理服务：Nginx服务器（反向代理）
- 静态服务：Nginx服务器（静态首页、商品详情页、…）
- 动态服务：uwsgi服务器（美多商场业务场景）
- 后端服务：MySQL、Redis、Celery、RabbitMQ、Docker、FastDFS、Elasticsearch、Crontab
- 外部接口：容联云、QQ互联、支付宝
工程创建和配置
创建工程
美多商城项目源代码采用**远程仓库托管**。
1. 准备项目代码仓库
1.源码托管网站
- 码云（https://gitee.com/）
2.创建源码远程仓库：meiduo_project
2. 克隆项目代码仓库
1.进入本地项目目录
$ mkdir ~/projects
$ cd projects/
2.克隆仓库
$ git clone https://gitee.com/zjsharp/meiduo_project.git
3. 创建美多商城工程
1.进入本地项目仓库
$ cd ~/projects/meiduo_project/
2.创建美多商城虚拟环境，安装Django框架
$ mkvirtualenv -p python3 meiduo_mall
$ pip install django==1.11.11
3.创建美多商城Django工程
$ django-admin startproject meiduo_mall
创建工程完成后：运行程序，测试结果。
配置开发环境
美多商城项目的环境分为**开发环境和生产环境**。
- 开发环境：用于编写和调试项目代码。
- 生产环境：用于项目线上部署运行。
1. 新建配置文件
-
准备配置文件目录
- 新建包，命名为settings，作为配置文件目录
-
准备开发和生产环境配置文件
- 在配置包settings中，新建开发和生产环境配置文件
-
准备开发环境配置内容
- 将默认的配置文件settings.py中内容拷贝至dev.py
2. 指定开发环境配置文件
配置完成后：运行程序，测试结果。
配置Jinja2模板引擎
美多商城的模板采用**Jinja2模板引擎**。
1. 安装Jinja2扩展包
$ pip install Jinja2
2. 配置Jinja2模板引擎
TEMPLATES = [
{
'BACKEND': 'django.template.backends.jinja2.Jinja2', # jinja2模板引擎
'DIRS': [os.path.join(BASE_DIR, 'templates')],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
},
]
3. 补充Jinja2模板引擎环境
1.创建Jinja2模板引擎环境配置文件
2.编写Jinja2模板引擎环境配置代码
from jinja2 import Environment
from django.contrib.staticfiles.storage import staticfiles_storage
from django.urls import reverse
def jinja2_environment(**options):
env = Environment(**options)
env.globals.update({
'static': staticfiles_storage.url,
'url': reverse,
})
return env
"""
确保可以使用模板引擎中的{{ url('') }} {{ static('') }}这类语句
"""
3.加载Jinja2模板引擎环境
TEMPLATES = [
{
'BACKEND': 'django.template.backends.jinja2.Jinja2', # jinja2模板引擎
'DIRS': [os.path.join(BASE_DIR, 'templates')],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
# 补充Jinja2模板引擎环境
'environment': 'meiduo_mall.utils.jinja2_env.jinja2_environment',
},
},
]
配置完成后：运行程序，测试结果。
配置MySQL数据库
美多商城数据存储服务采用**MySQL数据库**。
1. 新建MySQL数据库
1.新建MySQL数据库：meiduo_mall
$ create database meiduo charset=utf8;
2.新建MySQL用户
$ create user itheima identified by '123456';
3.授权itcast用户访问meiduo_mall数据库
$ grant all on meiduo.* to 'itheima'@'%';
4.授权结束后刷新特权
$ flush privileges;
2. 配置MySQL数据库
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql', # 数据库引擎
'HOST': '127.0.0.1', # 数据库主机
'PORT': 3306, # 数据库端口
'USER': 'itheima', # 数据库用户名
'PASSWORD': '123456', # 数据库用户密码
'NAME': 'meiduo' # 数据库名字
},
}
可能出现的错误
- Error loading MySQLdb module: No module named ‘MySQLdb’.
出现错误的原因：
- Django中操作MySQL数据库需要驱动程序MySQLdb
- 目前项目虚拟环境中没有驱动程序MySQLdb
解决办法：
- 安装PyMySQL扩展包
- 因为MySQLdb只适用于Python2.x的版本，Python3.x的版本中使用PyMySQL替代MySQLdb
3. 安装PyMySQL扩展包
1.安装驱动程序
$ pip install PyMySQL
2.在工程同名子目录的__init__.py文件中，添加如下代码：
from pymysql import install_as_MySQLdb
install_as_MySQLdb()
配置完成后：运行程序，测试结果。
配置Redis数据库
美多商城数据缓存服务采用**Redis数据库**。
1. 安装django-redis扩展包
1.安装django-redis扩展包
$ pip install django-redis
2.django-redis使用说明文档
点击进入文档
2. 配置Redis数据库
CACHES = {
"default": { # 默认
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://127.0.0.1:6379/0",
"OPTIONS": {
"CLIENT_CLASS": "django_redis.client.DefaultClient",
}
},
"session": { # session
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://127.0.0.1:6379/1",
"OPTIONS": {
"CLIENT_CLASS": "django_redis.client.DefaultClient",
}
},
}
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
SESSION_CACHE_ALIAS = "session"
default：
- 默认的Redis配置项，采用0号Redis库。
session：
- 状态保持的Redis配置项，采用1号Redis库。
SESSION_ENGINE
- 修改
session存储机制使用Redis保存。
SESSION_CACHE_ALIAS：
- 使用名为"session"的Redis配置项存储
session数据。
配置完成后：运行程序，测试结果。
配置工程日志
美多商城的日志记录采用logging模块。
1. 配置工程日志
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', # 日志器接收的最低日志级别
},
}
}
2. 准备日志文件目录
3. 日志记录器的使用
import logging
# 创建日志记录器
logger = logging.getLogger('django')
# 输出日志
logger.debug('测试logging模块debug')
logger.info('测试logging模块info')
logger.error('测试logging模块error')
4. Git管理工程日志
提示1：
- 开发过程中，产生的日志信息不需要代码仓库进行管理和记录。
提示2：
- 建立代码仓库时，生成的忽略文件中已经默认忽略掉了 *.log 。
问题：
- logs文件目录需求被Git仓库记录和管理。
- 当把
*.log都忽略掉后，logs文件目录为空。 - 但是，Git是不允许提交一个空的目录到版本库上的。
解决：
- 在空文件目录中建立一个 .gitkeep 文件，然后即可提交。
配置完成后：运行程序，测试结果。
5. 知识要点
- 本项目最低日志等级设置为：INFO
- 创建日志记录器的方式：
logger = logging.getLogger('django')
- 日志记录器的使用：
logger.info('测试logging模块info')
- 在日志
loggers选项中可以指定多个日志记录器
配置前端静态文件
美多商城项目中需要使用静态文件，比如 css、images、js 等等。
1. 准备静态文件
2. 指定静态文件加载路径
STATIC_URL = '/static/'
# 配置静态文件加载路径
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
配置完成后：运行程序，测试结果。
- http://127.0.0.1:8000/static/images/adv01.jpg
用户注册
展示用户注册页面
44)]
配置完成后：运行程序，测试结果。
5. 知识要点
- 本项目最低日志等级设置为：INFO
- 创建日志记录器的方式：
logger = logging.getLogger('django')
- 日志记录器的使用：
logger.info('测试logging模块info')
- 在日志
loggers选项中可以指定多个日志记录器
配置前端静态文件
美多商城项目中需要使用静态文件，比如 css、images、js 等等。
1. 准备静态文件
[外链图片转存中…(img-zRARQxlT-1704279314144)]
[外链图片转存中…(img-XwauAsKP-1704279314144)]
2. 指定静态文件加载路径
STATIC_URL = '/static/'
# 配置静态文件加载路径
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
配置完成后：运行程序，测试结果。
- http://127.0.0.1:8000/static/images/adv01.jpg