функция
since 2.9.0
sanitize_text_field()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
sanitize_text_field( string $str ): stringОписание
Проверяет на недопустимый UTF-8,
Преобразует одиночные символы < в сущности Удаляет все теги Удаляет переносы строк, табуляции и лишние пробелы Удаляет символы в процентном кодировании См. alsosanitize_textarea_field() wp_check_invalid_utf8() wp_strip_all_tags()
Оригинал (английский)
- Checks for invalid UTF-8,
- Converts single
<characters to entities - Strips all tags
- Removes line breaks, tabs, and extra whitespace
- Strips percent-encoded characters
Параметры
$str
string
обязательный
Строка для очистки.
Возвращаемое значение
string
Исходный код
wp-includes/formatting.php:5581
function sanitize_text_field( $str ) {
$filtered = _sanitize_text_fields( $str, false );
/**
* Filters a sanitized text field string.
*
* @since 2.9.0
*
* @param string $filtered The sanitized string.
* @param string $str The string prior to being sanitized.
*/
return apply_filters( 'sanitize_text_field', $filtered, $str );
}История изменений
| Версия | Описание |
|---|---|
| 2.9.0 | Introduced. |
