Django如何配置MongoDB

Lucas在澳洲

已于 2024-10-24 19:19:47 修改

阅读量1.9k

点赞数 4

分类专栏：后端Django Python 文章标签： mongodb django 数据库 1024程序员节

于 2023-05-29 13:02:43 首次发布

本文链接：https://blog.youkuaiyun.com/weixin_50153843/article/details/130926036

版权

Python 同时被 2 个专栏收录

69 篇文章

订阅专栏

后端Django

26 篇文章

订阅专栏

在Django中配置和使用MongoDB的详细指南

Django通常与关系型数据库（如MySQL、PostgreSQL和SQLite）一起使用，但在某些情况下，您可能需要使用非关系型数据库，如MongoDB。MongoDB是一个文档型数据库，具有良好的灵活性和可扩展性。本文将详细探讨如何在Django中配置和使用MongoDB。

步骤1：安装MongoDB

首先，您需要在您的计算机上安装MongoDB。以下是安装MongoDB的链接和简要步骤：

安装教程：访问 MongoDB安装文档。
Windows用户：可以通过MongoDB官网下载并安装Windows版MongoDB。

macOS用户：可以使用Homebrew安装：

brew tap mongodb/brew
brew install mongodb-community

Linux用户：可以使用包管理器进行安装，例如在Ubuntu上：
```
sudo apt update
sudo apt install -y mongodb
```

安装完成后，确保MongoDB服务正在运行。可以通过运行以下命令进行测试：

mongo --eval 'db.runCommand({ ping: 1 })'

如果MongoDB正常运行，您将看到返回结果为：

{ "ok" : 1 }

步骤2：安装Django和djongo

在Django项目中，我们需要使用djongo库来连接MongoDB。首先，确保您已经安装了Django。如果还没有安装，可以使用以下命令：

pip install django

接下来，安装djongo：

pip install djongo

步骤3：配置Django的settings.py文件

在Django项目的settings.py文件中，您需要添加MongoDB的数据库配置。将以下代码添加到settings.py中的DATABASES字典中：

DATABASES = {
    'default': {
        'ENGINE': 'djongo',
        'NAME': 'mydatabase',  # 要使用的数据库名
        'HOST': 'localhost',    # MongoDB服务器的地址
        'PORT': 27017,          # MongoDB服务器的端口号
        'AUTH_SOURCE': 'admin', # 认证数据库的名称
        'USERNAME': 'mydatabaseuser',  # 认证用户的名称
        'PASSWORD': 'mypassword',       # 认证用户的密码
    }
}

配置说明：

ENGINE: 指定使用djongo作为Django的数据库引擎。
NAME: 指定要使用的MongoDB数据库名称。
HOST: 指定MongoDB服务器的地址（通常为localhost）。
PORT: MongoDB的默认端口为27017。
AUTH_SOURCE: 指定用于认证的数据库（通常为admin）。
USERNAME: 用于认证的MongoDB用户名。
PASSWORD: 用于认证的MongoDB用户密码。

步骤4：定义MongoDB模型

在Django中，我们通常会定义一个模型类来对应MongoDB中的文档。模型类需要继承自djongo.models.Model，而不是传统的django.db.models.Model。以下是一个示例代码：

from djongo import models

class Person(models.Model):
    name = models.CharField(max_length=50)
    age = models.IntegerField()
    email = models.EmailField()

    class Meta:
        # MongoDB中集合的名称
        db_table = 'person'

    def __str__(self):
        return self.name

在这个示例中，我们定义了一个名为Person的模型，其中包含了name、age和email字段。这些字段将对应MongoDB中的文档属性。

步骤5：编写视图函数

接下来，我们需要在Django的视图中查询MongoDB数据库中的数据。您可以在views.py中定义一个视图函数，例如：

from django.shortcuts import render
from .models import Person

def show_person(request):
    # 查询所有Person对象
    persons = Person.objects.all()
    return render(request, 'show_person.html', {'persons': persons})

在这个视图函数中，我们通过Person.objects.all()查询了所有的Person对象，并将它们传递给模板。

步骤6：创建模板

接下来，您需要创建一个模板来显示查询结果。在templates目录下创建一个名为show_person.html的文件，并添加以下代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Show Persons</title>
</head>
<body>
    <h1>Persons List</h1>
    {% for person in persons %}
        <p>{{ person.name }} ({{ person.age }}) - {{ person.email }}</p>
    {% empty %}
        <p>No persons found.</p>
    {% endfor %}
</body>
</html>

在这个模板中，我们使用了Django的模板语言来遍历所有Person对象，并显示它们的name、age和email字段。

步骤7：配置URL

现在，我们需要将视图函数与URL关联。打开urls.py文件并添加以下代码：

from django.urls import path
from .views import show_person

urlpatterns = [
    path('persons/', show_person, name='show_person'),
]

步骤8：运行应用

完成上述步骤后，您可以启动Django开发服务器：

python manage.py runserver

在浏览器中访问http://127.0.0.1:8000/persons/，如果MongoDB运行正常，并且应用配置和代码正确，您将看到所有Person对象的信息。

额外功能

创建和保存文档

您还可以通过视图函数将新文档保存到MongoDB中。例如，您可以创建一个视图处理POST请求来添加新人员信息：

from django.http import HttpResponseRedirect
from django.urls import reverse

def add_person(request):
    if request.method == "POST":
        name = request.POST.get('name')
        age = request.POST.get('age')
        email = request.POST.get('email')
        Person.objects.create(name=name, age=age, email=email)
        return HttpResponseRedirect(reverse('show_person'))
    return render(request, 'add_person.html')

在这个函数中，我们通过Person.objects.create()方法将新人员信息存储到MongoDB中。

创建添加模板

您还需要创建一个表单来添加新人员信息。在templates目录下创建add_person.html：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Add Person</title>
</head>
<body>
    <h1>Add Person</h1>
    <form method="post">
        {% csrf_token %}
        <label for="name">Name:</label>
        <input type="text" id="name" name="name" required><br>

        <label for="age">Age:</label>
        <input type="number" id="age" name="age" required><br>

        <label for="email">Email:</label>
        <input type="email" id="email" name="email" required><br>

        <input type="submit" value="Add">
    </form>
</body>
</html>

更新URL配置

在urls.py中添加新视图的路径：

from .views import add_person

urlpatterns = [
    path('persons/', show_person, name='show_person'),
    path('add-person/', add_person, name='add_person'),
]

总结

本文详细介绍了如何在Django中配置和使用MongoDB，包括安装MongoDB、安装和配置djongo、定义模型、创建视图和模板等。通过这些步骤，您可以在Django应用中灵活地使用MongoDB来存储和查询数据。MongoDB与Django的结合为您的应用提供了更高的灵活性和扩展性。希望这篇指南能帮助您更好地理解在Django中使用MongoDB的过程！如有其他问题，请随时询问。