|
htmlspecialchars
(PHP 4, PHP 5) htmlspecialchars — Wandelt Sonderzeichen in HTML-Codes um
Beschreibung
string htmlspecialchars
( string $string
[, int $flags = ENT_COMPAT | ENT_HTML401
[, string $encoding = 'UTF-8'
[, bool $double_encode = true
]]] )
Diese Funktion ist hilfreich, um vom Benutzer gelieferten Text frei
von HTML-Code zu halten, wie z.B. in Foren oder Gästebüchern.
Folgende Umwandlungen werden vorgenommen:
-
'&' (Ampersand/kaufmännisches Und) wird zu '&'.
-
'"' (doppeltes Anführungszeichen) wird zu '"',
wenn
ENT_NOQUOTES nicht gesetzt ist.
-
"'" (einfaches Anführungszeichen) wird nur zu ''',
wenn
ENT_QUOTES gesetzt ist.
-
'<' (kleiner als) wird zu '<'
-
'>' (größer als) wird zu '>'
Parameter-Liste
-
string
-
Die zu konvertierende Zeichenkette.
-
flags
-
Eine Bitmaske von einem oder mehreren der folgenden Flags, die
die Behandlung von Anführungszeichen, ungültigen Zeichenfolgen
und den genutzten Dokumententyp festlegen.
Der Standardwert ist ENT_COMPAT | ENT_HTML401.
Verfügbare flags Konstanten
| Konstante |
Beschreibung |
ENT_COMPAT |
Konvertiert nur doppelte Anführungszeichen und lässt einfache
Anführungszeichen unverändert.
|
ENT_QUOTES |
Konvertiert sowohl doppelte als auch einfache Anführungszeichen. |
ENT_NOQUOTES |
Lässt doppelte und einfache Anführungszeichen unverändert. |
ENT_IGNORE |
Verwirft ungültige Code Unit Sequenzen anstatt eine leere Zeichenkette
zurückzugeben. Die Nutzung dieser Option ist nicht empfehlenswert, da sie
» Auswirkungen auf die Sicherheit
haben kann.
|
ENT_SUBSTITUTE |
Ersetzt ungültige Code Unit Sequenzen mit einem Unicode Ersatz Zeichen
U+FFFD (UTF-8) oder &#FFFD; (andernfalls) anstatt eine
leere Zeichenkette zurückzugeben.
|
ENT_DISALLOWED |
Ersetzt Code Unit Sequenzen, welche in dem angegebenen Dokumenttyp
ungültig sind, mit einem Unicode Ersatz Zeichen U+FFFD (UTF-8)
oder &#FFFD; (andernfalls).
|
ENT_HTML401 |
Behandle Code als HTML 4.01.
|
ENT_XML1 |
Behandle Code als XML 1.
|
ENT_XHTML |
Behandle Code als XHTML.
|
ENT_HTML5 |
Behandle Code als HTML 5.
|
-
charset
-
Definiert die zu verwendende Zeichenkodierung.
Standardwert ist ISO-8859-1 in PHP Versionen vor 5.4.0 und
UTF-8 in PHP 5.4.0 und neuer.
Für den Gebrauch dieser Funktion sind die Zeichenkodierungen
ISO-8859-1, ISO-8859-15,
UTF-8, cp866,
cp1251, cp1252 und
KOI8-R tatsächlich äquivalent, vorausgesetzt der
string selbst ist gültig in der
Zeichenkodierung, da die von
htmlspecialchars() betroffenen Zeichen in allen
genannten Zeichenkodierungen an gleicher Position stehen.
Die folgenden Zeichensätze werden mit PHP 4.3.0 und höher unterstützt:
Unterstützte Zeichensätze
| Zeichensatz |
Alias |
Beschreibung |
| ISO-8859-1 |
ISO8859-1 |
Westeuropäisch, Latin-1
|
| 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.
Dieser Zeichensatz wird ab PHP Version 4.3.2 unterstützt.
|
| cp1251 |
Windows-1251, win-1251, 1251 |
Windows-spezifischer Kyrillischer Zeichensatz.
Dieser Zeichensatz wird ab PHP Version 4.3.2 unterstützt.
|
| cp1252 |
Windows-1252, 1252 |
Windows spezifischer Zeichensatz für westeuropäische Sprachen.
|
| KOI8-R |
koi8-ru, koi8r |
Russisch. Dieser Zeichensatz wird ab PHP Version 4.3.2 unterstützt.
|
| 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, 932 |
Japanisch
|
| EUC-JP |
EUCJP |
Japanisch
|
Hinweis:
Weitere Zeichensätze sind nicht implementiert, an ihrer Stelle wird ISO-8859-1 verwendet.
-
double_encode
-
Wird der Parameter double_encode ausgeschaltet,
kodiert PHP bereits existierende HTML-Entities nicht noch einmal.
Standardmäßig werden jedoch alle Zeichen konvertiert.
Rückgabewerte
Der konvertierte string.
Enthält der string eine in dem übergebenen
encoding ungültige Code Unit Sequenz, wird eine
leere Zeichenkette zurückgegeben, sofern weder das ENT_IGNORE
noch das ENT_SUBSITUTE Flag gesetzt sind.
Beispiele
Beispiel #1 htmlspecialchars()-Beispiel
<?php
$neu = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES);
echo $neu; // <a href='test'>Test</a>
?>
Anmerkungen
Hinweis:
Beachten Sie, dass diese Funktion nur die o.a. Umwandlungen
durchführt. Für vollständige Code-Umwandlung verwenden Sie bitte
htmlentities().
Siehe auch
- get_html_translation_table() - Gibt die Umwandlungs-Tabelle zurück, die von
htmlspecialchars und
htmlentities verwendet wird
- htmlspecialchars_decode() - Konvertiert besondere HTML-Auszeichnungen zurück in Buchstaben
- strip_tags() - Entfernt HTML- und PHP-Tags aus einem String
- htmlentities() - Wandelt alle geeigneten Zeichen in entsprechende HTML-Codes um
- nl2br() - Fügt vor allen Zeilenumbrüchen eines Strings HTML-Zeilenumbrüche ein
|
