README

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

Laravel NIST Password Rules实现了以下建议。

它还提供了返回针对各种场景（如注册、登录和密码更改）的验证规则数组的方法。这些数组可以直接传递给Laravel验证器。

安装

可以使用Composer轻松安装Laravel NIST Password Rules。只需从项目根目录运行以下命令。

composer require langleyfoxall/laravel-nist-password-rules

如果您之前从未使用过Composer依赖管理器，请访问Composer网站了解如何开始。

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

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

用法

要在项目中使用Laravel NIST Password Rules，首先使用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方法提供了适用于密码可选择性更改（如果填写）的表单的验证规则。