Signatur
Beschreibung
seaslog_get_version() ist eine Hilfsfunktion der PHP-Erweiterung SeasLog und liefert die Versionsnummer der installierten SeasLog-Bibliothek als einfache Zeichenkette (z. B. "1.8.6").
Die Funktion ist nützlich, wenn man sicherstellen möchte, dass eine Mindestversion von SeasLog vorhanden ist, bevor bestimmte API-Features verwendet werden. Dies ist besonders relevant, da sich der SeasLog-Funktionsumfang zwischen den Versionen merklich unterscheiden kann.
Typische Einsatzgebiete sind Bootstrap-Prüfungen, Kompatibilitäts-Checks in Bibliotheken sowie Diagnose- und Debugging-Ausgaben beim Einrichten einer Logging-Infrastruktur.
Rückgabewert
"1.8.6" oder "2.0.2".Beispiele
Aktuelle SeasLog-Version ausgeben
<?php
// Gibt die installierte SeasLog-Version aus
$version = seaslog_get_version();
echo 'SeasLog-Version: ' . $version . PHP_EOL;Mindestversion prüfen, bevor SeasLog-Features genutzt werden
<?php
// Stellt sicher, dass mindestens SeasLog 1.8.0 vorhanden ist
$minRequired = '1.8.0';
$installed = seaslog_get_version();
if (version_compare($installed, $minRequired, '>=')) {
echo 'SeasLog ist kompatibel. Installierte Version: ' . $installed . PHP_EOL;
// SeasLog-Features nutzen ...
SeasLog::setBasePath('/var/log/myapp');
SeasLog::info('Anwendung gestartet.');
} else {
throw new RuntimeException(
'SeasLog ' . $minRequired . ' oder höher wird benötigt. '
. 'Installiert: ' . $installed
);
}// Wichtig · Fallstricke
Die Funktion ist nur verfügbar, wenn die SeasLog-Erweiterung korrekt installiert und in der php.ini geladen ist. Andernfalls löst ein Aufruf einen fatalen Fehler aus (Call to undefined function). Es empfiehlt sich daher, vor dem Aufruf mit function_exists('seaslog_get_version') zu prüfen, ob die Erweiterung überhaupt vorhanden ist.