如何创建Django应用程序并将其连接到数据库

介绍

Django 是一个用 Python 编写的免费开源 Web 框架。该工具允许可扩展性、可重用性和快速开发。

在本教程中，您将学习如何为连接到 MySQL 数据库的博客网站设置初始基础。这将涉及使用 django-admin 创建博客 Web 应用程序的骨架结构，创建 MySQL 数据库，并将 Web 应用程序连接到数据库。

Django 将为您提供一个开发环境来处理您的博客 Web 应用程序，但您需要采取更多步骤才能使您的博客在互联网上上线。

先决条件

要完成本教程，您需要：

具有非 root sudo 启用用户和防火墙的 Ubuntu 20.04 服务器。按照我们的 Ubuntu 20.04 初始服务器设置指南。
安装 MySQL 作为数据库。按照我们关于如何在 Ubuntu 20.04 上安装 MySQL 的教程进行操作。
一个 Python 环境设置。为此，请按照我们关于如何在 Ubuntu 20.04 服务器上安装 Python 3 和设置编程环境的教程进行操作。

安装并设置好所有内容后，您可以继续进行第一步。

第 1 步 — 创建数据库

Django 支持许多流行的数据库管理系统，但本指南侧重于将 Django 连接到 MySQL 数据库。为此，您需要在 MySQL 实例上创建一个数据库，以及一个 MySQL 用户配置文件，Django 可以使用该配置文件连接到数据库。

要进行此设置，请使用以下命令以 root MySQL 用户身份连接到您的 MySQL 数据库：

sudo mysql

当提示更改时，您将知道您在 MySQL 服务器中：

使用以下命令检查当前数据库：

SHOW DATABASES;

假设您尚未创建任何数据库，您将收到类似于以下内容的输出：

Output+--------------------+
| Database          |
+--------------------+
| information_schema |
| mysql             |
| performance_schema |
| sys               |
+--------------------+
4 rows in set (0.00 sec)

默认情况下，您将创建 4 个数据库：information_schema、MySQL、performance_schema 和 sys。你不需要接触这些，因为它们包含对 MySQL 服务器本身很重要的信息。

相反，创建将保存您的博客数据的初始数据库。

要在 MySQL 中创建数据库，请运行以下命令，并为您的数据库使用有意义的名称：

CREATE DATABASE blog_data;

成功创建数据库后，您将收到以下输出：

OutputQuery OK, 1 row affected (0.00 sec)

注意： 您可能会收到以下错误：

OutputERROR 1007 (HY000): Can't create database blog_data; database exists

这表明名为 blog_data 的数据库已经存在。

如果您收到以下 MySQL 错误，则表示存在 MySQL 语法错误。验证您输入的命令是否与本教程中显示的完全一致：

OutputERROR 1064 (42000): You have an error in your SQL syntax;

验证数据库现在是否列为可用数据库之一：

SHOW DATABASES;

blog_data 数据库现在应该列在输出中包含的数据库中：

Output+--------------------+
| Database          |
+--------------------+
| information_schema |
| blog_data         |
| mysql                 |
| performance_schema |
| sys               |
+--------------------+
5 rows in set (0.00 sec)

接下来，创建一个单独的 MySQL 用户帐户，Django 将使用该帐户来操作新数据库。创建特定的数据库和帐户可以从管理和安全的角度为您提供支持。我们将在本指南中使用名称 djangouser，但您可以随意使用与您相关的任何名称。

您将创建此帐户、设置密码并授予对您创建的数据库的访问权限。首先，通过键入以下命令创建用户并设置其密码。请记住为您的数据库选择一个强密码来替换此示例中的 password：

CREATE USER 'djangouser'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';

让数据库知道 djangouser 应该可以完全访问您设置的数据库：

GRANT ALL ON blog_data.* TO 'djangouser'@'localhost';

您现在有一个数据库和用户帐户，每个都是专门为 Django 制作的。刷新权限，以便 MySQL 的当前实例知道您最近所做的更改：

FLUSH PRIVILEGES;

完成后，您可以通过键入 EXIT; 或按 CTRL + D 退出 MySQL 服务器。

