Skip to content

This package provides a validator for ensuring strong passwords in Laravel applications

License

Notifications You must be signed in to change notification settings

Fl0ux/PasswordStrengthPackage

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PasswordStrength Package

Build Status Total Downloads License

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

Get the package

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".

Initialize the package

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

Example

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.3] Adds romanian translation

[1.2] 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.2] Adds romanian translation

[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.

About

This package provides a validator for ensuring strong passwords in Laravel applications

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%