Signatur
Beschreibung
rrd_version() ist eine Funktion der PHP-RRD-Erweiterung und liefert die Versionszeichenkette der installierten RRDtool-Bibliothek zurück. RRDtool (Round-Robin Database Tool) ist ein weit verbreitetes System zur Speicherung und Visualisierung von Zeitreihendaten, beispielsweise für Netzwerk-Monitoring oder Performance-Metriken.
Die Funktion ist nützlich, wenn Anwendungen bestimmte Funktionen von RRDtool voraussetzen, die erst ab einer bestimmten Version verfügbar sind. Mithilfe von rrd_version() kann die verfügbare Bibliotheksversion zur Laufzeit geprüft und ggf. ein Fehler ausgegeben oder ein alternativer Code-Pfad gewählt werden.
Ein typischer Anwendungsfall ist die Kompatibilitätsprüfung beim Start einer Monitoring-Applikation oder beim Deployment auf einem neuen Server, um sicherzustellen, dass die installierte RRDtool-Version alle benötigten Funktionen unterstützt.
Rückgabewert
rrdtool-Bibliothek zurück, z. B. "1.7.2".Beispiele
Versionsinfo der rrdtool-Bibliothek ausgeben
<?php
$version = rrd_version();
echo "Installierte RRDtool-Version: " . $version . PHP_EOL;Kompatibilitätsprüfung vor dem Einsatz erweiterter Features
<?php
$minVersion = '1.5.0';
$currentVersion = rrd_version();
if (version_compare($currentVersion, $minVersion, '>=')) {
echo "RRDtool-Version " . $currentVersion . " ist kompatibel." . PHP_EOL;
} else {
echo "Warnung: RRDtool-Version " . $currentVersion
. " ist zu alt. Mindestens " . $minVersion . " wird benötigt." . PHP_EOL;
}// Wichtig · Fallstricke
Die Funktion ist nur verfügbar, wenn die PHP-Erweiterung rrd installiert und aktiviert ist. Ist die Erweiterung nicht geladen, führt der Aufruf zu einem schwerwiegenden Fehler (Fatal Error). Die Verfügbarkeit lässt sich vorab mit extension_loaded('rrd') prüfen.
Die zurückgegebene Versionszeichenkette entspricht der Version der Bibliothek (librrds), nicht unbedingt der Version des rrdtool-Kommandozeilenprogramms, auch wenn diese in der Regel übereinstimmen.