Django实现简单博客系统

本文中相关信息部分来源《跟老齐学Python：Django实战》
官网地址：https://www.djangoproject.com/
本节代码地址：https://github.com/champion-yang/django_blog/tree/dev/blog_01

第一节 - 基础

1. 简单的导览图，学会不迷路

对 Django 的评价：借用李清照的《鹧鸪天 桂花》来表达，

暗淡轻黄体性柔。情疏迹远只香留。何须浅碧深红色，自是花中第一流。
梅定妒，菊应羞。画阑开处冠中秋。骚人可煞无情思，何事当年不见收。

Django makes it easier to build better Web apps more quickly and with less code.

• 容易上手，开发速度快
• 囊括了网站开发中的用户管理，内容管理，网站地图，RSS等常用的插件
• 安全性强，解决了 SQL 注入，跨站攻击等问题
• 应用广泛

2. 基本操作介绍

• 安装：pip install Django
• 创建项目：django-admin startproject mysite
• 运行项目：python manage.py runserver
• 创建应用：python manage.py startapp blog

3. 命令简单介绍

• django-admin.py ：django 的任务管理命令行工具
• manage.py ：对django-admin 的简单封装，同样可以实现命令行操作（最好对于该文件不要修改，也不要删除）

4. mysite：所建项目的管理功能目录

• setting.py ：项目初始化配置，可以针对整个项目进行有关参数的配置，比如数据库，添加应用等
• urls.py ：url 的配置表文件，主要是将url映射到应用程序上。可以是某个应用中的urls.py 文件，也可以是某个具体的视图函数。被称之为 URLconf，是 Django 一个非常强大的特性。
• wsgi.py ：web server gateway interface 的缩写。wsgi.py 定义了我们所创建的项目都是 wsgi 应用。

5. blog：我们创建的项目之一

• admin.py ：自定义 Django 管理工具，比如设置在管理界面能够管理的项目，或者重新定义与系统管理有关的类对象，向管理功能增加新的内容。
• apps.py ： 对应用的配置，比如为管理功能提供一个适合的应用名称
• migrations：存储应用数据的表结构的指令，可以修改和创建数据库，从而子 models.py 模型类和数据库表之间迁移
• models.py ： 应用的数据模型
• test.py ： 编写测试文档
• views.py ： 用户保存各种请求的函数或者类。如果编写的是函数，则称之为基于函数的视图，如果编写的是类，则称之为基于类的视图。

6. db.sqlite3 : 默认的数据库

7. 网站配置：mysite/setting.py

• DEBUG：开发的时候设置为 True。可以显示具体的报错信息。
• ALLOWED_HOSTS：在 DEBUG 为 True 的时候，值可以为空。在部署到生产环境的时候，需要把主域名填写到这里，才能通过域名访问到本网站
• INSTALLED_APPS: 所有的应用只有写到这里才会生效。
• DATABASES: 配置数据库。默认为 sqlite
• LANGUAGE_CODE: 设置姓名的语言。汉语设置为 ‘zh-hans’
• TIME_ZONE: 设置时区，通常东八。 设置为：‘Aisa/Shanghai’

第二节 - 博客开发

默认已经创建好的 django 的项目和应用，并将应用注册到项目中

1. 编写博客的数据模型类

设计数据库和表结构是做网站的基础。

在 ./blog/model.py 中编写如下类

from django.db import models
from django.contrib.auth.models import User
# Create your models here.
from django.utils import timezone


class BlogArticles(models.Model):
    title = models.CharField(max_length=300)
    author = models.ForeignKey(User, related_name='blog_posts', null=True, on_delete=models.SET_NULL)
    body = models.TextField()
    publish = models.DateTimeField(default=timezone.now)

    class Meta:
        ordering = ('-publish', )

    def __str__(self):
        return self.title

创建model 参考参数：

