Die mysqli Extension wurde in PHP 5.0.0 eingeführt; der MySQL Native Treiber mit PHP 5.3.0.
Die üblichen Unix-Distributionen enthalten Binärversionen von PHP, die installiert werden können. Obwohl diese Binärversionen typischerweise mit Unterstützung für die MySQL Extensions erstellt wurden, müssen möglicherweise die Extension-Bibliotheken selbst unter Verwendung eines zusätzlichen Pakets installiert werden. Die Paketverwaltung der gewählten Distribution ist auf Verfügbarkeit zu prüfen.
Beispielsweise installiert unter Ubuntu das php5-mysql Paket die PHP Extensions ext/mysql, ext/mysqli und pdo_mysql. Unter CentOS installiert das php-mysql Paket ebenfalls diese drei Extensions.
Alternativ kann diese Extension auch selbst kompiliert werden. Das Kompilieren von PHP aus den Quellen erlaubt die Auswahl der MySQL Extensions, die verwendet werden sollen, sowie die Wahl der Client-Bibliothek für jede Extension.
Der MySQL-Native-Treiber wird empfohlen, da er zu einer verbesserten Performance führt und Zugriff auf Funktionen gewährt, die bei der Verwendung der MySQL-Client-Bibliothek nicht zur Verfügung stehen. Lesen Sie Was versteht man unter dem MySQL-Native-Treiber von PHP?, um einen kurzen Überblick über die Vorteile des MySQL-Native-Treibers zu erhalten.
/path/to/mysql_config stellt den Pfad des mysql_config Programms dar, das mit MySQL Server ausgeliefert wird.
| PHP Version | Standard | Konfigurationsoptionen: mysqlnd | Konfigurationsoptionen: libmysqlclient | Changelog |
|---|---|---|---|---|
| 5.4.x | mysqlnd | --with-mysqli | --with-mysqli=/path/to/mysql_config | mysqlnd ist nun standardmäßig aktiviert |
| 5.3.x | libmysqlclient | --with-mysqli=mysqlnd | --with-mysqli=/path/to/mysql_config | mysqlnd wird unterstützt |
| 5.0.x, 5.1.x, 5.2.x | libmysqlclient | Nicht verfügbar | --with-mysqli=/path/to/mysql_config | mysqlnd wird nicht unterstützt |
Es ist möglich, MySQL-Erweiterungen und Client-Bibliotheken frei zu mischen. Zum Beispiel ist es denkbar, dass die MySQL-Erweiterung die MySQL-Client-Bibliothek (libmysqlclient) verwendet, während die mysqli-Erweiterung so konfiguriert ist, dass sie den MySQL-Native-Treiber verwendet. Alle Kombinationen von Erweiterungen und Client-Bibliotheken sind möglich.
Unter Windows wird PHP in der Regel durch den Binärinstaller installiert.
Unter Windows gilt für die PHP-Versionen 5.3 und neuer, dass die mysqli-Erweiterung standardmäßig aktiviert ist, und den MySQL-Native-Treiber verwendet. Das bedeutet, dass Sie sich keine Gedanken über die Konfiguration des Zugriffs auf die libmysql.dll machen brauchen.
Unter diesen alten, nicht mehr unterstützten PHP-Versionen (die Unterstützung von PHP 5.2 wurde am 6. Januar 2011 eingestellt), sind zusätzliche Konfigurationsschritte notwendig, um mysqli zu aktivieren und die Client-Bibliothek anzugeben, die verwendet werden soll.
Die mysqli-Erweiterung ist standardmäßig nicht aktiviert, daher muss die php_mysqli.dll-DLL in der php.ini aktiviert werden. Um dies zu tun, müssen Sie die php.ini-Datei finden (typischerweise liegt diese unter c:\php) und überprüfen, dass das Kommentarzeichen (ein Semikolon) vom Anfang der Zeile extension=php_mysqli.dll in der Sektion [PHP_MYSQLI] entfernt wurde.
Wenn Sie die MySQL-Client-Bibliothek mit mysqli verwenden wollen, stellen Sie sicher, dass PHP auf die Bibliothek zugreifen kann. Die MySQL-Client-Bibliothek ist in einer Datei namens libmysql.dll der PHP-Windowsdistribution enthalten. Um sie erfolgreich laden zu können, muss sie innerhalb des Pfades liegen, der von der Windows-Umgebungsvariablen PATH bestimmt wird. Lesen Sie dazu auch den FAQ-Eintrag "Wie füge ich mein PHP-Verzeichnis der PATH-Variablen unter Windows hinzu?", um mehr Informationen darüber zu erhalten. Das Kopieren libmysql.dll in das Windows-Systemverzeichnis (typischerweise c:\Windows\system) funktioniert ebenfalls, da das Systemverzeichnis standardmäßig im PATH enthalten ist. Allerdings raten wir von dieser Arbeitsweise stark ab.
Wie bei der Aktivierung jeder anderen PHP-Extension (wie z.B. php_mysqli.dll) sollte auch hier die PHP-Direktive extension_dir auf das Verzeichnis zeigen, in dem die vorhandenen PHP-Extensions liegen. Lesen Sie dazu auch den Abschnitt Manual Windows Installation Instructions. Ein entsprechender extension_dir-Wert für PHP 5 ist zum Beispiel c:\php\ext.
Hinweis:
Wenn beim Starten des Webservers ein Fehler ähnlich dem folgenden auftritt: "Unable to load dynamic library './php_mysqli.dll'", wird im Normalfall die php_mysqli.dll und/oder die libmysql.dll nicht vom System gefunden.