Start · Sprachen · PHP · Referenz · tidy_get_release

tidy_get_release

Funktion

Gibt das Veröffentlichungsdatum (Version) der installierten Tidy-Bibliothek als Zeichenkette zurück.

seit PHP 5.0.0 Kategorie: string

Signatur

tidy_get_release(): string

Beschreibung

tidy_get_release() liefert einen Versionsstring der zugrundeliegenden HTML Tidy-Bibliothek, zum Beispiel "5 August 2000". Damit lässt sich zur Laufzeit prüfen, welche Version von Tidy auf dem Server installiert ist.

Die Funktion benötigt keine Parameter und ist besonders nützlich, wenn die Verfügbarkeit bestimmter Tidy-Features von der Bibliotheksversion abhängt. Sie dient also primär der Diagnose und Kompatibilitätsprüfung.

Alternativ kann die Methode tidy::getRelease() auf einem instanziierten tidy-Objekt aufgerufen werden – beide geben denselben Wert zurück.

Rückgabewert

Typ
string
Beschreibung
Gibt das Veröffentlichungsdatum der installierten Tidy-Bibliothek als Zeichenkette zurück, z. B. "5 August 2000".

Beispiele

Versionsstring der Tidy-Bibliothek ausgeben

<?php
// Gibt das Veröffentlichungsdatum der installierten Tidy-Bibliothek aus
$release = tidy_get_release();
echo "Installierte Tidy-Version: " . $release;
Installierte Tidy-Version: 5 August 2000

Versionsprüfung vor der Nutzung von Tidy-Features

<?php
// Prüfen, ob eine ausreichend aktuelle Tidy-Version vorhanden ist
$release = tidy_get_release();
if (empty($release)) {
    echo "Tidy-Bibliothek nicht verfügbar oder Version nicht ermittelbar.";
} else {
    echo "Tidy ist verfügbar. Bibliotheksversion: " . htmlspecialchars($release);
    // Weiterverarbeitung mit Tidy
    $tidy = new tidy();
    $tidy->parseString('<p>Hallo <b>Welt</p>', ['output-xhtml' => true], 'utf8');
    $tidy->cleanRepair();
    echo "\nBereinigtes HTML:\n" . $tidy;
}
Tidy ist verfügbar. Bibliotheksversion: 5 August 2000 Bereinigtes HTML: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title></title> </head> <body> <p>Hallo <b>Welt</b></p> </body> </html>

// Wichtig · Fallstricke

Die Funktion setzt voraus, dass die Tidy-Erweiterung in PHP kompiliert oder als dynamisches Modul geladen ist. Ist die Erweiterung nicht vorhanden, führt der Aufruf zu einem fatalen Fehler. Die Verfügbarkeit kann vorab mit extension_loaded('tidy') geprüft werden.

Das zurückgegebene Datum ist kein standardisiertes Versionsformat (wie SemVer), sondern ein von der Tidy-Bibliothek selbst gesetzter, freitextlicher Datumsstring. Ein direkter numerischer Versionsvergleich ist daher nicht zuverlässig möglich.