函数描述
通过用户的某属性字段获取用户数据对象,可用的属性为下面几种的任意一个,分别对应 wp_users 数据表的的相应列。
- ‘id’ – 用户 ID
- ‘slug’ – user_nicename 用户昵称
- ’email’ – user_email 用户电子邮件
- ‘login’ – user_login 用户登录名称
使用方法
$user = get_user_by( $field, $value );
参数
参数 | 数据类型 | 是否必需 | 描述 | 默认值 |
---|---|---|---|---|
$field | 字符串 | 是 | ‘id’, ‘slug’, ’email’, 或 ‘login’ | 无 |
$value | 整数|字符串 | 是 | 用户字段对应的值 | 无 |
返回值
(mixed) 如果找到了用户,返回 WP_User 对象,如果找不到用户,或 $field 字段不存在,返回 false
使用示例
默认使用
$user = get_user_by( 'email', 'user@example.com' );
echo '用户:' . $user->first_name . ' ' . $user->last_name;
如果需要使用更多的字段,可以把获取到的 $user 用 print_r() 函数打印出来查看。