Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/unicodeveloper/laravel-password
:closed_lock_with_key: :smiling_imp: Guard your users against entering dumb passwords in your Laravel 5 apps
https://github.com/unicodeveloper/laravel-password
Last synced: about 2 months ago
JSON representation
:closed_lock_with_key: :smiling_imp: Guard your users against entering dumb passwords in your Laravel 5 apps
- Host: GitHub
- URL: https://github.com/unicodeveloper/laravel-password
- Owner: unicodeveloper
- License: mit
- Created: 2016-07-02T10:29:28.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-12-30T04:56:53.000Z (over 3 years ago)
- Last Synced: 2024-05-18T00:41:33.040Z (4 months ago)
- Language: PHP
- Homepage: http://goodheads.io/2016/07/03/introducing-laravel-password-v1-0/
- Size: 64.5 KB
- Stars: 425
- Watchers: 15
- Forks: 58
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# laravel-password
[](https://packagist.org/packages/unicodeveloper/laravel-password)
[](LICENSE.md)
[](https://scrutinizer-ci.com/g/unicodeveloper/laravel-password)
[](https://packagist.org/packages/unicodeveloper/laravel-password)
> #### Guard your users from security problems by preventing them from having dumb passwords
### Introduction
This package can be used to verify **the user provided password is
not one of the top 10,000 worst passwords** as analyzed by a respectable IT security analyst. Read
about all [ here](https://xato.net/10-000-top-passwords-6d6380716fe0#.473dkcjfm),
[here(wired)](http://www.wired.com/2013/12/web-semantics-the-ten-thousand-worst-passwords/) or
[here(telegram)](http://www.telegraph.co.uk/technology/internet-security/10303159/Most-common-and-hackable-passwords-on-the-internet.html)
## Installation
[PHP](https://php.net) 5.5+ or [HHVM](http://hhvm.com) 3.3+, and [Composer](https://getcomposer.org) are required.
To get the latest version of Laravel Password, simply add the following line to the require block of your `composer.json` file.
```
"unicodeveloper/laravel-password": "1.0.*"
```
You'll then need to run `composer install` or `composer update` to download it and have the autoloader updated.
- If you're on Laravel 5.5 or above, that's all you need to do! Check out the usage examples below.
- If you're on Laravel < 5.5, you'll need to register the service provider. Open up `config/app.php` and add the following to the `providers` array:
```php
Unicodeveloper\DumbPassword\DumbPasswordServiceProvider::class
```
## Usage
Use the rule `dumbpwd` in your validation like so:
```php
/**
* Get a validator for an incoming registration request.
*
* @param array $data
* @return \Illuminate\Contracts\Validation\Validator
*/
protected function validator(array $data)
{
return Validator::make($data, [
'name' => 'required|max:255',
'email' => 'required|email|max:255|unique:users',
'password' => 'required|min:6|dumbpwd|confirmed',
]);
}
```
Error shows on the page like so:
By default, the error message returned is `This password is just too common. Please try another!`.
You can customize the error message by opening `resources/lang/en/validation.php` and adding to the array like so:
```php
'dumbpwd' => 'You are using a dumb password abeg',
```
## Change log
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Contributing
Please feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.
## Inspiration
* [Eugene Mutai](https://github.com/kn9ts/dumb-passwords)
## How can I thank you?
Why not star the github repo? I'd love the attention! Why not share the link for this repository on Twitter or HackerNews? Spread the word!
Don't forget to [follow me on twitter](https://twitter.com/unicodeveloper)!
Thanks!
Prosper Otemuyiwa.
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.