一分钟上手让你黯然失色的django环境安装

项目环境搭建

一、创建django项目

1.创建python虚拟环境

在虚拟机上创建python虚拟环境，因为实际项目部署，实在linux

mkvirtualenv -p /usr/bin/python3.6 tzproject

2.创建django项目

1.安装django

选择安装django2.1.x最新的一个版本2.1.10

pip install django==2.1.10

2.创建django项目

cd ~/project/ # cd到你想放django项目路径的地方
django-admin startproject tzproject

3.创建pycharm项目

通过pycharm的远程项目，连接虚拟机，开发。

1.选择项目目录

选择你要存放项目文件的目录，注意django项目和pycharm项目的根目录一定要保持一致，不要用一个pycharm的项目，管理多个django项目。

2.配置远程解释器

配置刚才创建的虚拟解释器

3.配置远程项目路径

4.设置同步配置

5.下载代码

4.pycharm配置Django项目

代码下载后，就需要将在pycharm中将项目配置成django项目，以便使用pycharm的各种便捷提示功能。

做好虚拟机端口映射，在浏览器里输入http://127.0.0.1:8000你应该看到下面的画面

二、django项目设置

1.配置模板文件

TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'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',
],
# 将模板标签内置到模板中 https://docs.djangoproject.com/en/2.1/topics/templates/
'builtins': ['django.templatetags.static'],
},
},
]

2.配置mysql数据库

1. 创建数据库

• mysql> create database tzproject charset=utf8mb4;
  Query OK, 1 row affected (0.00 sec)

1. 创建用户

• mysql> greate user 'dj_user'@'host' identified by 'pythonvip';
  Query OK, 1 row affected (0.00 sec)

1. 授权

• mysql> grant all privileges on tzproject.* to 'dj_user'@'%';
  Query OK, 0 rows affected (0.03 sec)
  mysql> flush privileges;
  Query OK, 0 rows affected (0.02 sec)
  # 授权创建一起写
  grant all privileges on tzproject.* to 'xinlan'@'%' indentified by 'pythonvip'

1. 配置settings

• 方法一：直接在settings.py文件中添加数据库配置信息
• DATABASES = {
  'default': {
  'ENGINE': 'django.db.backends.mysql', # 数据库引擎
  'NAME': 'tzproject', # 数据库名
  'USER': 'dj_user', # 用户名
  'PASSWORD': 'pythonvip', # 密码
  'HOST': '127.0.0.1', # 主机IP
  'PORT': 3306 # 端口
  }
  }
• 方法二：将数据库配置信息存到一个文件，在settings文件中将其引入。（推荐）
• 新建数据库配置文件db.cnf(名字随意)

• db.cnf文件内容：
• [client]
  database = tzproject
  user = dj_user
  password = pythonvip
  host = 127.0.0.1
  port = 3306
  default-character-set = utf8
• 在settings.py文件中引入db.cnf
• DATABASES = {
  'default': {
  'ENGINE': 'django.db.backends.mysql',
  'OPTIONS':{
  'read_default_file': 'utils/db/db.cnf'
  }
  }
  }

3.安装mysql数据库的python驱动

⚠️mysql数据库配置完成后，运行django服务会报如下错误，官方推荐安装mysqlclient1.3.7以上版本，也可以安装pymysql，并且需要在settings.py文件所在目录包中的__init__.py中导入pymysql。

1. 安装mysqlclient

• # 首先更新ubuntu
  sudo apt-get update
• # 然后按照依赖库
  sudo apt-get install default-libmysqlclient-dev
• # 再切换到虚拟环境中
  workon tzproject
• # 最后安装mysqlclient
  pip install mysqlclient==1.3.9 https://pypi.doubanio.com/simple

1. 安装pymysql

• # 安装pymysql
  pip install pymysql -i https://pypi.doubanio.com/simple
• 在settings.py文件所在目录下的__init__.py导入

推荐使用第一种方式，mysqlclient更快更安全，官方推荐。

4.配置redis缓存

用于存放用户session信息，以及需要缓存的各种信息。

# 在虚拟机中安装django-redis
pip install django-redis

# settings.py文件中指定redis配置

CACHES = {
"default": {
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://127.0.0.1:6379/0",
"OPTIONS": {
"CLIENT_CLASS": "django_redis.client.DefaultClient",
}
},
'session': {
'BACKEND': 'django_redis.cache.RedisCache',
'LOCATION': 'redis://127.0.0.1:6379/1',
'OPTIONS': {
'CLIENT_CLASS': 'django_redis.client.DefaultClient',
}
},
}

# session存储缓存设置
SESSION_ENGINE = 'django.contrib.sessions.backends.cache'
SESSION_CACHE_ALIAS = 'session'

5.配置日志器

用于记录系统运行过程中的各种日志信息。

在项目根目录中创建一个logs文件夹，用于存放日志文件

