get_usermeta()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_usermeta( int $user_id, string $meta_key = '' ): mixedОписание
Если $user_id не является числом, функция завершится с возвращаемым логическим значением 'false'. Остальные возвращаемые значения зависят от того, возвращается ли только один элемент — в этом случае это будет значение соответствующего типа. Если значений метаданных несколько, то возвращается список значений метаданных.
См. alsoget_user_meta()
Оригинал (английский)
If $user_id is not a number, then the function will fail over with a ‘false’ boolean return value. Other returned values depend on whether there is only one item to be returned, which be that single item type. If there is more than one metadata value, then it will be list of metadata values.
Параметры
$user_id
int
обязательный
$meta_key
string
необязательный
= ''
Возвращаемое значение
mixed
Исходный код
wp-includes/deprecated.php:2280
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-_]|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. |
