htmlspecialchars_decode

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    htmlspecialchars_decode — Преобразовывает специальные HTML-сущности обратно в символы

    Описание

    htmlspecialchars_decode(string$string, int$flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401): string

    Функция, в противоположность функции htmlspecialchars(), преобразовывает специальные HTML-сущности обратно в символы.

    Конвертируемые сущности: &, " (без флага ENT_NOQUOTES), ' (с флагом ENT_QUOTES), < и >.

    Список параметров

    string

    Строка, которую требуется преобразовать.

    flags

    Битовая маска из следующих флагов, которые определяют, как обрабатывать кавычки какие типы документов использовать. Маска по умолчанию: ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

    Доступные константы параметра flags
    Имя константыОписание
    ENT_COMPATПреобразовывает двойные кавычки, одинарные кавычки не изменяются.
    ENT_QUOTESПреобразовывает как двойные, так и одинарные кавычки.
    ENT_NOQUOTESОставляет без изменения как двойные, так и одинарные кавычки.
    ENT_SUBSTITUTE Заменяет неправильные последовательности кодовых единиц символом замены Юникода вместо возврата пустой строки: U+FFFD для строк в кодировке UTF-8 и &#FFFD; для строк в других кодировках.
    ENT_HTML401 Обрабатывает код по правилам стандарта HTML 4.01.
    ENT_XML1 Обрабатывает код по правилам стандарта XML 1.
    ENT_XHTML Обрабатывает код по правилам стандарта XHTML.
    ENT_HTML5 Обрабатывает код по правилам стандарта 5.

    Возвращаемые значения

    Функция возвращает декодированную строку.

    Список изменений

    ВерсияОписание
    8.1.0 Значение по умолчанию для параметра flags изменили с ENT_COMPAT на ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

    Примеры

    Пример #1 Пример использования функции htmlspecialchars_decode()

    <?php

    $str     = "<p>this -&gt; &quot;</p>\n";

    echo     htmlspecialchars_decode($str);

    // Обратите внимание, что здесь кавычка не преобразовывается
    echo htmlspecialchars_decode($str, ENT_NOQUOTES);

    ?>

    Результат выполнения приведённого примера: 

    <p>this -> "</p> <p>this -> &quot;</p>

    Смотрите также

    • htmlspecialchars() - Преобразовывает специальные символы в HTML-сущности
    • html_entity_decode() - Преобразовывает HTML-сущности в символы
    • get_html_translation_table() - Возвращает таблицу преобразований, используемую функциями htmlspecialchars и htmlentities
    To Top