常用函数-wp_insert_user()
说明
在数据库中创建用户。
根据用户编号是否存在对现有用户进行更新或创建一个新用户。
该函数可更新用户信息(见下文),设定用户角色,并使用富文本编辑器来设置用户首选项。
用法
<?php wp_insert_user( $userdata ) ?>
参数
$userdata
(数组)(必需)用户资料数组
默认值: None
返回的值
(整数)
新创建用户的编号
示例
注释
- 用法: $wpdb WordPress数据库层
- 用法:apply_filters() 为大多数带有'pre_user'前缀的$userdata字段调用过滤器。参见上文中的“说明”。
- 用法:更新所给的用户编号时, do_action()调用'profile_update'钩子
- 用法:根据所给的用户编号创建新用户时, do_action() 调用'user_register'钩子
$userdata数组可能包含以下字段
字段名称 | 说明 | 联合过滤器 |
ID | 整数,用来更新已存在用户 | (none) |
user_pass | 字符串,其中包含用户的纯文本密码 | pre_user_user_pass |
user_login | 字符串,其中包含用户登录所用的用户名 | pre_user_user_login |
user_nicename | 字符串,其中包含用户的昵称。默认为用户名。 | pre_user_user_nicename |
user_url | 字符串,其中包含用户网站的URL。 | pre_user_user_url |
user_email | 字符串,其中包含用户的电子邮件地址。 | pre_user_user_email |
display_name | 字符串,将显示在网站上。默认为用户的用户名。出于外观和隐藏安全考虑,最好改变默认显示名称(在不使用默认管理者用户名并将其删除的情况下)。 | pre_user_display_name |
nickname | 用户昵称,默认为用户名。 | pre_user_nickname |
first_name | 用户名称 | pre_user_first_name |
last_name | 用户姓氏 | pre_user_last_name |
description | 字符串,其中包含用户信息 | pre_user_description |
rich_editing | 字符串,决定是否激活富文本编辑器。若字符串不为空则默认值为false | (none) |
user_registered | 用户注册日期。格式为年-月-日 时:分:秒 | (none) |
role | 字符串,用以设定用户的角色 | (none) |
jabber | 用户的jabber账户 | (none) |
aim | 用户的AOL即时通讯账号 | (none) |
yim | 用户的Yahoo即时通讯账号 | (none) |
修改记录
自2.0.0版本后
源文件
wp_insert_user()位于 wp-includes/registration.php中。
相关资源
分类:中文手册