Yii 2.0: yii2-password

Password strength validation utilities for Yii Framework 2.0

This extension provides a couple of great password management utilities for Yii Framework 2.0. The extension allows password strength validation through your model. In addition, it provides an advanced password input widget, that allows you to display/hide text and show the password strength.


This is a password strength validator for your model attributes. The strength validator allows you to configure the following parameters for validating passwords or strings.

  1. Whether password contains an username
  2. Whether password contains an email string
  3. Minimum number of characters
  4. Maximum number of characters
  5. Minimum number of lower space characters
  6. Minimum number of upper space characters
  7. Minimum number of numeric / digit characters
  8. Minimum number of special characters

Other features:

  1. Includes 5 presets (simple, normal, fair, medium, and strong). Instead of setting each parameter above, you can call a preset which will auto-set each of the parameters above.
  2. It includes both server and client validation.
  3. This can work with the PasswordInput widget (described next) as per your needs. The strength validation routines for both are a bit different. The PasswordInput widget focuses on displaying the strength only, and does not restrict the user input in any way.

Note: The StrengthValidator does not validate if the password field is required. You need to use Yii's required rule for this.


The password input widget is a wrapper for the JQuery Strength meter plugin by Krajee. The plugin converts a password input into a widget with an advanced strength validation meter and toggle mask to show/hide the password. The widget displays a dynamic strength validation meter, which calculates the strength of the password as you type. You can configure the following options for the widget. This is an advanced password input widget with configurable options and a dynamic strength meter. The widget provides various features as mentioned below:

  1. Allows you to show/ hide a password text (using bootstrap styled input addons). You can configure this option to be shown or not.
  2. Allows you to display an advanced password strength meter to calculate and show your password strength as you type.
  3. Allows you to control and position/style your meter based on templates.
  4. A password strength meter consists of the meter bar, the score, and the verdict.
  5. Uses Twitter Bootstrap 3.0 styling wherever possible with inbuilt Yii 2.0 ActiveField functionality.
  6. Works independent and complements the StrengthValidator.


  • Yii 2.0 (dev-master)
  • PHP 5.4
  • Twitter Bootstrap 3.0

Note: This extension mandatorily requires Yii Framework 2. The framework is under active development and the first stable release of Yii 2 is expected in early 2014.


The preferred way to install this extension is through composer.

Either run:

$ php composer.phar require kartik-v/yii2-password"dev-master"

or add:

"kartik-v/yii2-password": "dev-master"

to the require section of your composer.json file.



// add this in your model
use kartik\password\StrengthValidator;
// use the validator in your model rules
public function rules() {
    return [
        [['username', 'password'], 'required'],
        [['password'], StrengthValidator::className(), 'preset'=>'normal', 'userAttribute'=>'username']


// add this in your view
use kartik\password\PasswordInput;
use kartik\widgets\ActiveForm; // optional
$form = ActiveForm::begin(['id' => 'login-form']);
echo $form->field($model,'username');
echo $form->field($model, 'password')->widget(PasswordInput::classname(), ['size'=>'lg']);



yii2-password is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.


Total 9 comments

#20166 report it
shiv at 2018/02/06 06:18am
I am using it

Really simple and easy to use.

#16572 report it
Kartik V at 2014/03/06 03:21pm
Upgraded to version 2.0

Extension upgraded to version 2.0. PasswordInput widget uses the newly created Strength Meter JQuery plugin. View the plugin documentation and/or demo.

For the PasswordInput widget, check documentation or view a demo.

Older version has been relegated to a version1.0 branch on github. Users upgrading to version 2.0 --- please see the documentation for usage.

#16085 report it
Kartik V at 2014/01/17 11:51pm
Internationalization & Translations Implemented

Internationalization & Translations have been implemented. If you have any suggestions/contributions, please discuss in the forum.

#16071 report it
Kartik V at 2014/01/16 11:55am
Password Input

@DocSnyder your toggleMask issue (with multiple widgets on same page) has been resolved.

Can you please record other queries on the forum and issues on the github page.

Will take the other suggestion (languages) as an enhancement. Let's discuss them in the forum. Also, let me know if you could contribute on translating it.

#16070 report it
DrMabuse at 2014/01/16 08:46am

is there a easy way to use your comments with other languages ? did you have some solutions for this or you wanna implement next time translation ?

#16069 report it
DrMabuse at 2014/01/16 06:59am
Question about the checkbox

Hi i have following use your widget

<div class="row">
                <div class="col-lg-7">
                        'model' => $model,
                        'attribute' => 'password',
                        'form' => $form,
                        'showMeter' => true,
                <div class="col-lg-5">
                        'model' => $model,
                        'attribute' => 'comparePassword',
                        'form' => $form,
                        'showMeter' => false,

comparePassword when click the checkbox doesnt show the password only the attribute password

#16068 report it
DrMabuse at 2014/01/16 05:31am

works very well ...

#15804 report it
Kartik V at 2013/12/18 11:56pm
Re: Cool extension

Thanks. Hope its really useful for your module.

Yes, I made a few initial extensions (and may add a few more), with a primary motive of helping developers to use it to rapidly create larger applications or modules. In addition to yii2-password, you may have a look at yii2-widgets, yii2-helpers and yii2-icons

#15803 report it
robregonm at 2013/12/18 06:13pm
Cool extension

Right the extension I was looking for my user management module for Yii2. I will add it as a composer dependency.

Leave a comment

Please to leave your comment.

Create extension
No downloadable files yet