一、字段
	1、models.AutoField　　自增列= int(11)
	　　如果没有的话，默认会生成一个名称为 id 的列，如果要显示的自定义一个自增列，必须将				给列设置为主键 primary_key=True。
	2、models.CharField　　字符串字段
	　　必须 max_length 参数
	3、models.BooleanField　　布尔类型=tinyint(1)
	　　不能为空，Blank=True
	4、models.ComaSeparatedIntegerField　　用逗号分割的数字=varchar
	　　继承CharField，所以必须 max_lenght 参数
	5、models.DateField　　日期类型 date
	　　对于参数，auto_now =True则每次更新都会更新这个时间；auto_now_add 则只是第一次创建添加，之后的更新不再改变。
	6、models.DateTimeField　　日期类型 datetime
	　　同DateField的参数
	7、models.Decimal　　十进制小数类型= decimal
	　　必须指定整数位max_digits和小数位decimal_places
	8、models.EmailField　　字符串类型（正则表达式邮箱）=varchar
	　　对字符串进行正则表达式
	9、models.FloatField　　浮点类型= double
	10、models.IntegerField　　整形
	11、models.BigIntegerField　　长整形
	　　integer_field_ranges ={
	　　　　'SmallIntegerField':(-32768,32767),
	　　　　'IntegerField':(-2147483648,2147483647),
	　　　　'BigIntegerField':(-9223372036854775808,9223372036854775807),
	　　　　'PositiveSmallIntegerField':(0,32767),
	　　　　'PositiveIntegerField':(0,2147483647),
	　　}
	12、models.IPAddressField　　字符串类型（ip4正则表达式）
	13、models.GenericIPAddressField　　字符串类型（ip4和ip6是可选的）
	　　参数protocol可以是：both、ipv4、ipv6
	　　验证时，会根据设置报错
	14、models.NullBooleanField　　允许为空的布尔类型
	15、models.PositiveIntegerFiel　　正Integer
	16、models.PositiveSmallIntegerField　　正smallInteger
	17、models.SlugField　　减号、下划线、字母、数字
	18、models.SmallIntegerField　　数字
	　　数据库中的字段有：tinyint、smallint、int、bigint
	19、models.TextField　　字符串=longtext
	20、models.TimeField　　时间 HH:MM[:ss[.uuuuuu]]
	21、models.URLField　　字符串，地址正则表达式
	22、models.BinaryField　　二进制
	23、models.ImageField图片
	24、models.FilePathField文件
二、字段参数
	1、null=True
	　　数据库中字段是否可以为空
	2、blank=True
	　　django的 Admin 中添加数据时是否可允许空值
	3、primary_key = False
	　　主键，对AutoField设置主键后，就会代替原来的自增 id 列
	4、auto_now 和 auto_now_add
	　　auto_now 自动创建---无论添加或修改，都是当前操作的时间
	　　auto_now_add 自动创建---永远是创建时的时间
	5、choices
	GENDER_CHOICE = (
	(u'M', u'Male'),
	(u'F', u'Female'),
	)
	gender = models.CharField(max_length=2,choices = GENDER_CHOICE)
	6、max_length
	7、default　　默认值
	8、verbose_name　　Admin中字段的显示名称
	9、name|db_column　　数据库中的字段名称
	10、unique=True　　不允许重复
	11、db_index = True　　数据库索引
	12、editable=True　　在Admin里是否可编辑
	13、error_messages=None　　错误提示
	14、auto_created=False　　自动创建
	15、help_text　　在Admin中提示帮助信息
	16、validators=[]
	17、upload-to

2. 生成数据库迁移文件&创建数据表

# 命令行执行
# 创建数据库表迁移文件
python manage.py makemigrations
# 查看迁移文件
python manage.py sqlmigrate blog 0001

然后会发现在migrations文件夹下生成了以0001开头的py文件，在命令行会输出我们的建表语句（sql）

# 生成数据表
python manage.py migrate

可以在 navicate 中连接 db.sqlite 进行数据的查看。

