# sanitize_key()

URL: https://chugunov.pro/api-wordpress/functions/sanitize_key/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.0.0.

## Сигнатура

```php
sanitize_key( string $key ): string
```

## Описание

Ключи используются как внутренние идентификаторы. Допускаются строчные буквы и цифры, дефисы и подчёркивания.

## Параметры

- `$key` `string` — обязательный. Строковый ключ.

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-includes/formatting.php:2190`

```php
function sanitize_key( $key ) {
	$sanitized_key = '';

	if ( is_scalar( $key ) ) {
		$sanitized_key = strtolower( $key );
		$sanitized_key = preg_replace( '/[^a-z0-9_\-]/', '', $sanitized_key );
	}

	/**
	 * Filters a sanitized key string.
	 *
	 * @since 3.0.0
	 *
	 * @param string $sanitized_key Sanitized key.
	 * @param string $key           The key prior to sanitization.
	 */
	return apply_filters( 'sanitize_key', $sanitized_key, $key );
}
```

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

- 3.0.0 — Introduced.

## Связанные

Использует: [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: `WP_Plugin_Dependencies::check_plugin_dependencies_during_ajax`, [`_wp_filter_post_meta_footnotes`](https://chugunov.pro/api-wordpress/functions/_wp_filter_post_meta_footnotes/), `WP_Duotone::render_duotone_support`, `WP_Style_Engine_CSS_Declarations::sanitize_property`, [`wp_create_user_request`](https://chugunov.pro/api-wordpress/functions/wp_create_user_request/), [`_wp_personal_data_handle_actions`](https://chugunov.pro/api-wordpress/functions/_wp_personal_data_handle_actions/), [`wp_start_scraping_edited_file_errors`](https://chugunov.pro/api-wordpress/functions/wp_start_scraping_edited_file_errors/), `WP_Customize_Manager::handle_load_themes_request`, `WP_Theme::get_post_templates`, [`wp_ajax_search_install_plugins`](https://chugunov.pro/api-wordpress/functions/wp_ajax_search_install_plugins/), [`wp_ajax_delete_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_delete_plugin/), [`wp_ajax_search_plugins`](https://chugunov.pro/api-wordpress/functions/wp_ajax_search_plugins/), [`wp_ajax_install_theme`](https://chugunov.pro/api-wordpress/functions/wp_ajax_install_theme/), [`wp_ajax_install_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_install_plugin/), `WP_Customize_Nav_Menu_Item_Setting::sanitize`, `WP_Customize_Nav_Menus::ajax_load_available_items`, [`wp_ajax_update_plugin`](https://chugunov.pro/api-wordpress/functions/wp_ajax_update_plugin/), `WP_Query::parse_orderby`, `WP_Screen::get`, `WP_Plugins_List_Table::__construct`, [`export_wp`](https://chugunov.pro/api-wordpress/functions/export_wp/), `WP_List_Table::__construct`, [`update_user_status`](https://chugunov.pro/api-wordpress/functions/update_user_status/), [`set_screen_options`](https://chugunov.pro/api-wordpress/functions/set_screen_options/), [`post_preview`](https://chugunov.pro/api-wordpress/functions/post_preview/), [`wp_ajax_heartbeat`](https://chugunov.pro/api-wordpress/functions/wp_ajax_heartbeat/), [`wp_ajax_save_user_color_scheme`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_user_color_scheme/), [`_wp_translate_postdata`](https://chugunov.pro/api-wordpress/functions/_wp_translate_postdata/), [`edit_post`](https://chugunov.pro/api-wordpress/functions/edit_post/), [`bulk_edit_posts`](https://chugunov.pro/api-wordpress/functions/bulk_edit_posts/), [`wp_ajax_dismiss_wp_pointer`](https://chugunov.pro/api-wordpress/functions/wp_ajax_dismiss_wp_pointer/), [`wp_ajax_closed_postboxes`](https://chugunov.pro/api-wordpress/functions/wp_ajax_closed_postboxes/), [`wp_ajax_hidden_columns`](https://chugunov.pro/api-wordpress/functions/wp_ajax_hidden_columns/), [`wp_ajax_meta_box_order`](https://chugunov.pro/api-wordpress/functions/wp_ajax_meta_box_order/), [`wp_ajax_inline_save_tax`](https://chugunov.pro/api-wordpress/functions/wp_ajax_inline_save_tax/), [`wp_ajax_get_tagcloud`](https://chugunov.pro/api-wordpress/functions/wp_ajax_get_tagcloud/), [`wp_ajax_nopriv_heartbeat`](https://chugunov.pro/api-wordpress/functions/wp_ajax_nopriv_heartbeat/), [`wp_ajax_ajax_tag_search`](https://chugunov.pro/api-wordpress/functions/wp_ajax_ajax_tag_search/), `WP_Comments_List_Table::prepare_items`, `WP_Customize_Manager::__construct`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/sanitize_key/