使用 Django 构建社交网络 - 第 1 部分

• 项目概况
  • 用户到用户连接的配置文件
  • 基于文本的内容
• 先决条件
• 第 1 步：设置基础项目
  • 创建虚拟环境并安装 Django
  • 创建一个 Django 项目和应用程序
  • 自定义 Django 管理界面
  • 为您的应用创建用户
• 第 2 步：扩展 Django 用户模型
  • 创建配置文件模型
  • 在用户管理页面中显示配置文件信息
• 第 3 步：实施保存后挂钩
  • 使用信号协调用户和配置文件
  • 通过错误驱动的开发添加功能
  • 使用装饰器重构代码
  • 在您的管理员中确认自动关联
• 结论
• 使用 Django 构建基本社交网络的后续步骤

在这个由四部分组成的教程系列中，您将使用 Django 构建一个可以在您的作品集中展示的社交网络。该项目将加强您对 Django 模型之间关系的理解，并向您展示如何使用表单，以便用户可以与您的应用程序以及彼此进行交互。您还将学习如何使用 Bulma CSS 框架使您的网站看起来不错。

在本教程系列的第一部分中，您将学习如何：

• 实现Django模型之间的一对一和多对多关系
• 使用自定义模型扩展 Django用户模型Profile
• 自定义Django 管理界面

完成本系列的第一部分后，您将进入第二部分，您将在其中学习集成Bulma来为您的应用设置样式并实现前端界面和逻辑，以便您的用户可以相互关注和取消关注.

您可以通过单击下面的链接并转到文件夹来下载该项目第一部分的代码source_code_final/：

项目概况

在本节中，您将对要构建什么以及为什么要以这种方式构建它有一个坚实的概念。您还将深入研究您将实施的数据库关系，并且您将提出一个完整的项目大纲，准备就绪。简而言之，您将留出一些时间来集思广益您的项目想法。

制定计划后，您将开始本系列第一部分的实际实施步骤，该部分侧重于 Django 模型及其关系：

要深入了解如何通过本系列的所有四个部分来构建 Django 社交网络，您可以展开下面的可折叠部分：

您可能渴望开始编程，但在开始从事任何编码项目之前，考虑一下您想要构建的结构会有所帮助。

您可以使用伪代码、书面规范、数据库图表、笔记本涂鸦或任何感觉可以访问并帮助您思考的东西。不要跳过这部分！这是构建任何项目的重要步骤。您在规划上投入的时间将大大减少您的实施时间。

那么，社交网络需要什么？在最基本的形式中，您需要两件事：

1. 允许人们相互联系的用户对用户连接
2. 内容创建和显示功能，以便您的用户可以为其连接的用户创建输出以查看

您可以将这两个主题视为彼此独立的主题，但您的社交网络需要它们两者才能按预期运行。

在上图中，您可以看到实体关系 (ER) 图的草稿，显示每个用户都将拥有一个完整的个人资料，并且这些个人资料可以不对称地相互跟随。

该图并不旨在完美或完整。对于您自己的过程，也许您会想在一张纸上勾勒出一些稍微不同的东西。您正在集思广益，因此请使用最适合您的格式。

基于文本的内容

除了建立用户之间的关系外，您的平台还需要一种用户创建和共享内容的方式。内容可以是任何东西。它可以包括图像、文本、视频、网络漫画等。

在此项目中，您将构建一个社交网络，用于处理基于有限字符文本的消息，类似于Twitter。因为您将使用 Django Web 框架来制作它，所以它将带有流行的名称Dwitter。

您的 Dwitter 网络将需要一个模型来存储用户可以创建的基于文本的消息，您将其称为dweets。您将只记录有关每个 dweet 的三条信息：

1. 谁写的
2. 消息说什么
3. 当用户写它时

您只需要为Dweet模型定义一种关系，即它与内置User模型的连接：

第 1 步：设置基础项目

此时，您知道您将构建什么并且您了解您将实现的数据库关系。在这一步结束时，您将设置一个 Django 项目并编辑 Django 管理界面以允许创建集中且简约的用户。

您将依次处理几个步骤：

1. 创建虚拟环境并安装Django
2. 创建一个 Django项目和应用程序
3. 自定义 Django管理界面
4. 为您的应用创建用户

在做任何其他事情之前，您将首先创建一个虚拟环境并安装 Django。

$ mkdir django-social
$ cd django-social

