Функция SANITIZE_TITLE_FOR_QUERY() в WordPress 3.1.0: описание и примеры

## Функция SANITIZE_TITLE_FOR_QUERY() │ WP 3.1.0

Функция sanitize_title_for_query() очищает заголовок для использования в запросах к базе данных.

Она используется для обработки значений, которые мы получаем из URL.

**Скорость работы:**  
- 1 раз — 0.000071 секунды (очень быстро)  
- 50000 раз — 0.90 секунды (тоже очень быстро)  

### Обратите внимание

Эта функция не имеет хуков. Это означает, что вы не можете изменить её поведение с помощью дополнительных функций.

### Что она возвращает

**Результат:** строка. Очищенная строка.

### Использование

```php
sanitize_title_for_query( $title );

• $title (строка) (обязательный параметр) — это строка, которую нужно очистить.

Примеры использования

Вот несколько примеров, показывающих, как очищать строки для использования в запросах:

// Проверка
echo sanitize_title_for_query( 'hello world' ); // hello-world

Этот код преобразует строку 'hello world' в 'hello-world', заменяя пробел на дефис.

// Подготовка строки для SQL запроса
$parts = esc_sql( $parts ); // сначала очищаем строку
$parts = array_map( 'sanitize_title_for_query', $parts ); // применяем очистку к каждому элементу массива
$in_string = "'" . implode( "','", $parts ) . "'"; // соединяем элементы в строку

Примечание

Также можно использовать функцию для очистки имени страницы:

// Подготовка имени страницы для SQL запроса
$pagename = sanitize_title_for_query( wp_basename( $pagename ) );

История изменений

• С версии 3.1.0 — функция была введена.

Код функции

Вот как выглядит код этой функции:

function sanitize_title_for_query( $title ) {
return sanitize_title( $title, '', 'query' );
}

Похожие функции

Существует несколько других функций, которые также помогают очищать данные:

• 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_textarea_field()
• sanitize_title()
• sanitize_title_with_dashes()
• sanitize_url()
• sanitize_user()
• wc_clean()
• wp_check_invalid_utf8()

Эти функции помогают обрабатывать разные типы данных, чтобы они были безопасными для использования в запросах и других процессах.