Start · Sprachen · PHP · Referenz · mysql_get_client_info

mysql_get_client_info

Funktion

Gibt die Versionsinformation der MySQL-Clientbibliothek als Zeichenkette zurück.

seit PHP 4.0.5 Kategorie: db

Signatur

mysql_get_client_info(): string

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

Typ
string
Beschreibung
Gibt die Versionsinformation der MySQL-Clientbibliothek als Zeichenkette zurück, z. B. 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;
?>
MySQL-Clientbibliothek: mysqlnd 5.0.12-dev - 20150407 - $Id$

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;
}
?>
Native MySQL-Treiber (mysqlnd) wird verwendet.

// 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.