$ python3 -m venv venv --prompt=social
$ source ./venv/bin/activate
(social) $ python -m pip install django==3.2.5

(social) $ django-admin startproject social .
(social) $ python manage.py startapp dwitter

# social/settings.py

# ...

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

自定义 Django 管理界面

Django 的内置管理界面是管理应用程序的强大工具，您将在本教程中使用它来处理用户创建和管理。

为了让您的管理界面体验专注于基本要素，您将应用一些自定义。在此之前，您将查看默认状态。您需要设置 Django 的默认 SQLite 数据库并创建一个超级用户，以便您可以登录到 Django 管理门户：

(social) $ python manage.py migrate
(social) $ python manage.py createsuperuser
Username: admin
Email address: admin@example.com
Password:
Password (again):

运行这两个命令并输入超级用户帐户的信息后，您可以启动 Django 的开发服务器：

(social) $ python manage.py runserver

导航到/adminlocalhost 上端口 8000 的 URL 并登录到管理门户：

您可以看到Groups和Users的默认模型条目。这些来自 Django 的内置身份验证和用户管理应用程序。如果您还不熟悉它们，请随意环顾四周。

里面有很多！但是，您希望使该项目尽可能接近基础，以关注模型关系和社交网络的内容。

为了简化您的管理员，您可以减少一些事情：

1. 您不会使用 Django 的Groups，因此您可以将它从您的管理视图中完全删除。
2. 在 Django 中创建用户的最基本方法是只传递一个用户名。您也可以从用户模型显示中删除所有其他字段。

首先注销Group模型，这会从您的管理界面中删除该模型：

# dwitter/admin.py

from django.contrib import admin
from django.contrib.auth.models import Group

admin.site.unregister(Group)

要取消注册Group，首先将其从django.contrib.auth.models. 然后，使用.unregister()将其从您的管理显示中删除。

接下来，您将更改 Django 内置User模型的管理部分中显示的字段。为此，您需要先取消注册它，因为该模型默认已注册。然后，您可以重新注册默认User模型以限制 Django 管理员应显示的字段。为此，您将使用自定义UserAdmin类：

 1# dwitter/admin.py
 2
 3from django.contrib import admin
 4from django.contrib.auth.models import User, Group
 5
 6class UserAdmin(admin.ModelAdmin):
 7    model = User
 8    # Only display the "username" field
 9    fields = ["username"]
10
11admin.site.unregister(User)
12admin.site.register(User, UserAdmin)
13admin.site.unregister(Group)

将此代码添加到您的admin.py文件可以简化管理站点中显示的内容User，以及创建新用户时需要输入的信息。回顾一下，这是您在不同代码行中所做的事情：

• 第 4 行：添加另一个导入，从中获取内置User模型django.contrib.auth.models。

• 第 6 到 9 行：创建UserAdmin一个基于导入User模型的自定义类。

• 第 9 行：您将管理界面显示的字段限制为仅username，这足以创建一个测试用户。

• 第 11 行：User取消注册默认在管理界面中注册的模型。

• 第 12 行：您再次注册User模型，另外传递UserAdmin您创建的自定义类，该类应用您想要的更改。

如果您现在导航到Home → Authentication and Authorization → Users中的用户概述页面，那么您会注意到您的管理门户显示的信息比以前少得多：

通过设置 Django 管理界面的这些自定义设置，您现在可以通过仅提供用户名来快速为您的应用程序创建测试用户。

为您的应用创建用户

通过单击界面右上角的添加用户按钮导航到主页 → 身份验证和授权 → 用户 → 添加用户。单击此按钮将带您进入默认的 Django 用户模型的用户创建表单：

ER 图显示Profile模型通过以下多对多关系连接到自身。

models.py在您的应用中打开并为您的新模型dwitter编写代码：Profile

 1# dwitter/models.py
 2
 3from django.db import models
 4from django.contrib.auth.models import User
 5
 6class Profile(models.Model):
 7    user = models.OneToOneField(User, on_delete=models.CASCADE)
 8    follows = models.ManyToManyField(
 9        "self",
10        related_name="followed_by",
11        symmetrical=False,
12        blank=True
13    )

通过这种方式设置Profile，您可以将每个配置文件精确地耦合到一个用户：

• 第 4 行：User您导入要扩展的内置模型。

• 第 7 行：定义一个OneToOneField名为 的对象user，表示配置文件与使用 Django 内置用户管理应用程序创建的用户的连接。您还定义了如果关联用户被删除，任何配置文件都将被删除。

