Willi's Homepage - Tricks und Tips

Du bist hier: Tips » Scripte » PHP

PHP

htmlentities

String-Funktionen

Befehl:

string htmlentities ( string $string [, int $flags = ENT_COMPAT | ENT_HTML401 [, string $encoding = 'UTF-8' [, bool $double_encode = true ]]] )

Parameter-Liste:

Name Beschreibung

table Welche Tabelle zurückgegeben werden soll. Entweder HTML_ENTITIES oder HTML_SPECIALCHARS.

flags

Eine Bitmaske von einem oder mehreren der folgenden Flags, welche festlegen welche Anführungszeichen die Tabelle enthalten wird, sowie für welchen Dokumenttyp sie ist. Der Standardwert ist ENT_COMPAT | ENT_HTML401.

**Verfügbare *`flags`*-Konstanten**
Konstantenname	Beschreibung
`ENT_COMPAT`	Tabelle soll Entities für doppelte Anführungszeichen enthalten, aber nicht für einfache.
`ENT_QUOTES`	Tabelle soll Entities sowohl für einfache, als auch doppelte Anführungszeichen enthalten.
`ENT_NOQUOTES`	Tabelle soll weder Entities für einfache, noch für doppelte Anführungszeichen enthalten.
`ENT_HTML401`	Tabelle für HTML 4.01.
`ENT_XML1`	Tabelle für XML 1.
`ENT_XHTML`	Tabelle für XHTML.
`ENT_HTML5`	Tabelle für HTML 5.

encoding

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.

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 Wenn double_encode ausgeschaltet ist, verändert PHP keine bereits vorhandenen HTML-Entities. Standardmässig wird jedoch alles konvertiert.

Rückgabewerte:

Gibt die kodierte Zeichenkette zurück.

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.

Beschreibung:

Die Funktion ist komplett identisch zu htmlspecialchars(), allerdings wandelt htmlentities() wirklich alle Zeichen, die eine HTML-Code-Entsprechung haben, in diese Entsprechung um.

Möchten Sie stattdessen die HTML Entities dekodieren, verwenden Sie bitte die Funktion html_entity_decode().

Aktiv in Version:

(PHP 4, PHP 5, PHP 7)

Siehe auch:

• html_entity_decode()

Konvertiert alle benannten HTML-Zeichen in ihre entsprechenden Ursprungszeichen

• get_html_translation_table()

Gibt die Umwandlungs-Tabelle zurück, die von htmlspecialchars und htmlentities verwendet wird

• htmlspecialchars()

Wandelt Sonderzeichen in HTML-Codes um

• nl2br()

Fügt vor allen Zeilenumbrüchen eines Strings HTML-Zeilenumbrüche ein

• urlencode()

URL-kodiert einen String

Bsp. 1
Bsp. 2

htmlentities() - Beispiel:

Eingabe:

<?php
$str = "Ein 'Anführungszeichen' ist <b>fett</b>";

// Gibt aus: Ein 'Anführungszeichen' ist &lt;b&gt;fett&lt;/b&gt;
echo htmlentities($str);

// Gibt aus: Ein &#039;Anführungszeichen&#039; ist &lt;b&gt;fett&lt;/b&gt;
echo htmlentities($str, ENT_QUOTES);
?>

Beschreibung:

Mit htmlentities() werden alle Sonderzeichen und HTML-Tags in den dafï¿½r vorgesehenen HTML-Code umgewandelt. Der zweite Parameter (quote_style) ist optional und erst ab der Version 3.0.17 bzw. 4.0.3 verfï¿½gbar. Dieser bewirkt, dass Anfï¿½hrungszeichen mit berï¿½cksichtigt werden. Standardmï¿½ssig ist der Wert ENT_COMPAT aktiviert.

Beschreibung:

Version	Beschreibung
5.4.0	Der Standardwert für `encoding` wurde zu UTF-8 geändert.
5.4.0	Die Konstanten `ENT_SUBSTITUTE`, `ENT_DISALLOWED`, `ENT_HTML401`, `ENT_XML1`, `ENT_XHTML` und `ENT_HTML5` wurden hinzugefügt.
5.3.0	Die Konstante `ENT_IGNORE` wurde hinzugefügt.
5.2.3	Der Parameter `double_encode` wurde hinzugefügt.
4.1.0	Der Parameter `encoding` wurde hinzugefügt.
4.0.3	Der Parameter `flags` wurde hinzugefügt.

htmlentities() - Beispiel 2:

Eingabe:

<?php
$str = "\x8F!!!";

// Gibt eine leere Zeichenkette aus
echo htmlentities($str, ENT_QUOTES, "UTF-8");

// Gibt "!!!" aus
echo htmlentities($str, ENT_QUOTES | ENT_IGNORE, "UTF-8");
?>

Beschreibung:

Version	Beschreibung
5.4.0	Der Standardwert für `encoding` wurde zu UTF-8 geändert.
5.4.0	Die Konstanten `ENT_SUBSTITUTE`, `ENT_DISALLOWED`, `ENT_HTML401`, `ENT_XML1`, `ENT_XHTML` und `ENT_HTML5` wurden hinzugefügt.
5.3.0	Die Konstante `ENT_IGNORE` wurde hinzugefügt.
5.2.3	Der Parameter `double_encode` wurde hinzugefügt.
4.1.0	Der Parameter `encoding` wurde hinzugefügt.
4.0.3	Der Parameter `flags` wurde hinzugefügt.

html_entity_decode

htmlspecialchars_decode

String-Funktionen