htmlentitiesПреобразовывает возможные символы в HTML-сущности
&reftitle.description;
stringhtmlentitiesstringstringintflagsENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401stringnullencoding&null;booldouble_encode&true;
Функция работает идентично функции htmlspecialchars,
за исключением того, что функция htmlentities
преобразовывает в HTML-сущности каждый символ, для которого в таблице перевода
содержится эквивалентная HTML-сущность.
Таблицу перевода, которую использует эта функция и которая зависит
от констант, которые передали в параметр flags,
возвращает функция get_html_translation_table.
Функция html_entity_decode выполняет обратное
преобразование — декодирует HTML-сущности в символы.
&reftitle.parameters;
string
Входная строка.
flags
Битовая маска из следующих флагов, которые определяют, как обрабатывать
кавычки, неправильные последовательности кодовых единиц
и тип документа. Маска по умолчанию:
ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.
Доступные константы параметра <parameter>flags</parameter>
Название константыОписаниеENT_COMPATПреобразовывает двойные кавычки, одинарные кавычки не изменяются.ENT_QUOTESПреобразовывает как двойные, так и одинарные кавычки.ENT_NOQUOTESОставляет без изменения как двойные, так и одинарные кавычки.ENT_IGNORE
Без предупреждения отбрасывает неправильные последовательности кодовых единиц
вместо возврата пустой строки. Передача этого флага не рекомендуется,
поскольку это небезопасно.
ENT_SUBSTITUTE
Заменяет неправильные последовательности кодовых единиц символом замены
Юникода вместо возврата пустой строки: U+FFFD для строк в кодировке UTF-8
и &#FFFD; для строк в других кодировках.
ENT_DISALLOWED
Заменяет неверные кодовые точки для заданного типа документа символом
замены юникода U+FFFD для строк в кодировке UTF-8 или &#FFFD;
для строк в других кодировках вместо того, чтобы оставлять всё как есть.
Это бывает полезно для правильного оформления XML-документов,
в которые встроили внешнее содержимое.
ENT_HTML401
Обрабатывает код по правилам стандарта HTML 4.01.
ENT_XML1
Обрабатывает код по правилам стандарта XML 1.
ENT_XHTML
Обрабатывает код по правилам стандарта XHTML.
ENT_HTML5
Обрабатывает код по правилам стандарта HTML 5.
encoding
&strings.parameter.encoding;
&reference.strings.charsets;
double_encode
Когда параметр double_encode отключён,
PHP не будет кодировать существующие HTML-сущности.
По умолчанию функция преобразовывает каждый символ.
&reftitle.returnvalues;
Функция возвращает преобразованную строку.
Функция вернёт пустую строку, если входная строка string
содержит недопустимую для кодировки encoding
последовательность кодовых единиц,
если только не установили флаг ENT_IGNORE
или ENT_SUBSTITUTE.
&reftitle.changelog;
&Version;&Description;8.1.0
Значение по умолчанию параметра flags
изменили с ENT_COMPAT
на ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.
8.0.0
Параметр encoding теперь принимает значение null.
&reftitle.examples;
Пример использования функции <function>htmlentities</function>
bold";
echo htmlentities($str);
echo "\n\n";
echo htmlentities($str, ENT_COMPAT);
?>
]]>
&example.outputs;
Передача флага <constant>ENT_IGNORE</constant>
]]>
&reftitle.seealso;
html_entity_decodeget_html_translation_tablehtmlspecialcharsnl2brurlencode