README

此包提供了遵循NIST特别出版物800-63B第5节中找到的密码相关建议的Laravel验证规则。

Laravel NIST密码规则实现了以下建议。

它还提供了返回用于各种场景的验证规则数组的函数，例如注册、登录和密码更改。这些数组可以直接传递给Laravel验证器。

安装

您可以使用Composer轻松安装Laravel NIST密码规则。只需从项目的根目录运行以下命令。

composer require langleyfoxall/laravel-nist-password-rules

如果您以前从未使用过Composer依赖管理器，请访问Composer网站以获取有关如何开始的更多信息。

可选地，您可以使用以下Artisan命令发布包的翻译文件。

php artisan vendor:publish --provider="LangleyFoxall\LaravelNISTPasswordRules\ServiceProvider"

用法

要在项目中使用Laravel NIST密码规则，首先使用use指令引入PasswordRules类，然后调用适当的静态方法以返回适当的验证规则数组。以下场景有可用方法。

• 注册
• 更改密码，带有旧密码
• 更改密码，不带旧密码
• 可选更改密码，带有旧密码
• 可选更改密码，不带旧密码
• 登录

请参阅以下示例用法语法。

use LangleyFoxall\LaravelNISTPasswordRules\PasswordRules;

// Register
$this->validate($request, [
    'email' => 'required',
    'password' => PasswordRules::register($request->email),
]);

// Register, without requiring password confirmation
$this->validate($request, [
    'email' => 'required',
    'password' => PasswordRules::register($request->email, false),
]);

// Change password, with old password
$this->validate($request, [
    'old_password' => 'required',
    'password' => PasswordRules::changePassword($request->email, 'old_password'),
]);

// Change password, without old password
$this->validate($request, [
    'password' => PasswordRules::changePassword($request->email),
]);

// Optionally change password, with old password
$this->validate($request, [
    'old_password' => 'required',
    'password' => PasswordRules::optionallyChangePassword($request->email, 'old_password'),
]);

// Optionally change password, without old password
$this->validate($request, [
    'password' => PasswordRules::optionallyChangePassword($request->email),
]);

// Login
$this->validate($request, [
    'email' => 'required',
    'password' => PasswordRules::login(),
]);

optionallyChangePassword方法提供了适用于密码可选项（如果填写）更改的表单的验证规则。