This package provides a validator that ensures strong passwords in Laravel 4 and 5 applications. It is influenced a lot by PasswordStrengthBundle for Symfony 2.
It is out now for a while and since there were no complaints it very likely fulfills its purpose.
The provided validations include:
- check if input contains alphabetic characters
- check if input contains numeric characters
- check if input contains mixed case characters
- check if input contains symbols
#Documentation
##Installation
For Laravel 4 users
Add the following to your composer.json
:
{
"require": {
"schuppo/password-strength": "~0.7"
}
}
and afterwards composer update
.
Or just composer require schuppo/password-strength:"~0.7@dev"
.
For Laravel 5 users
{
"require": {
"schuppo/password-strength": "~1.0"
}
}
and afterwards composer update
.
Or just composer require schuppo/password-strength:"~1.0@dev"
.
To start using the package, you have to add it to the array key providers
in app/config/app.php
:
// app/config/app.php
return array(
// ...
'providers' => array(
// ...
'Schuppo\PasswordStrength\PasswordStrengthServiceProvider',
);
// ...
);
Caution
I recently recognized a small conflict in the usage of this package in combination with unique-with: One runs into problems when adding the PasswordStrengthServiceProvider
after UniqueWithValidatorServiceProvider
to the providers array, the rules of this package stay unknown to the Laravel Validator
.
The problem is easy to fix though: Just add the service provider of this package in front of the service provider of unique-with. In that order both packages work fine.
##Usage
Now Laravel's native Validator
is extended by four rules:
- case_diff
- numbers
- letters
- symbols
You can apply these rules as described in the validation section on Laravel's website
$v = Validator::make(
'password' => '12345QWERTqwert@',
'password' => 'case_diff|numbers|letters|symbols')
);
$v->passes(); // returns true;
Notice that you can validate any value with the new rules. The only reason why this package is called "Password Strength Package" is that it describes its foremost purpose.
#History
Laravel 5 related
[1.2] Fixes bug and adds polish translation
[1.1] Adds french translations
[1.0.2] Updates README.md
[1.0.1] Starts to make package laravel 5 ready
Laravel 4 related
[0.8.1] Adds polish translation
[0.8] Adds french translations
[0.7] Fixes typo in readme
[0.6]
- New validation rule to check if input contains symbols. Thanks to closca for providing this new feature.
[0.5.3]
- Added new version to composer.json
[0.5.2]
- Small changes in README.md
[0.5.1]
- Minimum requirement (PHP 5.4 because of array chains) is now recognized by composer.json
[0.4.1]
- The package works properly now when other extensions of laravel's validator are used as well (like unique-with).
- The package is able to take localization overwrites now as described in the laravel docs
[0.3.1]
- Fixed: Package validator doesn't overwrite custom validation errror messages any more. Not functional tested though because I have no clue how to set up a test which controls the passing of variables from the password strength package to the native validator INSIDE the package's test folders. Any suggestions?
#License
This package is under the MIT license. See the complete license:
##Reporting Issues or Feature Requests
Issues and feature requests are tracked on GitHub.