wp_specialchars_decode() │ WP 2.8.0
Конвертує (декодує) HTML сутності у їх HTML символи. Змінює лише:&, <, >, ", '
Якщо потрібно кодувати символи по суті, використовуйте esc_html()
Майте на увазі, що ця функція декодує не всі сутності. Наприклад, вона не декодує –(-).
Якщо потрібно декодувати всі символи, використовуйте html_entity_decode() .
1 раз – 0.000094 сек
(дуже швидко) | 50000 разів – 1.08 сек
(швидко)
Хуків немає.
Повертає
Строку. Декодований текст без HTML сутності.
Використання
wp_specialchars_decode($string, $quote_style);
-
$string
(рядок) (обов’язковий) -
Текст, який потрібно опрацювати.
-
$quote_style
(рядок/число) Визначає, як декодувати лапки. Може бути:
ENT_COMPATабо 'double'— змінювати лише подвійні лапки: “ .ENT_QUOTES– Змінювати обидва види лапок: “ і “ .'single'– Змінювати тільки одинарні лапки: ‘ .ENT_NOQUOTES– Не чіпає лапки взагалі.
Типово: ENT_NOQUOTES
Приклади
#1 Замінимо HTML сутності на звичні символи HTML
$string = <<<'TEXT'
амперсанд - & / & # 038; / & # x26;
одинарні лапки - ' / & # x27;
подвійні лапки - " / & # 034; / & # x22;
більше - > / & # 062;
менше - < / & # 060;
TEXT;
echo wp_specialchars_decode( $string, ENT_QUOTES );
/* виведе:
амперсанд - & / & / &
одинарні лапки - '/'
подвійні лапки - " / " / "
більше - > / >
менше - < / <
*/
список змін
wp specialchars decode WP 6.0.2
function wp_specialchars_decode( $string, $quote_style = ENT_NOQUOTES ) {
$string = (string) $string;
if ( 0 === strlen( $string ) ) {
return '';
}
// Не треба, якщо не є предметом, - несуть багато процесів.
if ( strpos( $string, '&' ) === false ) {
return $string;
}
// Match the previous behaviour of _wp_specialchars() when the $quote_style is not an accepted value.
if (empty($quote_style)) {
$quote_style = ENT_NOQUOTES;
} elseif ( ! in_array( $quote_style, array( 0, 2, 3, 'single', 'double' ), true ) ) {
$quote_style = ENT_QUOTES;
}
// More complete than get_html_translation_table( HTML_SPECIALCHARS ).
$single = array(
''' => ''',
''' => ''',
);
$single_preg = array(
'/�*39;/' => ''',
'/�*27;/i' => ''',
);
$ double = array (
'"' => ''',
'"' => ''',
'"' => ''',
);
$ double_preg = array (
'/�*34;/' => '"',
'/�*22;/i' => '"',
);
$others = array(
'<' => '<',
'<' => '<',
'>' => '>',
'>' => '>',
'&' => '&',
'&' => '&',
'&' => '&',
);
$others_preg = array(
'/�*60;/' => '<',
'/�*62;/' => '>',
'/�*38;/' => '&',
'/�*26;/i' => '&',
);
if ( ENT_QUOTES === $quote_style ) {
$translation = array_merge( $single, $double, $others );
$translation_preg = array_merge( $single_preg, $double_preg, $others_preg );
} elseif ( ENT_COMPAT === $quote_style || 'double' === $quote_style ) {
$translation = array_merge( $double, $others );
$translation_preg = array_merge( $double_preg, $others_preg );
} elseif ( 'single' === $quote_style ) {
$translation = array_merge( $single, $others );
$translation_preg = array_merge( $single_preg, $others_preg );
} elseif ( ENT_NOQUOTES === $quote_style ) {
$translation = $others;
$translation_preg = $others_preg;
}
// Remove zero padding on numeric entities.
$string = preg_replace( array_keys( $translation_preg ), array_values( $translation_preg ), $string );
// Replace characters відповідно до translation table.
return strtr ($ string, $ translation);
} Зв’язані функції
