# get_usermeta()

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

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

> Устаревший элемент. Помечен устаревшим с версии 3.0.0.

## Сигнатура

```php
get_usermeta( int $user_id, string $meta_key = '' ): mixed
```

## Описание

Если $user_id не является числом, функция завершится с возвращаемым логическим значением 'false'. Остальные возвращаемые значения зависят от того, возвращается ли только один элемент — в этом случае это будет значение соответствующего типа. Если значений метаданных несколько, то возвращается список значений метаданных.
См. alsoget_user_meta()

## Параметры

- `$user_id` `int` — обязательный. ID пользователя
- `$meta_key` `string` — необязательный, по умолчанию `''`. Ключ метаданных.

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

`mixed`

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

Файл: `wp-includes/deprecated.php:2280`

```php
function get_usermeta( $user_id, $meta_key = '' ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'get_user_meta()' );
	global $wpdb;
	$user_id = (int) $user_id;

	if ( !$user_id )
		return false;

	if ( !empty($meta_key) ) {
		$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);
		$user = wp_cache_get($user_id, 'users');
		// Check the cached user object.
		if ( false !== $user && isset($user->$meta_key) )
			$metas = array($user->$meta_key);
		else
			$metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );
	} else {
		$metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d", $user_id) );
	}

	if ( empty($metas) ) {
		if ( empty($meta_key) )
			return array();
		else
			return '';
	}

	$metas = array_map('maybe_unserialize', $metas);

	if ( count($metas) === 1 )
		return $metas[0];
	else
		return $metas;
}
```

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

- 3.0.0 — Deprecated. Use get_user_meta()
- 2.0.0 — Introduced.

## Связанные

Использует: `wpdb::get_col`, [`wp_cache_get`](https://chugunov.pro/api-wordpress/functions/wp_cache_get/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/), `wpdb::prepare`.

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