Signatur
Beschreibung
swoole_version() ist eine einfache Hilfsfunktion der Swoole-Erweiterung, die die Versionsnummer der installierten Swoole-Bibliothek zurückgibt. Die Rückgabe erfolgt als Zeichenkette im Format x.y.z (z. B. 5.1.2).
Die Funktion ist nützlich, wenn man zur Laufzeit prüfen möchte, ob eine bestimmte Mindestversion von Swoole installiert ist, bevor man versionsspezifische Funktionen oder APIs verwendet. So lassen sich Kompatibilitätsprobleme frühzeitig erkennen und abfangen.
Alternativ steht die Konstante SWOOLE_VERSION zur Verfügung, die denselben Wert enthält und sich für Vergleiche in Ausdrücken eignet, ohne einen Funktionsaufruf zu benötigen.
Rückgabewert
"5.1.2".Beispiele
Aktuelle Swoole-Version ausgeben
<?php
// Gibt die installierte Swoole-Version aus
$version = swoole_version();
echo 'Swoole-Version: ' . $version . PHP_EOL;Mindestversion prüfen und Fehler werfen
<?php
// Prüfen, ob mindestens Swoole 5.0.0 installiert ist
$required = '5.0.0';
$installed = swoole_version();
if (version_compare($installed, $required, '<')) {
throw new RuntimeException(
sprintf(
'Swoole %s oder neuer ist erforderlich. Installiert: %s',
$required,
$installed
)
);
}
echo 'Swoole-Versionsanforderung erfüllt: ' . $installed . PHP_EOL;// Wichtig · Fallstricke
Die Konstante SWOOLE_VERSION liefert denselben Wert wie swoole_version() und kann ohne Funktionsaufruf in Bedingungen verwendet werden, z. B. version_compare(SWOOLE_VERSION, '5.0.0', '>='). Für statische Prüfungen (z. B. in Konfigurationsdateien) ist die Konstante oft die bessere Wahl.
swoole_version() ist nur verfügbar, wenn die Swoole-Erweiterung installiert und in der php.ini aktiviert ist. Andernfalls führt der Aufruf zu einem fatalen Fehler. Mit extension_loaded('swoole') kann die Verfügbarkeit vorab geprüft werden.