solr_get_version — Funktion · PHP-Referenz

Signatur

solr_get_version(): string

Beschreibung

solr_get_version() liefert die aktuell geladene Version der Apache Solr PHP Extension (PECL-Erweiterung solr) zurück. Die zurückgegebene Zeichenkette folgt dem üblichen Semver-Format (z. B. 2.5.0).

Die Funktion ist besonders nützlich, um zur Laufzeit zu prüfen, ob eine Mindestversion der Erweiterung vorhanden ist, bevor versionsabhängige Features oder API-Methoden aufgerufen werden. So lassen sich Kompatibilitätsprobleme frühzeitig erkennen und aussagekräftige Fehlermeldungen ausgeben.

Da solr_get_version() keine Parameter erwartet und keine externe Verbindung aufbaut, kann sie auch ohne laufenden Solr-Server und ohne Konfiguration aufgerufen werden – sie greift ausschließlich auf interne Metadaten der PHP-Erweiterung zu.

Rückgabewert

Typ

string

Beschreibung

Gibt die Versionsnummer der Apache Solr PHP-Erweiterung als Zeichenkette zurück, z. B. "2.5.0".

Beispiele

Aktuelle Erweiterungsversion ausgeben

<?php
$version = solr_get_version();
echo 'Installierte Solr-Erweiterungsversion: ' . $version . PHP_EOL;

Installierte Solr-Erweiterungsversion: 2.5.0

Mindestversion prüfen vor API-Nutzung

<?php
$minVersion = '2.0.0';
$currentVersion = solr_get_version();

if (version_compare($currentVersion, $minVersion, '<')) {
    throw new RuntimeException(
        sprintf(
            'Solr-Erweiterung zu alt: %s gefunden, mindestens %s erforderlich.',
            $currentVersion,
            $minVersion
        )
    );
}

echo 'Solr-Erweiterung ist aktuell genug: ' . $currentVersion . PHP_EOL;

Solr-Erweiterung ist aktuell genug: 2.5.0

// Wichtig · Fallstricke

Die Funktion steht nur zur Verfügung, wenn die PECL-Erweiterung solr installiert und in der php.ini aktiviert ist. Andernfalls führt der Aufruf zu einem schwerwiegenden Fehler (Fatal Error: Call to undefined function). Mit extension_loaded('solr') lässt sich vorher prüfen, ob die Erweiterung verfügbar ist.

Die zurückgegebene Version bezieht sich auf die PHP-Erweiterung, nicht auf den Apache Solr Server selbst. Die Server-Version kann über die Solr Admin API (/solr/admin/info/system) abgefragt werden.

Siehe auch

extension_loaded phpversion version_compare