get_usermeta()

检索用户元数据。

原型

get_usermeta( int $user_id, string $meta_key = '' )

描述

如果$ user_id不是数字，则该函数将使用’false’布尔返回值进行故障转移。其他返回值取决于是否只返回一个项目，即该单项类型。如果有多个元数据值，则它将是元数据值列表。

参考：

• get_user_meta()

参数

$user_id (int) (Required) 用户身份

$meta_key (string) (Optional)  元数据键。

返回值

(mixed)  

源文件

路径：wp-includes/deprecated.php

<?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;
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/get_usermeta/