• 第 8 到 13 行：ManyToManyField您使用字段 name定义一个对象，该对象follows可以保持与其他用户配置文件的连接。

• 第 10 行：related_name在这一行中，您为字段中的关键字传递了一个值follows，它允许您通过描述性名称从该关系的另一端访问数据条目"followed_by"。

• 第 11 行：您还设置symmetrical为，False以便您的用户可以关注某人而无需他们跟进。

• 第 12 行：最后，您设置blank=True，这意味着您的用户不需要关注任何人。该follows字段可以保持为空。

通过Profile设置，您可以运行 Django 的数据库命令将模型更新传播到您的数据库：

(social) $ python manage.py makemigrations
(social) $ python manage.py migrate

运行makemigrations会创建一个迁移文件，该文件将更改注册到数据库，并将migrate更改应用到数据库。

您现在可以将Profile模型注册到您的管理界面，以便管理员在内置User模型之外显示它：

# dwitter/admin.py

# ...
from .models import Profile

# ...
admin.site.register(Profile)

从您当前的应用程序导入Profile并使用管理界面注册后，您可以重新启动开发服务器：

(social) $ python manage.py runserver

运行后，转到您的管理界面。配置文件显示在DWITTER面板中的User模型下方：

如果您单击Profiles旁边的+ Add，Django 将为您提供一个视图：profile create

您需要选择要与配置文件关联的用户。从下拉列表中选择用户后，您可以单击“保存”来创建您的第一个用户配置文件。之后，配置文件将显示为Follows内的可选对象：

您可以选择新的配置文件对象配置文件对象 (1)并再次单击保存以关注您自己的用户配置文件。

此时，您已经拥有创建配置文件和关注其他配置文件所需的所有功能。然而，当它们如此紧密地连接且信息量极少时，在两个不同的地方展示User和显示可能看起来不方便。Profile通过对管理界面进行更多自定义，您可以改进此设置。

在用户管理页面中显示配置文件信息

在本教程系列中，您将通过管理员处理用户创建。您的每个用户都需要一个用户帐户和一个配置文件，并且这两个需要连接。

您无需在两个不同的地方创建用户及其个人资料，而是通过添加admin inline来自定义您的管理界面，这样您就可以在一个区域中同时编辑两者。

返回以dwitter/admin.py将您的新Profile模型注册为堆叠内联，而不是注册模型的标准方式。您可以使用UserAdmin之前创建的类并通过将相关模型添加为内联来对其进行自定义：

# dwitter/admin.py

# ...

class ProfileInline(admin.StackedInline):
    model = Profile

class UserAdmin(admin.ModelAdmin):
    model = User
    fields = ["username"]
    inlines = [ProfileInline]

admin.site.unregister(User)
admin.site.register(User, UserAdmin)
admin.site.unregister(Group)
# Remove: admin.site.register(Profile)

在此代码片段中，您Profile通过创建ProfileInline和继承自admin.StackedInline. 然后，您可以将其添加ProfileInline为inlines您的UserAdmin.

最后，您还删除了之前Profile单独注册模型的最后一行。

当您进入管理界面时，您会看到个人资料条目已从主页中消失。但是，当您通过“用户”页面导航到一个用户条目时，您会在用户信息旁边看到个人资料信息：

从Profile现在开始的信息与来自 Django 内置模型的信息一起User显示，您将其限制为仅显示用户名字段。

这是一项重大改进，使通过管理界面处理用户更加方便！

但是，您的个人资料名称目前难以解释。您怎么知道Profile 对象 (1)是admin的用户配置文件？如果没有与您的Profile模型相关的描述性信息，这很难猜到。要改变这一点，请返回dwitter/models.py并添加一个.__str__()方法Profile：

# dwitter/models.py

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    follows = models.ManyToManyField(
        "self", related_name="followed_by", symmetrical=False, blank=True
    )

    def __str__(self):
        return self.user.username

通过此添加，您重载了默认.__str__()方法，以便它username从模型的关联实例返回值User。通过重新加载页面检查管理界面中的结果：

在此更改之后，连接到管理员用户的配置文件对象会在关注列表中显示该用户的名称。

但是，到目前为止，您创建的其他用户都没有个人资料。最终，您会希望每个用户都有一个配置文件，其中包含与该用户相关的附加信息。

您可以通过在管理界面中创建一个新的配置文件并通过您的管理内联将其与用户帐户关联来尝试您的模型设置。

