WordPress更新用户信息函数wp_update_user详解

最近在做前端用户中心的时候，遇到需要更新WordPress用户信息的情况，WordPress更新用户信息主要通过wp_update_user函数来实现，当然还有很多方法可以做到，比如直接操作数据库。不过，既然WordPress提供了相应方法，我们还是不要自己折腾了。很多WordPress的方法是兼容WordPress的对象缓存的，没必要耗费精力。

WordPress教程

wp_update_user函数不仅可以更新用户资料，还能更新用户密码，官方描述如下：

通过指定$userdata数组中的对应字段更新数据，如果更新密码，用户的cookies也会被清除。

函数原型：

wp_update_user( array|object|WP_User $userdata )

内容有点多，这里不贴了，该函数位于wp-includes/user.php文件的第1879行左右，也可以点击查看在线文档：https://developer.wordpress.org/reference/files/wp-includes/user.php/

参数

$userdata

(数组|对象|WP_User) (必须) 用户数据数组或stdClass类型的用户对象或者wp_user。

返回值

(整型|WP_Error) 更新成功返回用户id,失败返回wp_error错误对象。

简单使用

<?php $user_id = 6; $website = 'http://example.com'; $user_data = wp_update_user( array( 'ID' => $user_id, 'user_url' => $website ) );
 
if ( is_wp_error( $user_data ) ) {
    // There was an error; possibly this user doesn't exist.
    echo 'Error.';
} else {
    // Success!
    echo 'User profile updated.';
}
?>

说明：$userdata数组中的数据，应对呀WordPress用户的对应字段。具体字段信息请看WordPress函数wp_insert_user注册新用户一文中关于wp_insert_user函数的$userdata参数的详解！