cubrid_version — Funktion · PHP-Referenz

Signatur

cubrid_version(): string

Beschreibung

cubrid_version() liefert die Version des aktuell installierten CUBRID-PHP-Erweiterungsmoduls (nicht die Version des CUBRID-Datenbankservers selbst). Der Rückgabewert ist eine Zeichenkette im Format Major.Minor.Patch, z. B. 11.2.0.0002.

Die Funktion ist nützlich, um zur Laufzeit zu prüfen, welche Modulversion vorliegt – etwa in Diagnoseskripten, beim Deployment oder wenn bestimmte Features erst ab einer bestimmten Modulversion verfügbar sind. Sie benötigt keine aktive Datenbankverbindung und kann daher jederzeit aufgerufen werden.

Zu beachten ist, dass die Modulversion unabhängig von der CUBRID-Serverversion ist. Für die Serverversion sollte stattdessen cubrid_get_server_info() oder eine entsprechende SQL-Abfrage verwendet werden.

Rückgabewert

Typ

string

Beschreibung

Gibt die Versionsnummer des CUBRID-PHP-Moduls als Zeichenkette zurück, z. B. "11.2.0.0002".

Beispiele

Modulversion ausgeben

<?php
// Gibt die Version des CUBRID-PHP-Moduls aus – ohne aktive Verbindung
$version = cubrid_version();
echo "CUBRID PHP-Modul Version: " . $version . PHP_EOL;

CUBRID PHP-Modul Version: 11.2.0.0002

Versionscheck vor Feature-Nutzung

<?php
// Prüft, ob die CUBRID-Modulversion mindestens 9.0.0 ist
$version = cubrid_version();
$parts = explode('.', $version);
$major = (int) $parts[0];

if ($major >= 9) {
    echo "CUBRID-Modul ist aktuell genug (v{$version}), Feature kann genutzt werden." . PHP_EOL;
} else {
    echo "CUBRID-Modul zu alt (v{$version}), bitte aktualisieren." . PHP_EOL;
}

CUBRID-Modul ist aktuell genug (v11.2.0.0002), Feature kann genutzt werden.

// Wichtig · Fallstricke

Die zurückgegebene Version bezieht sich ausschließlich auf das PHP-Erweiterungsmodul (libcubrid), nicht auf den CUBRID-Datenbankserver. Verwechslungen können zu falschen Kompatibilitätsaussagen führen. Für die Serverversion sollte cubrid_get_server_info() herangezogen werden.

Siehe auch

cubrid_get_server_info cubrid_connect cubrid_error_msg