This Symfony-bundle integrates the Rollerworks PasswordStrengthValidator into your Symfony application.

The PasswordStrengthValidator provides various password strength validators for the Symfony Validator.

This bundle provides the same level of functionality as the PasswordStrengthBundle created by John Bafford. And is considered a replacement of the original bundle.

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

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

Now, Composer will automatically download all required files, and install them for you.

Note: This step is not required for Symfony Flex.

Enable the bundle in the kernel:

<?php

// in AppKernel::registerBundles()
$bundles = [
    // ...
    new Rollerworks\Bundle\PasswordStrengthBundle\RollerworksPasswordStrengthBundle(),
    // ...
];

You need at least PHP 5.6 or PHP 7.0, mbstring is recommended but not required. For the provided blacklist providers you may need SQLite3 or a PDO compatible driver.

Congratulations! You're ready!

Documentation for the various constraints can be found in the PasswordStrengthValidator package. See the bundle reference configuration to configure usage with this bundle.

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:

<major>.<minor>.<patch>

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 http://semver.org/.

This library is released under the MIT license.

This is an open source project. If you'd like to contribute, please read the Contributing Guidelines. If you're submitting a pull request, please follow the guidelines in the Submitting a Patch section.