Signatur
Beschreibung
tidy_get_html_ver() analysiert ein mit der Tidy-Erweiterung geparsten HTML-Dokument und gibt die erkannte HTML-Version als Ganzzahl zurück. Diese Funktion ist nützlich, wenn man feststellen möchte, nach welchem HTML-Standard ein vorliegendes Dokument verfasst wurde.
Die Funktion ist die prozedurale Variante der Methode tidy::getHtmlVer(). Sie erwartet ein tidy-Objekt, das zuvor durch tidy_parse_string() oder tidy_parse_file() erstellt wurde.
Der zurückgegebene Wert entspricht einer internen Tidy-Versionsnummer. Übliche Rückgabewerte sind beispielsweise 0 für unbekannte Versionen, 20070615 für HTML5-ähnliche Dokumente oder andere numerische Werte je nach Tidy-Bibliotheksversion. Da die genauen Werte von der verwendeten libtidy-Version abhängen, sollte man die Ausgabe primär zu Diagnosezwecken verwenden.
Diese Funktion eignet sich vor allem für Dokumentations-, Validierungs- oder Migrations-Workflows, bei denen man unterschiedliche HTML-Versionen unterschiedlich verarbeiten möchte.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $tidy Pflicht | tidy | Ein tidy-Objekt, das ein zuvor gepartes HTML-Dokument repräsentiert. |
Rückgabewert
0 kann auf eine unbekannte oder nicht erkannte Version hinweisen.Beispiele
HTML-Version eines einfachen Dokuments ermitteln
<?php
$html = '<!DOCTYPE html>
<html>
<head><title>Test</title></head>
<body><p>Hallo Welt</p></body>
</html>';
$tidy = tidy_parse_string($html, [], 'UTF8');
tidy_clean_repair($tidy);
$version = tidy_get_html_ver($tidy);
echo "Erkannte HTML-Version: " . $version . PHP_EOL;Objektorientierte Variante mit getHtmlVer()
<?php
$html = '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head><title>Altes Dokument</title></head>
<body><p>Inhalt</p></body>
</html>';
$tidy = new tidy();
$tidy->parseString($html, [], 'UTF8');
$tidy->cleanRepair();
// Prozedurale Variante
$ver = tidy_get_html_ver($tidy);
echo "HTML-Version (prozedural): " . $ver . PHP_EOL;
// OOP-Variante
echo "HTML-Version (OOP): " . $tidy->getHtmlVer() . PHP_EOL;// Wichtig · Fallstricke
Hinweis zur Zuverlässigkeit: Die zurückgegebene Versionsnummer hängt stark von der installierten libtidy-Bibliotheksversion ab. Unterschiedliche Betriebssystem-Pakete können unterschiedliche Werte für dasselbe Dokument liefern. Die Funktion sollte daher nur für diagnostische Zwecke eingesetzt werden und nicht als alleinige Grundlage für kritische Entscheidungslogik dienen.
Deprecated-Status: Die prozedurale Verwendung der Tidy-Funktionen ist in neueren PHP-Versionen zugunsten der objektorientierten Schreibweise weniger gebräuchlich. Es empfiehlt sich, tidy::getHtmlVer() zu verwenden, um zukunftssicheren Code zu schreiben.