第 2 步 — 创建 MySQL 选项文件

您可以将它们存储在选项文件中，而不是在 Django 配置文件中指定 MySQL 连接详细信息。许多 MySQL 程序可以读取选项文件（也称为配置文件）以获取启动选项或连接详细信息等信息。这很方便，因为您只需将数据库登录凭据存储在一个地方。

使用您喜欢的文本编辑器打开 my.cnf 配置文件以更新您的 MySQL 凭据。这里我们将使用 nano：

sudo nano /etc/mysql/my.cnf

添加以下行并包含您的相关信息：

/etc/mysql/my.cnf

…

[client]
database = blog_data
user = djangouser
password = your_actual_password
default-character-set = utf8

你会注意到 utf8 被设置为默认编码，这是在 MySQL 中编码 unicode 数据的常用方法。当您确定您的详细信息正确时，保存并关闭文件。如果您使用 nano 编辑文件，您可以按 CTRL + X 然后按 Y 确认更改。

编辑文件后，您需要重新启动 MySQL 以使更改生效：

sudo systemctl daemon-reload
sudo systemctl restart mysql

请注意，重启 MySQL 需要几秒钟，所以请耐心等待。

第 3 步 - 创建初始 Django 项目骨架

在这一步中，您将通过使用 django-admin 命令生成项目骨架来为您的应用程序奠定基础。

导航到您要构建博客应用程序的目录。在该目录中，创建一个特定目录来构建应用程序。将目录命名为对您正在构建的应用程序有意义的内容。例如，我们将命名为 my_blog_app：

mkdir my_blog_app

现在，导航到新创建的目录：

cd my_blog_app

接下来，进入您想用于在 Django 中工作的编程环境。您可以使用现有的，也可以创建一个新的。我们将调用我们的 env，但您应该使用对您有意义的名称：

python3 -m venv env

创建完成后，您可以激活它：

. env/bin/activate

如果您还没有这样做，现在将 Django 安装到这个环境中：

pip install django

在 my_blog_app 目录中，通过运行以下命令生成项目：

django-admin startproject blog

通过导航到 blog/ 目录来验证它是否工作：

cd blog

然后运行 ls 以验证是否在项目文件夹中创建了必要的文件和目录：

ls

输出将列出 blog 目录和 manage.py 文件：

Outputblog manage.py

现在您已经创建了一个包含博客应用程序初始启动的项目目录，您可以继续下一步。

第 4 步 — 安装 MySQL 数据库连接器

为了在您的项目中使用 MySQL，您需要一个与 Django 兼容的 Python 3 数据库连接器库。此步骤概述了如何安装一个这样的数据库连接器 mysqlclient，它是 MySQLdb 的分叉版本。

首先，安装必要的 MySQL 开发头文件和库：

sudo apt install libmysqlclient-dev default-libmysqlclient-dev

接下来，使用 pip 安装 wheel 包。 Wheel 是 Python 中用于安装 Python 包索引中的模块的一种打包格式。从 Wheel 包安装 Python 程序通常比从源代码构建包更快、更节省资源。为了安装和使用打包为轮子的程序，您首先需要确保已安装 wheel 包：

pip install wheel

然后继续安装 mysqlclient：

pip install mysqlclient

您将收到类似于以下内容的输出，验证客户端是否已正确安装：

Output...
Successfully installed mysqlclient-2.1.0

您现在已经使用 PyPi mysqlclient 连接器库成功安装了 MySQL 客户端。

第 5 步 - 编辑设置

当您之前运行 django-admin 时，它为 Django 创建了一个名为 settings.py 的配置文件。您需要更改此文件中的一些默认设置，以使一切正常工作。

要编辑文件，请使用您选择的文本编辑器打开文件的路径：

nano ~/my_blog_app/blog/blog/settings.py

为了让您的博客拥有与您所在地区相关的正确时间，您可以编辑 settings.py 文件，使其使用您当前的时区。您可以使用此时区列表作为参考。对于我们的示例，我们将使用 America/New_York 时间。

在文件中，导航到文件底部附近的 TIME_ZONE 字段：