rnp_version_string — Funktion · PHP-Referenz

Signatur

rnp_version_string(): string

Beschreibung

rnp_version_string() liefert die Version der installierten RNP-Bibliothek als lesbaren String, z. B. "0.16.3". RNP ist eine OpenPGP-Implementierung, die in PHP über die PECL-Erweiterung rnp angebunden wird.

Die Funktion ist nützlich, um zur Laufzeit zu prüfen, welche Version der Bibliothek tatsächlich verfügbar ist – etwa um sicherzustellen, dass bestimmte Algorithmen oder Features unterstützt werden, bevor man sie einsetzt. Dies ist besonders in portablen Anwendungen relevant, die auf verschiedenen Serverumgebungen mit unterschiedlichen RNP-Versionen laufen könnten.

Im Gegensatz zur PHP-Extension-Version spiegelt dieser Wert die native C-Bibliotheksversion wider, die im Hintergrund kompiliert und verlinkt wurde. Beide Versionen können voneinander abweichen.

Rückgabewert

Typ

string

Beschreibung

Gibt die Versionsnummer der RNP-Bibliothek als Zeichenkette zurück, z. B. "0.16.3".

Beispiele

RNP-Bibliotheksversion ausgeben

<?php
// Gibt die Version der installierten RNP-Bibliothek aus
$version = rnp_version_string();
echo "RNP-Bibliotheksversion: " . $version . PHP_EOL;

RNP-Bibliotheksversion: 0.16.3

Mindestversion prüfen vor Verwendung eines Features

<?php
// Sicherstellen, dass mindestens RNP 0.15.0 vorhanden ist
$required = '0.15.0';
$current  = rnp_version_string();

if (version_compare($current, $required, '>=')) {
    echo "RNP " . $current . " unterstützt das gewünschte Feature." . PHP_EOL;
} else {
    echo "Zu alte RNP-Version: " . $current . " (benötigt: " . $required . ")" . PHP_EOL;
}

RNP 0.16.3 unterstützt das gewünschte Feature.

// Wichtig · Fallstricke

Die zurückgegebene Versionszeichenkette folgt dem Semantic Versioning-Schema (MAJOR.MINOR.PATCH) und kann direkt mit version_compare() verglichen werden. Beachte, dass die PHP-Extension-Version (über phpversion('rnp') abrufbar) von der Bibliotheksversion abweichen kann, da Extension und Bibliothek unabhängig voneinander aktualisiert werden können.

Siehe auch

rnp_version_string_for rnp_version phpversion version_compare