htmlspecialchars_decode

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

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

Описание

function 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`	Обрабатывает код по правилам стандарта HTML 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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

Примечания пользователей 3 notes

down

thomas at xci[ignore_this]teit dot commm ¶

18 years ago

The example for "htmlspecialchars_decode()" below sadly does not work for all PHP4 versions.
Quote from the PHP manual:
"get_html_translation_table() will return the translation table that is used internally for htmlspecialchars() and htmlentities()."
But it does NOT! At least not for PHP version 4.4.2.
This was already reported in a bug report (http://bugs.php.net/bug.php?id=25927), but it was marked as BOGUS.
Proof:
 Code:
--------------------
<?php
 var_dump(get_html_translation_table(HTML_SPECIALCHARS,ENT_QUOTES));
 var_dump(htmlspecialchars('\'',ENT_QUOTES));
?>
--------------------
 Output:
--------------------
array
 '"' => '&quot;'
 ''' => '&#39;'
 '<' => '&lt;'
 '>' => '&gt;'
 '&' => '&amp;'
'&#039;'
--------------------
This comment now is not to report this bug again (though I really believe it is one), but to complete the example and warn people of this pitfall.
To make sure your htmlspecialchars_decode fake for PHP4 works, you should do something like this:
<?php
 function htmlspecialchars_decode($string,$style=ENT_COMPAT)
 {
 $translation = array_flip(get_html_translation_table(HTML_SPECIALCHARS,$style));
 if($style === ENT_QUOTES){ $translation['&#039;'] = '\''; }
 return strtr($string,$translation);
 }
?>

Br, Thomas

down

-2

Anonymous ¶

19 years ago

This should be the best way to do it.
(Reposted because the other one seems a bit slower and because those who used the code under called it htmlspecialchars_decode_php4)
<?php
if ( !function_exists('htmlspecialchars_decode') )
{
 function htmlspecialchars_decode($text)
 {
 return strtr($text, array_flip(get_html_translation_table(HTML_SPECIALCHARS)));
 }
}
?>

down

-3

or-k at or-k dot com ¶

20 years ago

that works also with &auml; and &quot; and so on.
get_html_translation_table(HTML_ENTITIES) => offers more characters than HTML_SPECIALCHARS
function htmlspecialchars_decode_PHP4($uSTR)
{
 return strtr($uSTR, array_flip(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES)));
}

+Добавить