PHP-Erweiterungen je Engine #

Diese Seite richtet sich an Datenbankadministratoren, die vor einer Exponential-Installation einen Server vorbereiten oder den PHP-Build eines Hosters prüfen. Sie beantwortet: welche PHP-Erweiterung jede Engine braucht, woher Sie sie bekommen, wie die Installer sie prüfen und wie Sie sicherstellen, dass jedes PHP, das die Datenbank berührt, sie hat. Quelle: Datenbankunterstützung, PHP-Erweiterungen und settings/setup.ini.

Inhalt #

1. Eine Erweiterung je Engine
2. Wie der Einrichtungsassistent prüft
3. Mehrere PHPs auf einem Server
4. MongoDB: Erweiterung und Bibliothek
5. Oracle: oci8 und der Client
6. Checkliste

Eine Erweiterung je Engine #

Installieren Sie nur die, die Ihre Website verwendet. Jeder Treiber bricht früh ab, wenn seine Erweiterung fehlt; der SQLite-Treiber zum Beispiel protokolliert "SQLite3 extension was not found, the DB handler will not be initialized." (9.2).

Wie der Einrichtungsassistent prüft #

settings/setup.ini definiert einen kritischen Test:

[database_extensions]
Extensions=sqlite3;mysqli;pgsql;mongodb;oci8
Require=one

Der Test besteht, wenn mindestens eine davon geladen ist. Der optionale Test database_all_extensions listet die fehlenden; er dient nur der Information. Fehlt sqlite3, wählt der Assistent die erste Datenbank, deren Erweiterung geladen ist, und sagt das. Oracle bietet der Assistent nur an, wenn oci8 geladen und extension/ezoracle vorhanden ist.

Mehrere PHPs auf einem Server #

Das PHP, das die Website ausliefert, und das PHP auf der Kommandozeile werden getrennt konfiguriert, und Velocity kann noch ein weiteres Binary ausführen. Prüfen Sie jedes:

php -m | grep -iE 'sqlite3|pgsql|mysqli|mongodb|oci8'      # the command line PHP
php --ri sqlite3 | grep -i library                           # the SQLite library version (3.33 or later)

Für das PHP des Webservers öffnen Sie Setup > Systeminformationen: Die Karte PHP nennt die SAPI, und die Karte Datenbank zeigt die Treiberklasse, die geantwortet hat (Systeminformationen). Dieselbe Seite, über den Port von Velocity geöffnet, meldet das PHP von Velocity. Auf einem Plesk- oder cPanel-Server hat jede PHP-Version ihre eigene php.ini und ihre eigene Modulliste; siehe PHP-Auswahl und FPM-Pools.

Cronjobs und Konsolenbefehle verwenden das PHP der Kommandozeile. Eine Website, deren Seiten funktionieren, deren Cronjobs aber mit fehlendem Treiber scheitern, hat die Erweiterung meist nur in PHP-FPM.

MongoDB: Erweiterung und Bibliothek #

Der Adapter expMongoDB verwendet die PECL-Erweiterung mongodb und den MongoDB\Client der Bibliothek. composer.json schlägt die Bibliothek nur vor, eine einfache Installation hat sie also nicht. Ohne sie lautet der Fehler Class "MongoDB\Client" not found (12.10). Anforderungen:

• PHP 8.2 oder neuer (der einzige Treiber mit einer höheren Untergrenze als PHP 8.0).
• Erweiterung mongodb 1.18 oder neuer.
• Bibliothek mongodb/mongodb; die CI installiert ^1.21 || ^2.0.

Oracle: oci8 und der Client #

oci8 muss gegen einen Oracle-Client gebaut sein. Der Instant Client genügt, und ORACLE_HOME wird damit nicht gebraucht. Setzen Sie LD_LIBRARY_PATH (und TNS_ADMIN für TNS-Aliase) nur, wenn der Client außerhalb des Bibliothekspfads des Systems liegt, und dann auch im PHP-FPM-Pool (env[...]) und in der Umgebung von Velocity, weil jeder Prozess sie einmal liest (9.6). Die php.ini-Einstellungen oci8.persistent_timeout, oci8.max_persistent und oci8.ping_interval steuern persistente Verbindungen und lassen sich zur Laufzeit nicht ändern (Oracle: persistente Verbindungen, DRCP und Tuning).

Checkliste #

• To do: Die Erweiterung der gewählten Engine ist im PHP des Webservers geladen.
• To do: Dieselbe Erweiterung ist im PHP der Kommandozeile geladen (Cronjobs, Konsole).
• To do: Unter Velocity ist dieselbe Erweiterung im PHP von Velocity geladen.
• To do: SQLite: Die Bibliothek in PHP ist 3.33 oder neuer.
• To do: MongoDB: PHP 8.2+, Erweiterung 1.18+, Bibliothek mongodb/mongodb installiert.
• To do: Oracle: oci8 passt zur PHP-Version; die Client-Bibliotheken werden von jedem Prozess gefunden.
• To do: Erweiterungen für Engines, die die Website nicht verwendet, sind nicht installiert.

Verwandte Seiten #

• Unterstützte Engines und Versionen
• PHP-Versionen und -Erweiterungen (für Hosting-Unternehmen)
• Kapitel 2, Anforderungen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.