psecio/pwdcheck

A password complexity validator

1.0 2014-01-04 13:27 UTC

This package is auto-updated.

Last update: 2024-12-15 11:24:14 UTC


README

Packagist Version Build Status

The Pwdcheck tool uses the Wolfram Alpha method for estimating the strength of a password. It goes through a set of several checks to give the password a "score":

  • 0-60: Very Weak
  • 60-70: Weak
  • 70-80: Fair
  • 80-90: Strong
  • 90-100: Very Strong

Installation

You can use Composer to install Pwdcheck:

{
	"require": {
		"psecio/pwdcheck": "1.*"
	}
}

Usage

Usage of the tool is simple and you can either fetch the text version of the strength (ex. "Very Weak") or a numeric representation from zero through four:

<?php
require_once 'vendor/autoload.php';

$p = new \Psecio\Pwdcheck\Password();
$p->evaluate($password);

// getting the numeric representation:
echo 'Strength: '.$p->getStrength()."\n";

// getting the text version:
echo 'Strength: '.$p->getStrength(true)."\n";

// you can also get the raw score either as a return value or using getScore
$result = $p->evaluate($password);
echo 'Score: '.$result."\n"

echo 'Score: '.$p->getScore()."\n";