html_entity_decode
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
html_entity_decode — Wandelt HTML-Entities in ihre entsprechenden Zeichen um
Beschreibung
$string, int $flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401, ?string $encoding = null): string
html_entity_decode() ist das Gegenstück zu
htmlentities(), welches HTML-Entities innerhalb von
string in ihre entsprechenden Zeichen zurückwandelt.
Genau gesagt dekodiert diese Funktion alle Entities (einschließlich aller numerischen Entities), die a) auf jeden Fall gültig für den gewählten Dokumenttyp sind — d. h. für XML dekodiert diese Funktion keine benannten Entities, die in einer DTD definiert sein könnten — und b) deren Zeichen in der Zeichenkodierung und im gewählten Dokumenttyp erlaubt sind. Alle anderen Entities bleiben wie sie sind.
Parameter-Liste
-
string -
Die Eingabezeichenkette.
-
flags -
Eine Bitmaske von einem oder mehreren der folgenden Flags, die die Behandlung von Anführungszeichen sowie den zu nutzenden Dokumententyp festlegen. Der Standardwert ist
ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.Verfügbare flags-KonstantenName der Konstante Beschreibung ENT_COMPATWandelt doppelte Anführungszeichen um und lässt einfache Anführungszeichen unverändert. ENT_QUOTESWandelt sowohl doppelte als auch einfache Anführungszeichen um. ENT_NOQUOTESLässt sowohl doppelte als auch einfache Anführungszeichen unverändert. ENT_SUBSTITUTEErsetzt ungültige Code-Unit-Sequenzen mit dem Unicode-Ersatzzeichen U+FFFD (UTF-8) oder � (andernfalls), anstatt eine leere Zeichenkette zurückzugeben. ENT_HTML401Behandle Code als HTML 4.01. ENT_XML1Behandle Code als XML 1. ENT_XHTMLBehandle Code als XHTML. ENT_HTML5Behandle Code als HTML 5. -
encoding -
Ein optionaler Parameter, der die Zeichenkodierung für eine Konvertierung definiert.
Wird der Parameter
encodingausgelassen, so wird der Wert der Konfigurationsoption default_charset als Standardwert dafür verwendet.Obwohl dieser Parameter technisch gesehen optional ist, wird dringend empfohlen, den korrekten Wert für den jeweiligen Code anzugeben, falls die Konfigurationsoption default_charset für die jeweilige Eingabe möglicherweise falsch gesetzt ist.
Die folgenden Zeichensätze werden unterstützt:
Unterstützte Zeichensätze Zeichensatz Alias Beschreibung ISO-8859-1 ISO8859-1 Westeuropäisch, Latin-1. ISO-8859-5 ISO8859-5 Wenig verwendeter kyrillischer Zeichensatz (Latin/Cyrillic). ISO-8859-15 ISO8859-15 Westeuropäisch, Latin-9. Enthält das Euro-Zeichen sowie französische und finnische Buchstaben, die in Latin-1(ISO-8859-1) fehlen. UTF-8 ASCII-kompatibles Multi-Byte 8-Bit Unicode. cp866 ibm866, 866 DOS-spezifischer kyrillischer Zeichensatz. cp1251 Windows-1251, win-1251, 1251 Windows-spezifischer kyrillischer Zeichensatz. cp1252 Windows-1252, 1252 Windows spezifischer Zeichensatz für westeuropäische Sprachen. KOI8-R koi8-ru, koi8r Russisch. BIG5 950 Traditionelles Chinesisch, hauptsächlich in Taiwan verwendet. GB2312 936 Vereinfachtes Chinesisch, nationaler Standard-Zeichensatz. BIG5-HKSCS Big5 mit Hongkong-spezifischen Erweiterungen; traditionelles Chinesisch. Shift_JIS SJIS, SJIS-win, cp932, 932 Japanisch EUC-JP EUCJP, eucJP-win Japanisch MacRoman Zeichensatz, der von Mac OS verwendet wurde. ''Eine leere Zeichenkette aktiviert die Erkennung durch die Kodierung des Skripts (Zend multibyte), default_charset und die aktuelle Sprachumgebung (siehe nl_langinfo() und setlocale()), in dieser Reihenfolge. Nicht empfehlenswert. Hinweis: Weitere Zeichensätze sind nicht implementiert. Statt dessen wird die Standard-Kodierung verwendet und eine Warnung ausgegeben.
Rückgabewerte
Gibt die dekodierte Zeichenkette zurück.
Changelog
| Version | Beschreibung |
|---|---|
| 8.1.0 |
flags geändert von
ENT_COMPAT zu ENT_QUOTES |
ENT_SUBSTITUTE | ENT_HTML401.
|
| 8.0.0 |
encoding ist jetzt nullable (akzeptiert den
null-Wert).
|
Beispiele
Beispiel #1 Dekodieren benannter HTML-Zeichen
<?php
$orig = "I'll \"walk\" the <b>dog</b> now";
$a = htmlentities($orig);
$b = html_entity_decode($a);
echo $a; // I'll "walk" the <b>dog</b> now
echo $b; // I'll "walk" the <b>dog</b> now
?>
Anmerkungen
Hinweis:
Sie wundern sich vielleicht, warum trim(html_entity_decode(' ')); die Zeichenkette nicht zu einer leeren Zeichenkette reduziert. Der Grund dafür ist, dass ' ' in der Standard-Kodierung nicht dem Zeichen mit ASCII-Code 32 entspricht (dieses wird von trim() entfernt), sondern dem Zeichen mit ASCII-Code 160 (0xa0).
Siehe auch
- htmlentities() - Wandelt alle geeigneten Zeichen in entsprechende HTML-Entities um
- htmlspecialchars() - Wandelt Sonderzeichen in HTML-Entities um
- get_html_translation_table() - Liefert die Umwandlungstabelle, die von htmlspecialchars und htmlentities verwendet wird
- urldecode() - Dekodiert eine URL-kodierte Zeichenkette
