Flutter密码策略验证插件 password_policy 的使用

password_policy 是一个简单的包，帮助你快速为你的应用程序设置密码策略。它不包含任何UI工具，但提供了与Flutter集成的示例。

功能

验证规则（ValidationRules）

你可以通过定义一组规则来评估密码的有效性。该包提供了以下规则：LengthRule、UpperCaseRule、LowerCaseRule、NoSpaceRule、DigitRule 和 SpecialCharacterRule。你也可以实现自己的自定义规则。

• 可以将某些规则设置为必选，如果这些规则未被遵守，则密码将被视为无效。
• 默认情况下，所有提供的规则都是必选的，但可以将其设置为非必选。

密码得分和强度

根据你的规则和密码，该包会给出一个密码的score和strength。

• score取决于密码如何符合你的规则，范围在0.0到1.0之间（完全符合所有规则时为1.0）。
• strength分为五个等级：weak、intermediate、good、strong 和 unbreakable，与score相对应。

你可以调整密码策略，要求达到最低minimumScore才能验证密码，默认值为1.0，意味着密码必须符合所有规则。

开始使用

首先，在你的pubspec.yaml文件中添加password_policy依赖：

dependencies:
  password_policy: ^最新版本号

然后运行：

dart pub add password_policy

或者

flutter pub add password_policy

导入包：

import 'package:password_policy/password_policy.dart';

使用方法

创建 PasswordPolicy

下面是一个创建PasswordPolicy对象的例子：

PasswordPolicy passwordPolicy = PasswordPolicy(
  password: "MyPassword",
  minimumScore: 0.8, // 设置最低分数为0.8
  validationRules: [
    LengthRule(minimalLength: 10), // 最小长度为10
    UpperCaseRule(minimumUpperCaseCharacters: 3), // 至少包含3个大写字母
    DigitRule(minimumNbDigits: 3, isMandatory: false), // 至少包含3个数字，非必选
    NoSpaceRule(), // 不允许包含空格
    Contain1026Rule(), // 自定义规则
  ],
);

测试密码是否符合 PasswordPolicy

接下来，我们可以测试密码是否符合我们的策略：

PasswordCheck passwordCheck = PasswordCheck(password: "Password", passwordPolicy: passwordPolicy);

print("Password score: ${passwordCheck.score}");
print("Password strength: ${passwordCheck.strength.name}");
if (passwordCheck.isValid) {
  print("Congrats! Your password is secure!");
} else {
  print("Your password does not apply to our PasswordPolicy, please review the following rules: ");
  for (ValidationRule rule in passwordCheck.notRespectedMandatoryRules) {
    print(rule.name);
  }
}

自定义规则

下面是一个自定义规则的例子，检查密码是否包含字符串"1026"：

class Contain1026Rule extends ValidationRule {
  Contain1026Rule()
      : super(
          impact: 1,
          mandatory: true,
          name: "Milvintsiss",
        );

  @override
  double computeRuleScore(String password) {
    if (password.contains("1026")) return 1.0;
    return 0.0;
  }
}

完整示例 Demo

以下是一个完整的Flutter示例，展示如何在一个TextFormField中使用PasswordPolicy进行验证：

import 'package:flutter/material.dart';
import 'package:password_policy/password_policy.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Password Policy Example')),
        body: Center(child: PasswordForm()),
      ),
    );
  }
}

class PasswordForm extends StatefulWidget {
  @override
  _PasswordFormState createState() => _PasswordFormState();
}

class _PasswordFormState extends State<PasswordForm> {
  final GlobalKey<FormState> _formKey = GlobalKey<FormState>();

  PasswordPolicy passwordPolicy = PasswordPolicy(
    minimumScore: 0.8,
    validationRules: [
      LengthRule(minimalLength: 8, name: "Your password should be at least 8 characters long!"),
      UpperCaseRule(name: "Your password should contain one upper case character!"),
      LowerCaseRule(name: "Your password should contain one lower case character!"),
      DigitRule(name: "Your password should contain one digit!"),
      NoSpaceRule(name: "Your password should not contain spaces!"),
      SpecialCharacterRule(isMandatory: false, name: null),
    ],
  );

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: <Widget>[
          TextFormField(
            validator: (password) {
              if (password == null || password.isEmpty)
                return "This field is mandatory!";
              PasswordCheck passwordCheck =
                  PasswordCheck(password: password, passwordPolicy: passwordPolicy);
              if (!passwordCheck.isValid)
                return passwordCheck.notRespectedMandatoryRules
                    .map<String?>((rule) => rule.name)
                    .join("\n");
              return null;
            },
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: () {
              if (_formKey.currentState!.validate()) {
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Processing Data')),
                );
              }
            },
            child: Text('Submit'),
          ),
        ],
      ),
    );
  }
}

这个示例展示了如何在一个表单字段中使用PasswordPolicy来进行密码验证，并显示相应的错误信息。希望这对你有所帮助！