钩子文档

check_passwords

💡 云策文档标注

概述

check_passwords 是一个 WordPress Hook,在检查密码和确认密码字段一致性之前触发。它允许开发者在密码验证前修改或处理密码数据。

关键要点

  • 触发时机:在密码和确认密码字段进行一致性检查之前执行。
  • 参数:$user_login(用户名)、$pass1(密码,引用传递)、$pass2(确认密码,引用传递)。
  • 用途:常用于 edit_user() 函数中,基于 $_POST 内容编辑用户设置。
  • 版本:自 WordPress 1.5.1 版本引入。

代码示例

do_action_ref_array( 'check_passwords', array( $user->user_login, &$pass1, &$pass2 ) );

📄 原文内容

Fires before the password and confirm password fields are checked for congruity.

Parameters

$user_loginstring
The username.
$pass1string
The password (passed by reference).
$pass2string
The confirmed password (passed by reference).

Source

do_action_ref_array( 'check_passwords', array( $user->user_login, &$pass1, &$pass2 ) );

Changelog

Version Description
1.5.1 Introduced.