在您创建更多具有关联配置文件的用户后，您会看到他们填充了关注列表。您可以选择此列表中显示的一个或多个配置文件。单击“保存”后，该配置文件将开始关注它们。

你能想出如何改进这个过程的想法吗？

由于您希望每个用户始终拥有一个与之关联的个人资料，因此您可以设置 Django 来为您完成这项任务。每次创建新用户时，Django 也应该自动创建合适的用户配置文件。此外，它应该立即与该用户相关联。您可以models.py通过使用信号来实现这一点。

第 3 步：实施保存后挂钩

您现在拥有用户和配置文件，以及一种通过管理界面创建和关联它们的方法。在此步骤结束时，您将连接它们，以便创建新用户将自动创建新配置文件并将一个与另一个相关联。在这一步中，您还将练习解释 Django 的错误消息，并通过错误驱动的开发找到调查和解决挑战的方法。

 1# dwitter/models.py
 2
 3from django.db.models.signals import post_save
 4
 5# ...
 6
 7def create_profile(sender, instance, created, **kwargs):
 8    if created:
 9        user_profile = Profile(user=instance)
10        user_profile.save()
11
12# Create a Profile for each new user.
13post_save.connect(create_profile, sender=User)

def create_profile(sender, instance, created, **kwargs):
    if created:
        user_profile = Profile(user=instance, follows=[instance])
        user_profile.save()

Direct assignment to the forward side of a many-to-many set is prohibited.
Use follows.set() instead.

def create_profile(sender, instance, created, **kwargs):
    if created:
        user_profile = Profile(user=instance)
        user_profile.follows.set(instance)
        user_profile.save()

ValueError at /admin/auth/user/add/
"<Profile: name>" needs to have a value for field "id" before this
many-to-many relationship can be used.

def create_profile(sender, instance, created, **kwargs):
    if created:
        user_profile = Profile(user=instance)
        user_profile.save()
        user_profile.follows.set(instance)
        user_profile.save()

TypeError at /admin/auth/user/add/
'User' object is not iterable

def create_profile(sender, instance, created, **kwargs):
    if created:
        user_profile = Profile(user=instance)
        user_profile.save()
        user_profile.follows.set([instance])
        user_profile.save()

TypeError at /admin/auth/user/add/
TypeError: Field 'id' expected a number but got <User: name>.

def create_profile(sender, instance, created, **kwargs):
    if created:
        user_profile = Profile(user=instance)
        user_profile.save()
        user_profile.follows.set([instance.profile.id])
        user_profile.save()

恭喜！您设置了保存后挂钩，以便新创建的用户自动关注他们自己的个人资料。同样的保存后挂钩也自动创建了配置文件。

在制作此功能时，您还练习了在面对重复的错误消息时保持冷静。当误解发生时，您提高了对 Django 如何与您沟通的理解。

def create_profile(sender, instance, created, **kwargs):
    if created:
        user_profile = Profile(user=instance)
        user_profile.save()
        user_profile.follows.add(instance.profile)
        user_profile.save()

通过此更改，您解决了用户在仪表板上看不到自己的 dweets 的问题。现在，他们的 dweets 将与他们关注的其他所有人一起出现。

此时，您可以保留此代码，但 Django 还提供了一种更优雅的方式来使用装饰器注册信号。在下一节中，您将使用receiver.

 1# dwitter/models.py
 2
 3from django.db.models.signals import post_save
 4from django.dispatch import receiver
 5
 6# ...
 7
 8@receiver(post_save, sender=User)
 9def create_profile(sender, instance, created, **kwargs):
10    if created:
11        user_profile = Profile(user=instance)
12        user_profile.save()
13        user_profile.follows.add(instance.profile)
14        user_profile.save()
15
16# Remove: post_save.connect(create_profile, sender=User)

当您检查用户的更改页面时，您会看到 Django 自动为新用户创建了一个配置文件，并将该配置文件添加到他们关注的配置文件列表中：

使用 Django 构建基本社交网络的后续步骤

现在您已经完成了本系列的第一部分，您可以继续阅读第二部分，您将在其中构建一个使用 Bulma 样式的 Django 前端。在本教程系列的第二部分中，您将为您的用户配置文件构建前端页面并使它们看起来不错。

当您继续处理此项目时，您可以参考本教程系列的这一部分，查阅您在项目概述中起草的计划，并在此过程中更新您的计划。