# Функция WC_CLEAN() │ WC 1.0
Функция wc_clean() очищает переданные данные (переменные) с помощью функции sanitize_text_field(). Если переданы массивы, то они очищаются рекурсивно.
Эта функция обрабатывает только массивы и скалярные значения (числа, строки). Невозможные для обработки значения игнорируются.
## Возврат
- **String|Array**: Функция может вернуть строку или массив.
## Использование
```php
wc_clean( $var );$var(string|array) (обязательный): Данные, которые необходимо очистить.
Примеры
Пример 1
wc_clean( 'Проверяем, как очищается (стро��а)
.' );
//> 'Проверяем, как очищается (строка) .'Пример 2
wc_clean( 'http://example.com/foo.php#bar' );
//> 'http://example.com/foo.php#bar'Пример 3
Функция также может обрабатывать массивы:
$data = [
'say' => 'Привет,
пользователь!',
'Абзац с текстом
',
'Обычный текст',
];
wc_clean( $data );
/*
Array
(
[say] => Привет, пользователь!
[0] => Абзац с текстом
[1] => Обычный текст
)
*/Как работает функция
Вот как выглядит код функции wc_clean():
function wc_clean( $var ) {
if ( is_array( $var ) ) {
return array_map( 'wc_clean', $var ); // Рекурсивно очищает массив
} else {
return is_scalar( $var ) ? sanitize_text_field( $var ) : $var; // Очищает строку или число
}
}
Связанные функции
Санитация
sanitize_email()– очищает email-адрес.sanitize_file_name()– очищает имя файла.sanitize_html_class()– очищает имена классов HTML.sanitize_key()– очищает ключи массива.sanitize_meta()– очищает метаданные.sanitize_mime_type()– очищает MIME-тип.sanitize_option()– очищает опции.sanitize_post()– очищает данные записи.sanitize_post_field()– очищает поле записи.sanitize_sql_orderby()– очищает порядок в SQL-запросах.sanitize_term()– очищает термин.sanitize_term_field()– очищает поле термина.sanitize_text_field()– очищает текстовое поле.sanitize_textarea_field()– очищает текстовую область.sanitize_title()– очищает заголовок.sanitize_title_for_query()– очищает заголовок для запросов.sanitize_title_with_dashes()– очищает заголовок, заменяя пробелы на дефисы.sanitize_url()– очищает URL.sanitize_user()– очищает данные пользователя.wp_check_invalid_utf8()– проверяет наличие неверных символов UTF-8.
WooCommerce
get_woocommerce_currencies()– получает валюты WooCommerce.get_woocommerce_currency()– получает валюту WooCommerce.WC()– получает объект WooCommerce.wc_body_class()– добавляет классы к тегу<body>.wc_dropdown_variation_attribute_options()– создает выпадающий список с вариантами.wc_format_phone_number()– форматирует номер телефона.wc_get_cart_url()– получает URL корзины.wc_get_checkout_url()– получает URL страницы оформления заказа.wc_get_order()– получает заказ.wc_get_product_id_by_sku()– получает ID продукта по SKU.wc_get_weight()– получает вес продукта.woocommerce_form_field()– создает поле для форм в WooCommerce.woocommerce_mini_cart()– отображает мини-корзину.woocommerce_wp_text_input()– создает текстовое поле в админке WooCommerce.