将MongoDB与 Drupal 集成

验证先决条件。

要创建快速入门应用程序，请在开发环境中安装以下软件：

启动MongoDB副本集。

要将MongoDB与 Drupal 结合使用，您必须运行MongoDB副本集。执行以下步骤来准备和启动本地三节点副本集：

1. 增加 ulimit 值以解决系统资源限制问题。

   Drupal 可在短时间内创建多个文件和索引。从终端运行以下命令，将 ulimit设立为 64000，防止副本集崩溃：

   ulimit -n 64000

2. 部署副本集。

   增加ulimit 后，请按照“部署用于测试和开发的自管理副本集”教程中的说明部署和初始化副本集。确保您的副本集名为rs0 ，并且有三个成员在端口27017 、27018 和27019 上运行。

创建数据库用户。

通过执行以下步骤，创建具有 Drupal数据库所需权限的用户。

1. 从终端运行以下命令，连接到 mongosh 中的副本集：

   mongosh "mongodb://localhost:27017,localhost:27018,localhost:27019/?replicaSet=rs0"

2. 在 mongosh Shell中，运行以下命令以进入 admin数据库：

   use admin

3. 然后，从Shell运行以下命令以创建用户：

   db.createUser({
      user: "<database username>",
      pwd: "<database user password>",
      roles: [
        { role: "readWrite", db: "drupal" },
        { role: "dbAdmin", db: "drupal" }
      ]
   })

   将 <database username> 和 <database user password> 替换为您的首选凭证。保存这些值以在将来的步骤中使用。

安装 Drupal。

在新的终端窗口中运行以下命令，创建名为 drupal-quickstart 的 Drupal项目：

composer create-project drupal/recommended-project:11.1.5 drupal-quickstart
cd drupal-quickstart

然后，通过运行以下命令来安装MongoDB模块：

composer require drupal/mongodb:^3.1

应用 Drupal 核心补丁。

Drupal 核心PHP文件需要补丁才能与MongoDB一起使用。导航到 drupal-quickstart/web目录并通过运行以下命令应用补丁：

cd web
git apply -v modules/contrib/mongodb/patches/drupal-core-11.1.5.patch
cd ..

创建设置文件。

从 drupal-quickstart目录导航到 web/sites/default 子目录并运行以下命令：

cd web/sites/default
cp default.settings.php settings.php
chmod 777 settings.php
cd ../../..

这些命令将默认设置文件复制到名为 settings.php 的新文件中，并更新此文件的权限以允许 Drupal写入新内容。

配置文件权限。

要允许 Drupal 修改公共文件，请创建 files目录，并通过从 drupal-quickstart目录运行以下命令来设立其权限：

mkdir -p web/sites/default/files
chmod -R 777 web/sites/default/files

然后，验证 web/sites/default/settings.php文件是否包含以下值，从而指定这些文件的位置：

$settings['file_public_path'] = 'sites/default/files';

启动PHP开发服务器。

在 drupal-quickstart目录中，运行以下命令以启动内置PHP Web服务器：

php -S localhost:8080 -t web

如果成功，此命令将输出以下信息：

[Date Time] PHP 8.3.0 Development Server (http://localhost:8080) started

完成 Web 安装。

在 Web 浏览器中打开 http://localhost: }8080 以启动 Drupal 安装向导。然后，通过选择以下响应来配置您的项目。

$this->ignoreNotImportedAnnotations = (boolean) $bool;

$this->ignoreNotImportedAnnotations = (bool) $bool;

1. 在“选择语言”页面上，选择“英语”，然后单击“保存并继续”。

2. 在“选择配置文件”页面上，保持选择“标准”，然后单击“保存并继续”。

3. 在 设置数据库 页面上，选择 MongoDB 作为数据库类型，并提供以下信息：

   • 数据库名称：drupal

   • 数据库用户名：您在上一个步骤中使用 createUser 命令配置的数据库用户名

   • 数据库密码：您在上一个步骤中使用 createUser 命令配置的数据库密码

   • SRV 连接格式：保持未选中状态

   • 数据库副本集：rs0

   • 托管 #1：localhost，端口 27017

   • 托管 #2：localhost，端口 27018

   • 托管 #3：localhost，端口 27019

   单击保存并继续。

4. Drupal 安装所需的模块。这可能需要几分钟时间。

5. 在“配置站点”页面上，提供以下信息：

   • 站点名称：输入 Drupal on MongoDB。

   • 站点电子邮件地址：输入任何电子邮件地址。您可以使用不存在的解决。

   • 用户名：选择管理员用户名。

   • 密码：选择一个强密码。

   • 接收电子邮件通知：取消选中此框。

   单击保存并继续。

保护您的设置文件。

安装 Drupal 并配置站点后，Drupal 不再需要对设置文件的写入访问权限。要保护这些文件的安全，请从 drupal-quickstart目录运行以下命令：

chmod 555 web/sites/default
chmod 444 web/sites/default/settings.php

查看 Drupal 主页。

安装完成后，您的站点将重定向到 Drupal 主页。您的站点类似于下图：

访问 Drupal 管理界面。

单击页面顶部导航栏中的 Content。然后，单击添加内容>文章。

创建文章。

在 Create Article 页面上，执行以下操作：

1. 在 Title 部分中，输入 "Welcome to My Drupal Site"。

2. 在 Body 部分中，输入以下文本：

   This is my first article on Drupal with MongoDB!
   All content is stored as JSON documents in MongoDB.

3. 选择 Menu settings 并选中 Provide a menu link 复选框。

4. 单击 Save（连接）。

查看您发表的文章。

保存后，就可以看到自己发布的文章了。您的站点类似于下图：

在MongoDB中查看数据。

要验证您的内容是否存储在MongoDB中，请执行以下步骤：

1. 打开新的终端窗口并连接到 mongosh 中的MongoDB副本集。

   从终端运行以下命令：

   mongosh "mongodb://localhost:27017,localhost:27018,localhost:27019/?replicaSet=rs0"

2. 进入 drupal数据库并查看集合。

   在 mongosh 终端中运行以下命令：

   use drupal
   show collections

   Drupal 会创建多个集合来存储不同类型的内容，其中包括：

   • node：存储内容节点

   • users：存储用户帐户

   • config：存储配置数据

3. 查看您的文章数据。

   要查看有关文章的信息，请在 mongosh 终端中运行以下命令：

   db.node.find().pretty()

   查看输出

   此命令会返回一个JSON 文档，其中包含文章文本和元数据。