3. 创建超级管理员

python manage.py createsuperuser

跟着步骤就可以了，创建超级管理员的账号和密码。一定牢记嗷~

启动项目后访问 http://127.0.0.1:8000/admin/
然后就可以进入页面啦

页面中的 Groups 和 Users 是 Django 在用户管理应用中默认的。

4. 发布博客文章

我们登陆进来之后没有找到发布文章的地方，为什么呢？

接下来就需要我们对 ./blog/admin.py 文件做修改了。

from django.contrib import admin
from .models import BlogArticles
# 将该类BlogArticles注册到admin中
admin.site.register(BlogArticles)

再次返回我们的 http://127.0.0.1:8000/admin/ 就可以进行文章的添加了。

5. 显示博客信息

我们写好的文章如果想让别人看到，如何做呢？

在templates目录下创建一个文件base.html 和一个blog文件夹，里面有 title.html , content.html 文件

文件内容如下：

# base.html
<!DOCTYPE html>
<html lang="zh-cn">
<head>
    <meta http-equiv="X-UA-Compatible" content="IE=Edge">
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=l">
    <title>{% block title %}{% endblock %}</title>
    <link rel="stylesheet" href="http://necolas.github.io/nomalize.css/">
    <link rel="stylesheet" href="http://libs.baidu.com/bootstrap/3.0.3/css/bootstrap.min.css">
</head>
<body>
<div class="container">
    {% block content %}
    {% endblock %}
</div>
</body>
<script src="http://libs.baidu.com/jquery/2.0.0/jquery.min.js"></script>
</html>

# title.html
{% extends "base.html" %}

{% block title %}
    博客标题
{% endblock %}

{% block content %}
    <div class="row text-center vertical-middle-sm">
        <h1>小北的博客</h1>
    </div>

    <div class="row">
        <div class="col-xs-12 col-mo-8">
            <ul>
                {% for blog in blogs %}
                    <li>
                        <a href="{{ blog.id }}">{{ blog.title }}</a>

                    </li>
                {% endfor %}
            </ul>
        </div>
        <div class="col-xs-6 col-mo-4">
            <h2>广告</h2>
            <p>和我一起学python</p>
        </div>
    </div>
{% endblock %}
# content.html
{% extends "base.html" %}

{% block title %}
    博客内容
{% endblock %}

{% block content %}
    <div class="row text-center vertical-middle-sm">
        <h1>{{ article.title }}</h1>
    </div>

    <div class="row">
        <div class="col-xs-12 col-mo-8">
            <div>
                <p>{{ article.author.username }}</p>
                <p>{{ publish }}</p>
                <p>{{ article.body }}</p>
            </div>
        </div>
        <div class="col-xs-6 col-mo-4">
            <h2>广告</h2>
            <p>和我一起学python</p>
        </div>
    </div>
{% endblock %}

一定要在 templates 下创建，这是Django 默认的存放本应用所需模版的目录

图为示例结构

在./blog/views.py 中编写视图函数

from django.shortcuts import render
from .models import BlogArticles
# Create your views here.


def blog_title(request):
    blogs = BlogArticles.objects.all()

    return render(request, "blog/title.html", {"blogs": blogs})

def blog_aritcle(request, article_id):
    article = BlogArticles.objects.get(id=article_id)
    pub = article.publish

    return render(request, "blog/content.html", {"article": article, "publish": pub})

在url中注册路由地址

在 blog/urls.py 中

from django.conf.urls import url
from . import views
from django.urls import path
from blog.views import *


urlpatterns = [
    path('title', blog_title, name='blog_title'),
    path('<int:article_id>', blog_aritcle, name='blog_aritcle'),
]

在当前项目下的urls.py 中

from django.contrib import admin
from django.urls import path
from django.conf.urls import url, include

urlpatterns = [
    path('admin/', admin.site.urls, name='admin'),
    path('blog/', include('blog.urls')),

]

