检索用户元数据。
原型
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/