# sanitize_meta()

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

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

## Сигнатура

```php
sanitize_meta( string $meta_key, mixed $meta_value, string $object_type, string $object_subtype = '' ): mixed
```

## Описание

Очищает значение метаданных.

## Параметры

- `$meta_key` `string` — обязательный. Ключ метаданных.
- `$meta_value` `mixed` — обязательный. Значение метаданных для очистки.
- `$object_type` `string` — обязательный. Тип объекта, к которому относятся метаданные. Принимает 'blog', 'post', 'comment', 'term', 'user' или любой другой тип объекта со связанной таблицей метаданных.
- `$object_subtype` `string` — необязательный, по умолчанию `''`. Подтип типа объекта.

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

`mixed`

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

Файл: `wp-includes/meta.php:1342`

```php
function sanitize_meta( $meta_key, $meta_value, $object_type, $object_subtype = '' ) {
	if ( ! empty( $object_subtype ) && has_filter( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}" ) ) {

		/**
		 * Filters the sanitization of a specific meta key of a specific meta type and subtype.
		 *
		 * The dynamic portions of the hook name, `$object_type`, `$meta_key`,
		 * and `$object_subtype`, refer to the metadata object type (blog, comment, post, term, or user),
		 * the meta key value, and the object subtype respectively.
		 *
		 * @since 4.9.8
		 *
		 * @param mixed  $meta_value     Metadata value to sanitize.
		 * @param string $meta_key       Metadata key.
		 * @param string $object_type    Type of object metadata is for. Accepts 'blog', 'post', 'comment', 'term',
		 *                               'user', or any other object type with an associated meta table.
		 * @param string $object_subtype Object subtype.
		 */
		return apply_filters( "sanitize_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $meta_value, $meta_key, $object_type, $object_subtype );
	}

	/**
	 * Filters the sanitization of a specific meta key of a specific meta type.
	 *
	 * The dynamic portions of the hook name, `$meta_type`, and `$meta_key`,
	 * refer to the metadata object type (blog, comment, post, term, or user) and the meta
	 * key value, respectively.
	 *
	 * @since 3.3.0
	 *
	 * @param mixed  $meta_value  Metadata value to sanitize.
	 * @param string $meta_key    Metadata key.
	 * @param string $object_type Type of object metadata is for. Accepts 'blog', 'post', 'comment', 'term',
	 *                            'user', or any other object type with an associated meta table.
	 */
	return apply_filters( "sanitize_{$object_type}_meta_{$meta_key}", $meta_value, $meta_key, $object_type );
}
```

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

- 4.9.8 — The $object_subtype parameter was added.
- 3.1.3 — Introduced.

## Связанные

Использует: [`has_filter`](https://chugunov.pro/api-wordpress/functions/has_filter/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: `WP_REST_Meta_Fields::is_meta_value_same_as_stored_value`, [`update_metadata_by_mid`](https://chugunov.pro/api-wordpress/functions/update_metadata_by_mid/), [`add_metadata`](https://chugunov.pro/api-wordpress/functions/add_metadata/), [`update_metadata`](https://chugunov.pro/api-wordpress/functions/update_metadata/).

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