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

发表于 | 分类于 | | 阅读次数:
字数统计: 4.7k | 阅读时长 ≈ 0:05

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 文件夹，结构如下：

1
2
3
4
5
6
7
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 站点即搭建成功：

1
2
3
4
5
6
7
8
9
10
$ 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 访问权限：

1
2
3
4
5
6
7
8
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 配置文件中：

1
2
3
4
5
6
7
...
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
...

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

1
2
3
4
5
6
7
8
9
10
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'HOST': '127.0.0.1',
        'NAME': 'django',
        'PASSWORD': 'password',
        'PORT': '3306',
        'USER': 'admin',
    }
}

安装 Python 操作 MySQL 的依赖库：

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$ 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 文件中进行启用或禁用：

1
2
3
4
5
6
7
8
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 文件中：

1
2
3
4
5
6
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 命令生成管理员账户：

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

登录成功后效果如下：
django admin
django

即无需编写任何业务代码，只搭建 Django 环境即可生成一个基本的“后台管理系统”。

参考资料

Beginning Django