将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()

   查看输出

   [
     {
       _id: ObjectId('...'),
       nid: 1,
       vid: 1,
       type: 'article',
       uuid: '...',
       langcode: 'en',
       node_all_revisions: [
         {
           ...
         }
       ],
       node_current_revision: [
         {
           ...
         }
       ],
       node_latest_revision: [
         {
           ...
           title: 'Welcome to My Drupal Site',
           created: ...,
           changed: ...,
           promote: true,
           sticky: false,
           default_langcode: true,
           revision_default: true,
           revision_translation_affected: true,
           node_latest_revision__body: [
             {
               bundle: 'article',
               deleted: false,
               langcode: 'en',
               entity_id: 1,
               revision_id: 1,
               delta: 0,
               body_value: '<p>This is my first article on Drupal with MongoDB!<br>All content is stored as JSON documents in MongoDB.</p>',
               body_summary: '',
               body_format: 'basic_html'
             }
           ],
           node_latest_revision__comment: [
             {
               bundle: 'article',
               deleted: false,
               langcode: 'en',
               comment_status: 2,
               entity_id: 1,
               revision_id: 1,
               delta: 0
             }
           ]
         }
       ]
     }
   ]

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