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.

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

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 для замены конкретных сущностей, но это не универсальное решение.

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

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

<?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>