然后页面就可以访问了，可以查看文章列表页和详情页。

第三节 - 思想整合

所有的思想都是建立的实践的基础上的，所以我把思想的整理放在了第三节。这一节主要会介绍道一些 Django 的设计理念，想到哪写到哪，有机会的话随时补充。

1. 聊聊 MVC

做后台开发，一定会知道这个名词 MVC，算是一种动态网站的设计模式吧。目的呢，我觉得还是从“懒”出发，因为懒得写重复的东西，所以在开发的时候，遇到相同的功能就想把他整合起来，然后发现有些🈶️共性的地方，所以把这些有共性的玩意又用一个框子给他框起来，方便修改扩展简化，然后就出现了 MVC。

MVC ： model-view-controller，这种模式就是把数据存储逻辑，业务逻辑和表现逻辑组合在一起的模式。model 代表了数据存储层，view 代表系统中选择显示和不显示的部分，controller 则是根据用户输入和需要访问模型，决定使用哪个视图的部分。当然，在很多时候大家并不会严格遵守这样的开发规定，因人而异，也因项目而异。

Django 中也遵循这种设计原则，具体表现如下：

• M：数据存储和读取。由 Django 中的数据模型承担，也就是models.py 中定义的内容。
• V：确定需要显示的数据和如何显示，由视图和模版进行处理
• C：根据客户的的请求映射到相应的路由，Django 中由 URLConf 设置，来调用相应的视图函数

但是在 Django 中呢，controller 是框架自动处理的，不需要开发人员有过多的干涉，所以大家一般会称 Django 为 MTV 模式，即 把 MVC 中的 view 分成了 template + view：

• M：具象来说就是模型（Model）
• T：模版（Template），表现层，处理与表现有关的事务，例如如何在页面中显示内容
• V：视图（Views），业务逻辑层，包含了存储模型及调取相应模版的逻辑，是 M 和 T 之间的桥梁。

小结一下：
当 Django 得到用户的请求后，根据 URL 映射关系调用相应的视图，视图则调用和处理有关数据，视图确定访问者能看到哪些数据，模版则确定了调用者怎样看到这些数据（或用什么方式看到这些数据）。

整理了一张图，可以瞅瞅，帮助理解。

其实不管是哪个框架，设计基本上都会包括这些。有的是集成进来了，有的需要我们自己去调用设计。比如 Flask 中，你需要手动去配置钩子函数实现这些。

啥玩意？看不懂～那给你来个“简单”的

师傅领进门，修行在个人。抽空建议看下 Scrapy 的框架设计，也是很不错，而且感觉和 Django 的有点像。中间件开发

2. 聊聊设计理念

上面说到了设计模式和实现流程，那这些模式和流程是怎么被设计出来的呢？比如我们要“高举爱国主义的伟大旗帜，坚持共产党的领导，拥护党和任命”，那这些是什么呢？是我们的理念。

• DRY：don’t repeat yourself！这个其实是所有程序开发的原则，虽然实现起来是真的挺难的～尤其是在项目吃紧的情况下。Django 针对此方面，把一些常用的操作，就比如对模型的操作，做了一些封装，我们可以直接调用，这不就是 DRY 嘛。
• 松耦合与灵活：数据库访问，业务逻辑，模版显示等松耦合。比如数据库配置，我不喜欢 sqlite 我换成 mysql ，一点问题都没有。
• 快速开发：可能只需要半天时间就可以搭建一个博客系统，你说快不快。

结束

一个简单的博客系统就搭建好了，可以供我们创建用户，写文章，别人可以查看我们的文章。

兴趣是最好的老师，如果能亲手实现一遍的话，那种成就感爆棚。

接下来我会介绍一些Django的其他用法，都是一些django的常见用法，当然也会包括一些基础知识，一方面为了梳理一下知识体系，一方面本着开源免费的精神，做个分享。感兴趣就点进去看看吧。