schuppo/password-strength

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

v1.11 2018-02-08 20:05 UTC

README

Build Status Total Downloads License

This package provides a validator that ensures strong passwords in Laravel 4 & 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

Just composer require schuppo/password-strength:"~0.10".

For Laravel 5 users

Just composer require schuppo/password-strength:"~1.5".

Initialize the package

If you do run the package on Laravel 5.5+, you can start using the package at this point. package auto-discovery takes care of the magic of adding the service provider.

If you do not run Laravel 5.5 (or higher), then add the following line under the providers array key in app/config.php:

// app/config/app.php
return array(
    // ...
    'providers' => array(
        // ...
        \Schuppo\PasswordStrength\PasswordStrengthServiceProvider::class,
    );
    // ...
);

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(array(
    '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 / Laravel 4]

[1.11/-]

Simplifies symbol validation

[1.10/0.15]

Adds Chinese and Spanish translation

[1.9/0.14]

Improves Polish translation

[1.8/0.13]

Adds Arabic translation

[1.7/0.12]

Adds Czech translation

[1.6/0.11]

  • Adds Russian translation

[1.5/0.10]

  • Adds unicode flag to case difference validation rule

[1.4/0.9]

  • Adds Dutch translation
  • Updates French translation
  • Makes packages php7 ready

[1.3/0.8.2]

Adds Romanian translation

[1.2/0.8.1]

Adds Polish translation

[1.1/0.8]

Adds French translation

[1.0.2/0.7]

Updates README.md

[1.0.1]

Make package laravel 5 ready

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