函数 wp_signon() 用于用户登录并创建会话。

用法:

wp_signon( $credentials, $secure_cookie );

参数:
- `$credentials` (必需)(数组类型):包含登录信息的数组。通常包括用户名和密码,可以添加其他字段,如“remember”(记住我)。
- `$secure_cookie` (可选)(布尔类型):指定是否使用安全的 cookie。默认为 false。

返回值:
- 成功登录则返回 WP_User 对象,包含用户信息。
- 登录失败则返回 WP_Error 对象,包含错误信息。

示例:

$credentials = array(
'user_login' => 'username',
'user_password' => 'password',
'remember' => true
);

$user = wp_signon( $credentials, false );

if ( is_wp_error( $user ) ) {
echo $user->get_error_message();
} else {
echo '登录成功!';
}

此示例中,将用户名和密码存储在 `$credentials` 数组中,并传递给 wp_signon() 函数。设置 'remember' 为 true,表示记住登录状态。如果登录成功,则返回成功信息。如果登录失败,则返回错误信息。

注意:wp_signon() 函数仅用于验证用户登录,不会向用户发送任何电子邮件通知,也不会触发任何其他操作。