Signatur
Beschreibung
Die Klasse mysql_xdevapi\Driver ist Teil der MySQL X DevAPI-Erweiterung für PHP und bietet Zugriff auf Informationen über den verwendeten X DevAPI-Treiber. Sie ist typischerweise nicht direkt instanziierbar, sondern stellt statische Methoden oder Eigenschaften bereit, über die Treiberdetails wie Versions- und Fähigkeitsinformationen abgerufen werden können.
Die X DevAPI ist Bestandteil der MySQL Shell-Architektur und ermöglicht dokumentenorientierte sowie relationale Datenbankoperationen über das X Protocol. Die Driver-Klasse dient dabei als Einstiegspunkt zur Treiberintrospection, etwa um zu prüfen, welche Fähigkeiten der Treiber unterstützt.
Die Klasse gehört zum Namensraum mysql_xdevapi, der durch die PECL-Erweiterung mysql_xdevapi bereitgestellt wird. Sie wird üblicherweise in Verbindung mit mysql_xdevapi\getSession() genutzt, um Verbindungen zu einem MySQL-Server über das X Protocol aufzubauen.
Hinweis: Der direkte Einsatz der Driver-Klasse ist in der Praxis selten notwendig. Sie richtet sich primär an Entwickler, die Treiberinformationen für Diagnosezwecke oder Kompatibilitätsprüfungen benötigen.
Beispiele
Treiberinformationen über den X DevAPI-Treiber abrufen
<?php
// Voraussetzung: PECL-Erweiterung mysql_xdevapi ist installiert und geladen
if (class_exists('mysql_xdevapi\\Driver')) {
$driverInfo = new mysql_xdevapi\Driver();
// Ausgabe von verfügbaren Methoden/Eigenschaften
$methods = get_class_methods($driverInfo);
echo "Verfügbare Methoden im Driver:" . PHP_EOL;
foreach ($methods as $method) {
echo ' - ' . $method . PHP_EOL;
}
} else {
echo 'mysql_xdevapi\\Driver ist nicht verfügbar.' . PHP_EOL;
}Verbindung über getSession und Treiberkontext prüfen
<?php
// Verbindung zu einem MySQL-Server über das X Protocol
try {
$session = mysql_xdevapi\getSession('mysqlx://root:password@localhost');
echo 'Verbindung erfolgreich hergestellt.' . PHP_EOL;
// Prüfen, ob Driver-Klasse vorhanden ist
if (class_exists('mysql_xdevapi\\Driver')) {
echo 'X DevAPI Driver-Klasse ist verfügbar.' . PHP_EOL;
}
$session->close();
} catch (Exception $e) {
echo 'Fehler: ' . $e->getMessage() . PHP_EOL;
}// Wichtig · Fallstricke
Verfügbarkeit: Die Klasse mysql_xdevapi\Driver ist nur verfügbar, wenn die PECL-Erweiterung mysql_xdevapi installiert und in der php.ini geladen ist (extension=mysql_xdevapi). Diese Erweiterung ist nicht standardmäßig in PHP enthalten.
X Protocol-Voraussetzung: Der MySQL-Server muss das X Plugin aktiviert haben (Standardport 33060). Ohne aktives X Plugin kann keine Verbindung über die X DevAPI hergestellt werden.
Experimenteller Status: Die mysql_xdevapi-Erweiterung galt lange als experimentell. API-Änderungen zwischen PECL-Versionen sind möglich. Es empfiehlt sich, stets die aktuelle offizielle Dokumentation zu konsultieren.