https://github.com/rollerworks/passwordstrengthvalidator

Password-strength validator for Symfony
https://github.com/rollerworks/passwordstrengthvalidator

password-strength strength-validation symfony validator

Last synced: 3 days ago
JSON representation

Password-strength validator for Symfony

• Host: GitHub
• URL: https://github.com/rollerworks/passwordstrengthvalidator
• Owner: rollerworks
• License: mit
• Created: 2017-08-19T09:04:14.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-10-17T19:02:47.000Z (2 months ago)
• Last Synced: 2024-12-13T17:21:25.486Z (10 days ago)
• Topics: password-strength, strength-validation, symfony, validator
• Language: PHP
• Homepage:
• Size: 403 KB
• Stars: 144
• Watchers: 5
• Forks: 32
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
Rollerworks PasswordStrengthValidator

=====================================

This package provides various password strength validators for the [Symfony Validator

component](http://symfony.com/doc/current/components/validator.html). 

_To use this bundle with a Symfony application use the [RollerworksPasswordStrengthBundle][1]._

Passwords can be validated using either strength-levels (weak, medium, strong etc)

or by configuring explicit requirements (needs letters, numbers etc).

> This library provides the same level of functionality as the

> [PasswordStrengthBundle](https://github.com/jbafford/PasswordStrengthBundle) created by John Bafford.

## Installation

To install this package, add `rollerworks/password-strength-validator` to your composer.json:

```bash

$ php composer.phar require rollerworks/password-strength-validator

```

Now, [Composer][2] will automatically download all required files, and install them

for you.

## Requirements

You need at least PHP PHP 8.2 and Symfony 6, mbstring is recommended but not required.

## Basic Usage

**Caution:**

> The password validators do not enforce that the field must have a value!

> To make a field "required" use the [NotBlank constraint](http://symfony.com/doc/current/reference/constraints/NotBlank.html)

> in combination with the password validator(s).

All examples assume you have the Composer autoloader already in your code,

see also [How to Install and Use the Symfony Components](http://symfony.com/doc/current/components/using_components.html)

for more information.

### [Strength validation](docs/strength-validation.md)

Validates the passwords strength-level (weak, medium, strong etc).

### [Requirements validation](docs/requirements-validation.md)

Validates the passwords using explicitly configured requirements (letters, caseDiff, numbers, requireSpecialCharacter).

## Versioning

For transparency and insight into the release cycle, and for striving

to maintain backward compatibility, this package is maintained under

the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

`..`

And constructed with the following guidelines:

* Breaking backward compatibility bumps the major (and resets the minor and patch)

* New additions without breaking backward compatibility bumps the minor (and resets the patch)

* Bug fixes and misc changes bumps the patch

For more information on SemVer, please visit .

## License

This library is released under the [MIT license](LICENSE).

## Contributing

This is an open source project. If you'd like to contribute,

please read the [Contributing Guidelines][3]. If you're submitting

a pull request, please follow the guidelines in the [Submitting a Patch][4] section.

[1]: https://github.com/rollerworks/PasswordStrengthBundle

[2]: https://getcomposer.org/doc/00-intro.md

[3]: https://github.com/rollerworks/contributing

[4]: https://contributing.readthedocs.org/en/latest/code/patches.html