# 日志
LOGGING = {
# 版本
'version': 1,
# 是否禁用已存在的日志器
'disable_existing_loggers': False,
'formatters': {
'verbose': {
'format': '{levelname} {asctime} {module} {lineno:d} {message}',
'style': '{',
},
'simple': {
'format': '{levelname} {module} {lineno:d} {message}',
'style': '{',
},
},
'filters': {
'require_debug_true': {
'()': 'django.utils.log.RequireDebugTrue',
},
},
'handlers': {
'console': {
'level': 'DEBUG',
'filters': ['require_debug_true'],
'class': 'logging.StreamHandler',
'formatter': 'simple'
},
'file': {
'level': 'INFO',
# 这个handler可以记录一组日志文件
'class': 'logging.handlers.RotatingFileHandler',
'filename': os.path.join(BASE_DIR, 'logs/tz_django.log'),
# 单个日志文件最大字节数
'maxBytes': 300*1024*1024,
# 日志文件个数
'backupCount': 10,
'formatter': 'verbose'
},
},
'loggers': {
'django': {
'handlers': ['console', 'file'],
'level': 'INFO', # 日志器接收的最低级别
'propagate': True,
},
},
}

使用方法

# 使用方法
# import the logging library
import logging

# Get an instance of a logger
# 此处的django为，settings.py文件中，LOGGING配置下的loggers中定义的日志器名称
logger = logging.getLogger('django')

def my_view(request, arg1, arg):
...
if ***:
# Log an error message
logger.error('Something went wrong!')

6.时区配置

# 修改语言
LANGUAGE_CODE = 'zh-hans'
# 修改时区
TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True
# 使用时区
USE_TZ = True

7.静态文件配置

在项目根目录创建一个static目录，用于存放静态文件(css, js, image, font等)

STATIC_URL = '/static/'
STATICFILES_DIRS = [
os.path.join(BASE_DIR, 'static')
]

8.创建应用

本项目主要由4个模块组成，分别为新闻文章模块，课程视频播放模块，文档下载模块，用户管理模块等。在项目根目录下创建一个apps目录用于存放各子应用。

然后cd到apps目录创建各子应用

~$ cd ~/code/tztz/apps/
~/code/tztz/apps$ workon tzproject
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp news
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp course
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp doc
(tzproject) ~/code/tztz/apps$ python ../manage.py startapp user

再到settings文件中，加入如下设置

import sys

# 创建应用之后，把apps目录加入到sys.path中
sys.path.insert(0, BASE_DIR)
sys.path.insert(1, os.path.join(BASE_DIR, 'apps'))

接着分别在apps文件夹和项目根目录文件夹上右键，加入到Source Root中，优化导入路径(pycharm提示)。

最后将应用添加到INSTALLED_APPS列表中

INSTALLED_APPS = [
# ...
'user',
'news',
'doc',
'course'
]

三、在码云平台创建项目

git服务平台：

• 主要使用github（最主流）
• 国内访问速度慢
• 托管私有项目收费

• 国内一般使用码云gitee
• 国内访问速度快
• 托管私有项目免费（限制开发人数）

• 公司中使用gitlab或者svn来搭建

创建步骤

1.注册码云账号注册

2.创建仓库

1. 登录码云后，通过网站右上角的「+」号，选择「新建仓库」，进入新建仓库页面

1. 填写仓库信息

3.生成ssh公钥

ssh-keygen -t rsa -C 'xinlan@tanzhou.com'

按照提示完成三次回车，即可生成ssh key。通过查看~/.ssh/id_rsa.pub文件内容，获取到你的public key

cat ~/.ssh/id_rsa.pub
# ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6eNtGpNGwstc....

复制生成后的 ssh key，通过设置主页「SSH公钥」->「添加公钥」，添加生成的public key到仓库中。

4.克隆项目到本地

复制ssh链接

克隆项目到虚拟机或者物理机都可以。

git clone git@gitee.com:wcflove/tztz.git

5.添加远程仓库

如果是先在本地建立了项目， 再在码云上创建远程仓库，那么操作如下。

1. 首先cd到django项目根目录，然后创建git本地仓库

• cd ~/project/tzporject
  git init

1. 然后添加远程仓库

• git remote add origin git@gitee.com:shujing_123/shujing.git

四、将项目推送到码云

手动同步代码(更保险)，然后运行django服务，检查无误后就可以提交代码，然后推送到码云了

• 编写.gitignore文件
• 为了让git的运行速度更快，有些不需要添加到仓库的文件比如pycharm的项目设置文件.idea文件夹，可以通过.gitignore文件来设置忽略.idea文件夹， 在.gitignore文件的最后加上下面两行
• ....
  # pycharm
  .idea/
• 配置好推送人的身份信息（填写自己的名字和邮箱地址）
• $ git config user.name "xinlan"
  $ git config user.email "xinlan@tz.com"
• 将代码推送至本地仓库
• # 工作区添加到暂存区
  $ git add .
  # 暂存区提交到仓库
  $ git commit -m 'project init'
• 将代码推送到码云
• $ git push origin master
• 注意，如果出现，推送失败就需要运行强推
• $ git push -f origin master

码云中就出现了，你本次写的代码

五、作业

1. 项目环境搭建好，运行结果绿色火箭截图上传
2. 代码推送至码云，将截图上传