Funkcja PHP htmlentities()

Funkcja PHP htmlentities() zamienia na encje HTML wszystkie znaki łańcucha, dla których istnieją encje HTML. Jest więc bardzo podobna do funkcji htmlspecialchars(), która zamienia na encje tylko znaki o specjalnym znaczeniu w HTML.

Przykład

Zamiana na encje HTML znaków w łańcuchu za pomocą funkcji PHP htmlentities().


print_r(htmlentities('<p>♠ ♣ ♥ ♦</p>'));

Wynik:

&lt;p&gt;&spades; &clubs; &hearts; &diams;&lt;/p&gt;

Składnia funkcji PHP htmlentities()

Funkcja PHP htmlentities() ma następującą składnię:

htmlentities(
    string $string,
    int $flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401,
    ?string $encoding = null,
    bool $double_encode = true
): string

Parametry

Parametr	Opis
`string`	Parametr obowiązkowy. Łańcuch, w którym znaki specjalne HTML mają zostać zamienione na encje HTML.
`flags`	Maska bitowa określająca sposób traktowania cudzysłowów i nieprawidłowych jednostek kodowych oraz stosowany typ dokumentu. Może zawierać jedną lub więcej z poniższych wartości połączonych operatorem logicznym \|: `ENT_COMPAT` Konwersja tylko cudzysłowów podwójnych. `ENT_QUOTES` Konwersja cudzysłowów pojedynczych i podwójnych. `ENT_NOQUOTES` Żadne cudzysłowy nie będą konwertowane. `ENT_IGNORE` Ignorowanie nieprawidłowych jednostek kodowych. Nie zaleca się używania tej flagi ze względów bezpieczeństwa. `ENT_SUBSTITUTE` Zamiana nieprawidłowych jednostek kodowych na znak zastępczy Unicode (ang. Unicode Replacement Character) U+FFFD (w UTF-8) lub `�` (jako encja szesnastkowa HTML) zamiast na pusty łańcuch. `ENT_DISALLOWED` Zamiana nieprawidłowych jednostek kodowych na znak zastępczy Unicode U+FFFD (w UTF-8) lub `�` (jako encja szesnastkowa HTML) zamiast pozostawiać je bez zmian. Może się przydać do zapewniania poprawności składniowej dokumentów XML. `ENT_HTML401` Traktowanie dokumentu jako HTML 4.01. `ENT_XML1` Traktowanie dokumentu jako XML 1. `ENT_XHTML` Traktowanie dokumentu jako XHTML. `ENT_HTML5` Traktowanie dokumentu jako HTML5.
`encoding`	Określa kodowanie, które ma być zastosowane podczas konwersji znaków. Jeśli parametr ten zostanie pominięty, to używane jest kodowanie domyślne ustawione w opcji `default_charset` w pliku php.ini. Lista obsługiwanych zestawów znaków: ISO-8859-1 lub ISO8859-1 ISO-8859-5 lub ISO8859-5 ISO-8859-15 lub ISO8859-15 UTF-8 cp866 lub ibm866 lub 866 cp1251 lub Windows-1251 lub win-1251 lub 1251 cp1252 lub Windows-1252 lub 1252 KOI8-R lub koi8-ru lub koi8r BIG5 lub 950 GB2312 lub 936 BIG5-HKSCS lub Big5 Shift_JIS lub SJIS lub SJIS-win lub cp932 lub 932 EUC-JP lub EUCJP lub eucJP-win
`double_encode`	Włączenie tego parametru powoduje, że istniejące encje HTML nie są konwertowane.

Wartość zwrotna

Funkcja PHP htmlentities() zwraca przetworzony łańcuch.

Typ zwrotny: string.

Funkcja PHP htmlentities()

Składnia funkcji PHP htmlentities()

Parametry

Wartość zwrotna

Zobacz również

Dodaj komentarz Anuluj pisanie odpowiedzi