Signatur
Beschreibung
tidy_config_count() liefert die Anzahl der Fehler, die beim Lesen und Auswerten der Tidy-Konfiguration für das angegebene Dokument aufgetreten sind. Die Funktion ist nützlich, um nach dem Parsen oder Bereinigen eines HTML/XHTML-Dokuments zu prüfen, ob die übergebenen Konfigurationsoptionen korrekt interpretiert wurden.
Konfigurationsfehler entstehen beispielsweise, wenn ungültige Optionsnamen oder unzulässige Werte an tidy_parse_string(), tidy_parse_file() oder tidy::parseString() übergeben werden. Durch Auswertung der Rückgabe lässt sich feststellen, ob die Tidy-Konfiguration vollständig und fehlerfrei akzeptiert wurde.
Die Funktion kann sowohl prozedural als auch objektorientiert (als Methode $tidy->configErrorCount()) verwendet werden. In modernen PHP-Versionen bevorzugt man die OOP-Variante für bessere Lesbarkeit und Struktur.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $tidy Pflicht | tidy | Ein gültiges tidy-Objekt, das zuvor durch Parsen eines Dokuments (z. B. mit tidy_parse_string() oder tidy_parse_file()) erzeugt wurde. |
Rückgabewert
0 zurückgegeben.Beispiele
Prozeduraler Aufruf mit ungültiger Konfigurationsoption
<?php
$html = '<!DOCTYPE html><html><body><p>Test</p></body></html>';
// Absichtlich eine ungültige Option übergeben
$config = [
'output-xhtml' => true,
'ungueltige-option' => 'xyz'
];
$tidy = tidy_parse_string($html, $config, 'UTF8');
$fehlerAnzahl = tidy_config_count($tidy);
echo "Konfigurationsfehler: " . $fehlerAnzahl . PHP_EOL;
if ($fehlerAnzahl > 0) {
echo "Achtung: Es gibt Probleme mit der Tidy-Konfiguration!" . PHP_EOL;
}Objektorientierter Aufruf mit gültiger Konfiguration
<?php
$html = '<!DOCTYPE html><html><body><p>Hallo Welt</p></body></html>';
$tidy = new tidy();
$tidy->parseString($html, ['output-xhtml' => true, 'indent' => true], 'UTF8');
$fehler = $tidy->configErrorCount();
echo "Konfigurationsfehler: " . $fehler . PHP_EOL;
if ($fehler === 0) {
echo "Konfiguration wurde fehlerfrei akzeptiert." . PHP_EOL;
}// Wichtig · Fallstricke
Hinweis zur Verfügbarkeit: Die Tidy-Erweiterung muss beim Kompilieren von PHP aktiviert worden sein (--with-tidy) oder als dynamische Erweiterung in der php.ini geladen werden. Andernfalls steht tidy_config_count() nicht zur Verfügung.
Unterschied zu anderen Zählern: tidy_config_count() zählt ausschließlich Konfigurationsfehler, nicht Fehler oder Warnungen im geparsten HTML-Dokument. Für HTML-Fehler und Warnungen stehen tidy_error_count() und tidy_warning_count() zur Verfügung.