MongoDB für Hoster #

Diese Seite ist für Systemadministratoren bei einem Hosting-Anbieter, deren Kunden Exponential auf MongoDB betreiben möchten. Sie beantwortet: was MongoDB vom Server und von PHP braucht, wie Sie den Benutzer der Website anlegen, damit sich der Adapter verbinden kann, welche Schritte die Installation über die üblichen hinaus braucht, welche Grenzen Sie einem Kunden nennen sollten, bevor er sich dafür entscheidet, und wie Sie sichern. MongoDB ist die dritte in der offiziellen Reihenfolge. Quellen: Datenbankunterstützung, Kapitel 9.5 und MongoDB als Datenbank.

Inhalt #

1. Was es ist
2. Anforderungen
3. Den Benutzer anlegen
4. Einstellungen und Installation
5. Grenzen, die Sie dem Kunden nennen sollten
6. Backups
7. Zahlen zur Dimensionierung
8. Checkliste
9. Verwandte Seiten

Was es ist #

Der Adapter expMongoDB (lib/ezdb/classes/expmongodb.php) übersetzt die SQL-artigen Aufrufe des Kernels in MongoDB-Operationen find, aggregate, Einfügen, Upsert und Löschen. Er kam mit 6.0.14. Er ist die Wahl für Organisationen, die auf MongoDB standardisiert haben; allen anderen empfiehlt das Projekt zuerst SQLite oder PostgreSQL.

Anforderungen #

Zwei Dinge übersieht man leicht:

• PHP 8.2. Der Rest von Exponential läuft auf 8.0; eine MongoDB-Website braucht 8.2 oder später.
• Die Bibliothek. composer.json schlägt mongodb/mongodb nur vor; fügen Sie sie der Website mit composer require mongodb/mongodb hinzu. Die PECL-Erweiterung allein genügt nicht.

Den Benutzer anlegen #

Der Adapter verbindet sich immer mit mongodb://<user>:<password>@<server>:<port>/<database>, und MongoDB nutzt die Datenbank in der URI als Authentifizierungsdatenbank. Legen Sie den Benutzer in der eigenen Datenbank der Website an:

mongosh --eval '
  db.getSiblingDB("<customer>").createUser({
    user: "<customer>",
    pwd: passwordPrompt(),
    roles: [ { role: "readWrite", db: "<customer>" }, { role: "dbAdmin", db: "<customer>" } ]
  })'

Die Datenbank selbst entsteht beim ersten Schreiben. Ein Benutzer ist auch auf einem Server ohne Zugriffskontrolle nötig: Mit leerem User lehnt der Treiber die URI ab („'default' authentication mechanism requires a username“).

Einstellungen und Installation #

[DatabaseSettings]
DatabaseImplementation=mongodb
Server=localhost
Port=27017
User=<customer>
Password=<the password>
Database=<customer>

1. Installieren Sie über die Konsole oder geben Sie dem Assistenten Zeit: Sein Konfigurationsschritt dauert auf MongoDB ein bis drei Minuten, erhöhen Sie also zuerst request_terminate_timeout von PHP-FPM.

   EXP_INSTALL_DB_PASSWORD='<the password>' php bin/php/console exp:install --apply --db=mongodb \
       --db-host=127.0.0.1 --db-name=<customer> --db-user=<customer> --allow-root-user

2. Legen Sie die Indizes an, auf die sich die Abfragen des Kernels verlassen; ohne sie durchsuchen Abfragen von Teilbäumen und Nachschlagen von URL-Aliasen ganze Collections:

   mongosh "mongodb://<customer>@localhost:27017/<customer>" --file bin/mongodb/create_indexes.js

3. Führen Sie die Cronjobs einmal aus, um den Suchindex aufzubauen: php runcronjobs.php --allow-root-user.

Tipp Nehmen Sie den Schritt mit den Indizes direkt nach der Installation in Ihr Bereitstellungsskript auf. Eine MongoDB-Website ohne ihre Indizes funktioniert, aber langsam, und die Ursache ist von außen nicht offensichtlich.

Grenzen, die Sie dem Kunden nennen sollten #

Aus Grenzen von MongoDB:

• Der Adapter führt nie echtes SQL aus. Handgeschriebenes SQL, das er nicht übersetzen kann, liefert ein leeres Ergebnis und protokolliert eine Warnung (suchen Sie in den Logs nach MONGO TODO). Erweiterungen mit eigenem SQL brauchen vielleicht einen Weg für MongoDB.
• Die tiefe Neuerzeugung von URL-Aliasen nach dem Verschieben von Teilbäumen ist unvollständig; Listen von Rollen und Richtlinien können leer sein, obwohl Berechtigungen durchgesetzt werden; manche Cronjobs sind nicht portiert; eztags ist nicht nutzbar; der Bestellabschluss im Shop und die Zeitplanung von ezflow sind nicht von Anfang bis Ende getestet.
• Der SQL-Abfrage-Cache gilt nicht.
• Es gibt keine SQL-Update-Dateien: Die Upgrade-Prüfung vergleicht Collections und gibt die mongosh-Befehle für fehlende aus.
• In der CI des Projekts ist MongoDB durch Unit-Tests des Adapters abgedeckt; die Live-Tests brauchen laufende Server und gehören nicht zur CI.

Warnung Machen Sie diese Grenzen zum Teil der Tarifbeschreibung oder der Auftragsbestätigung. Ein Kunde, der sich auf eztags oder auf eine Erweiterung mit eigenem SQL verlässt, sollte eine andere Datenbank wählen.

Backups #

mongodump --uri="mongodb://<customer>@localhost:27017/<customer>" --out=/backup/<customer>
mongorestore --uri="mongodb://<customer>@localhost:27017/<customer>" --drop /backup/<customer>

Ein vollständiges Backup enthält außerdem var/storage, settings/override und settings/siteaccess (Backup und Wiederherstellung).

Zahlen zur Dimensionierung #

Die einzigen Zahlen, die das Repository für eine MongoDB-Installation nennt, stehen in Abschnitt 24.1 der Referenz zur MongoDB-Portierung: RAM mindestens 512 MB, empfohlen 2 GB; Festplatte mindestens 2 GB, empfohlen 10 GB. Die Leistung folgt der Anzahl der Anweisungen pro Seite; messen Sie eine echte Website mit php bin/php/console exp:benchmark (Speicher, CPU und Festplatte dimensionieren).

Checkliste #

• To do: PHP 8.2 oder später für die Website, im Web und auf der Kommandozeile.
• To do: PECL mongodb 1.18 oder später, und mongodb/mongodb im Composer-Projekt der Website verlangt.
• To do: MongoDB-Server 6.0 oder später.
• To do: Ein Benutzer mit readWrite und dbAdmin in der eigenen Datenbank der Website.
• To do: bin/mongodb/create_indexes.js nach der Installation ausgeführt.
• To do: Die Grenzen dem Kunden mitgeteilt.
• To do: Backups mit mongodump geplant und eine Wiederherstellung getestet.

Verwandte Seiten #

• Datenbanken in der offiziellen Reihenfolge
• Datenbankunterstützung: MongoDB
• Kapitel 9.5: MongoDB
• MongoDB als Datenbank
• Datenbank-Backups je Engine
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.