Htmlspecialchars decode: примеры (PHP)

Примеры использования htmlspecialchars_decode

Преобразование основных сущностей.

<?php
$str = "&lt;a href=&#039;test&#039;&gt;link&lt;/a&gt;";
echo htmlspecialchars_decode($str);
?>

<a href='test'>link</a>

<?php
$str = "&lt;a href=&#039;test&#039;&gt;link&lt;/a&gt;";
echo htmlspecialchars_decode($str, ENT_QUOTES);
?>

<a href='test'>link</a>

<?php
$str = "&quot;Hello&quot; &amp; &#039;World&#039;";
echo htmlspecialchars_decode($str, ENT_NOQUOTES);
?>

"Hello" & 'World'

Похожие функции в PHP

Функция html_entity_decode преобразует все HTML-сущности, а не только специальные. Она полезна, когда требуется декодировать широкий спектр сущностей, например, символы Unicode.

Функция strip_tags удаляет HTML и PHP-теги из строки. Она применяется, когда необходимо полностью удалить разметку, а не преобразовывать сущности. Функция не восстанавливает символы из сущностей.

Функцию htmlspecialchars_decode используют для обратного преобразования сущностей, созданных функцией htmlspecialchars. Если исходные данные были обработаны через htmlentities, то применяют html_entity_decode. Для удаления разметки подходит strip_tags.

Типичные ошибки

Неоднократный вызов функции приводит к непредвиденным результатам.

<?php
$str = "&amp;lt;";
echo htmlspecialchars_decode(htmlspecialchars_decode($str));
?>

<

Использование флага, не соответствующего способу первоначального экранирования.

<?php
$str = "&#039;test&#039;";
// Если исходное преобразование использовало ENT_QUOTES
// А декодирование — ENT_COMPAT
$result = htmlspecialchars_decode($str, ENT_COMPAT);
echo $result;
?>

'test'

Несоответствие кодировки может привести к некорректному преобразованию символов.

Изменения в PHP

Параметр encoding стал необязательным. Значение по умолчанию изменено на null, что приводит к использованию внутренней кодировки. Функция теперь возвращает пустую строку при передаче неверной кодировки, вместо выдачи предупреждения.

Добавлены константы ENT_HTML401, ENT_XML1, ENT_XHTML и ENT_HTML5.

Расширенные примеры

Функция применяется ко всем элементам массива.

<?php
$data = [
    'title' => "&lt;h1&gt;Title&lt;/h1&gt;",
    'desc' => "&amp;copy; 2023"
];
$decoded = array_map('htmlspecialchars_decode', $data);
print_r($decoded);
?>

Array
(
    [title] => <h1>Title</h1>
    [desc] => &copy; 2023
)

Очистка строки с последующим преобразованием.

<?php
$str = "   &lt;p&gt;Text&lt;/p&gt;   ";
$result = htmlspecialchars_decode(trim($str));
echo $result;
?>

<p>Text</p>

<?php
$str = "&lt;section&gt;&amp;ndash;content&lt;/section&gt;";
echo htmlspecialchars_decode($str, ENT_QUOTES | ENT_HTML5);
?>

<section>&ndash;content</section>

<?php
$text = "&lt;pre&gt;Line 1
Line 2&lt;/pre&gt;";
echo htmlspecialchars_decode($text);
?>

<pre>Line 1
Line 2</pre>

<?php
$json = '{"text": "&lt;div&gt;Test&lt;/div&gt;"}';
$data = json_decode($json, true);
$data['text'] = htmlspecialchars_decode($data['text']);
echo $data['text'];
?>

<div>Test</div>

Аналоги в других языках

Htmlspecialchars decode в Python

В языке Python функция html.unescape() из модуля html выполняет аналогичные действия.

import html
str = "<a href='test'>link</a>"
print(html.unescape(str))

<a href='test'>link</a>

Htmlspecialchars decode в Javascript

В JavaScript для преобразования HTML-сущностей используют свойство innerHTML элемента или функцию he.decode из библиотеки he.

const str = "<a href='test'>link</a>";
const textArea = document.createElement('textarea');
textArea.innerHTML = str;
console.log(textArea.value);

<a href='test'>link</a>

Htmlspecialchars decode в MySQL

В языке SQL прямой аналогичной функции не существует. Обычно преобразование выполняют на стороне приложения. Возможно использование функции REPLACE для замены конкретных сущностей, но это не универсальное решение.