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方法提供适用于可以选填密码并更改的表单的验证规则。