Signatur
Beschreibung
mysql_get_client_info() liefert die Versionskennung der verwendeten MySQL-Clientbibliothek (libmysql bzw. mysqlnd), die PHP intern nutzt, um mit MySQL-Servern zu kommunizieren. Der Rückgabewert ist ein reiner String wie z. B. mysqlnd 5.0.12-dev oder 5.6.50.
Die Funktion ist nützlich, um zu prüfen, welche Client-Version auf dem Server installiert ist – etwa für Diagnose- oder Kompatibilitätsprüfungen. Anders als mysql_get_server_info() benötigt sie keine aktive Datenbankverbindung und kann daher auch ohne vorherigen mysql_connect()-Aufruf verwendet werden.
Wichtig: Die gesamte ext/mysql-Erweiterung ist seit PHP 5.5.0 als veraltet markiert (deprecated) und wurde in PHP 7.0.0 vollständig entfernt. Für neue Projekte sollte ausschließlich mysqli oder PDO_MySQL verwendet werden.
Rückgabewert
mysqlnd 5.0.12-dev - 20150407.Beispiele
Client-Version ausgeben (ohne Verbindung)
<?php
// Keine Datenbankverbindung nötig
$clientInfo = mysql_get_client_info();
echo 'MySQL-Clientbibliothek: ' . $clientInfo;
?>
Kompatibilitätsprüfung der Client-Version
<?php
$info = mysql_get_client_info();
// Prüfen, ob mysqlnd verwendet wird
if (stripos($info, 'mysqlnd') !== false) {
echo 'Native MySQL-Treiber (mysqlnd) wird verwendet.' . PHP_EOL;
} else {
echo 'Externe libmysql wird verwendet: ' . $info . PHP_EOL;
}
?>
// Wichtig · Fallstricke
Deprecation-Hinweis: Die gesamte ext/mysql-Erweiterung (einschließlich mysql_get_client_info()) wurde in PHP 5.5.0 als veraltet markiert und in PHP 7.0.0 vollständig entfernt. Code, der diese Funktion verwendet, ist nicht mehr lauffähig unter PHP 7+.
Als Ersatz sollte mysqli_get_client_info() (aus der mysqli-Erweiterung) oder die Konstante PDO::ATTR_CLIENT_VERSION (bei PDO) verwendet werden. Auch mysqli_get_client_version() steht als numerische Variante zur Verfügung.