## Функция sanitize_textarea_field() │ WP 4.7.0
Функция sanitize_textarea_field() очищает многострочные строки, которые вводит пользователь или которые хранятся в базе данных.
Эта функция работает похоже на sanitize_text_field(), но сохраняет переносы строк (n) и другие пробелы, которые являются допустимыми символами в элементах textarea (текстовых областях).
### Применение
Функция использует внутреннюю функцию _sanitize_text_fields().
- Затраты времени: 1 раз — 0.000098 сек (очень быстро) | 50000 раз — 1.17 сек (быстро) | PHP 7.1.2, WP 4.7.3
### Хуки функции
- sanitize_textarea_field
### Возвращаемое значение
Строка. Очищенная строка.
### Использование
```php
sanitize_textarea_field( $str );$str(string, обязательный) — строка, которую нужно очистить.
Примеры
- Пример использования функции:
$text = 'Проверьте, как/em>
очистилась > (строка) <
. ';
$text = sanitize_textarea_field( $text );
var_dump( $text );
/*
string(80) "Проверьте, как
очистилась > (строка) < ."
*/- Очистка другой строки:
var_dump( sanitize_text_field( "ビットコイン | 比特币" ) );
// string(30) "ビットコイン | 比特币"Заметки
- См. также:
sanitize_text_field()
Изменения
- С версии 4.7.0 — введено.
Код функции sanitize_textarea_field() WP 6.7.2
Файл: wp-includes/formatting.php
function sanitize_textarea_field( $str ) {
$filtered = _sanitize_text_fields( $str, true );
/**
* Фильтрует очищенную строку текстового поля.
*
* @since 4.7.0
*
* @param string $filtered Очищенная строка.
* @param string $str Строка до очистки.
*/
return apply_filters( 'sanitize_textarea_field', $filtered, $str );
}Связанные функции
Функции для очистки:
sanitize_email()sanitize_file_name()sanitize_html_class()sanitize_key()sanitize_meta()sanitize_mime_type()sanitize_option()sanitize_post()sanitize_post_field()sanitize_sql_orderby()sanitize_term()sanitize_term_field()sanitize_text_field()sanitize_title()sanitize_title_for_query()sanitize_title_with_dashes()sanitize_url()sanitize_user()wc_clean()wp_check_invalid_utf8()
Процессы очистки и экранирования
Функции для экранирования:
esc_attr()esc_html()esc_js()esc_textarea()esc_url()esc_url_raw()tag_escape()validate_file()wp_filter_kses()wp_filter_nohtml_kses()wp_filter_post_kses()wp_kses()wp_kses_data()wp_strip_all_tags()