Django 学习笔记（一）—— 快速建站

Django 是一个基于 MVC（Model-View-Controller）模式的服务器端的 Web 框架，由 Python 语言编写。
其创建之初主要是用来与关系型数据库进行交互，随着技术的不断革新，Django 也逐渐融合了众多更现代的 Web 开发趋势。
作为一个成熟的 Web 开发框架，Django 有着众多企业级的应用，如 Instagram、Pinterest、National Geographic 等。

Django 设计原则

Don’t Repeat Yourself (DRY)
Explicit Is Better Than Implicit
Loosely Coupled Architecture

一、环境搭建

Ubuntu 系统。为了保证多个 Python 运行环境之间彼此不受影响，这里通过 virtualenv 创建独立的虚拟开发环境。

使用 apt-get 命令安装 virtualenv ：
$ sudo apt-get install python3-virtualenv

或者使用 Python 的包管理器（pip 命令）安装：
$ python3 -m pip install virtualenv

使用 virtualenv 命令创建独立的虚拟运行环境：
$ virtualenv --python=python3 mydjango

激活刚刚创建的虚拟环境：
$ source activate mydjango/bin/activate

安装 Django 框架：
$ pip install django

二、创建初始项目

Django 框架安装成功以后，会提供 django-admin 命令用于常见的管理操作。如 django-admin startproject 命令用于创建一个初始项目的骨架：
$ django-admin startproject testproject

该命令会在当前目录下创建 testproject 文件夹，结构如下：

testproject
├── manage.py
└── testproject
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

其中各文件的作用如下：

manage.py：类似于 django-admin 命令，用于执行一些项目相关的任务
settings.py：Django 项目的配置设置
urls.py：Django 项目的 URL 模式
wsgi.py：Django 项目的 WSGI 配置。WSGI 是 Django 应用部署在生产环境中的推荐方式

运行测试服务

进入项目目录，运行 python manage.py runserver <IP:Port> 命令开启测试服务，一个可供访问的最简单的 Web 站点即搭建成功：

$ python manage.py runserver 0.0.0.0:8000
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

June 20, 2019 - 09:03:29
Django version 2.2.2, using settings 'testproject.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

效果如下：

django

三、数据库配置

创建数据库 django 并授予用户 admin 访问权限：

mysql> CREATE DATABASE django;
Query OK, 1 row affected (0.00 sec)

mysql> GRANT ALL ON django.* TO admin IDENTIFIED BY 'password';
Query OK, 0 rows affected, 1 warning (0.07 sec)

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

Django 使用 SQLite3 作为默认的数据库引擎，相关配置位于 settings.py 配置文件中：

...
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
...

如需使用 MySQL 数据库，将 settings.py 文件中的对应部分改为如下内容：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'HOST': '127.0.0.1',
        'NAME': 'django',
        'PASSWORD': 'password',
        'PORT': '3306',
        'USER': 'admin',
    }
}

安装 Python 操作 MySQL 的依赖库：

$ sudo apt-get install python3-dev libmysqlclient-dev
$ pip install mysqlclient

使用 python manage.py migrate 命令完成数据库迁移操作：

$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying auth.0010_alter_group_name_max_length... OK
  Applying auth.0011_update_proxy_permissions... OK
  Applying sessions.0001_initial... OK

四、Django 管理后台

为了方便管理，Django 将项目主要的业务逻辑和功能以模块化的方式（Django App）进行组织，一般用户自定义的应用位于项目目录下某个单独的文件夹中。
这些 App 可以在 settings.py 文件中进行启用或禁用：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

从上面的代码中可以看到，任何一个初始的 Django 项目默认已经开启了一个基本的“后台管理系统”（django.contrib.admin），可以对项目关联的数据库进行基本的增删改查操作。

该 admin 应用的路由定义在 urls.py 文件中：

from django.contrib import admin
from django.urls import path

urlpatterns = [
    path('admin/', admin.site.urls),
]

数据库迁移操作完成后，启动测试服务，即可访问 http://127.0.0.1:8000/admin 进入后台管理系统：

django admin

此时用于登录的后台管理员还未创建，可以使用 python manage.py createsuperuser 命令生成管理员账户：

$ python manage.py createsuperuser
用户名 (leave blank to use 'starky'):
电子邮件地址:
Password:
Password (again):
Superuser created successfully.

登录成功后效果如下：