XI. Crack Functions

Introducere

These functions allow you to use the CrackLib library to test the 'strength' of a password. The 'strength' of a password is tested by that checks length, use of upper and lower case and checked against the specified CrackLib dictionary. CrackLib will also give helpful diagnostic messages that will help 'strengthen' the password.

Notã: This extension has been removed as of PHP 5 and moved to the PECL repository.

Necesităţi

More information regarding CrackLib along with the library can be found at http://www.crypticide.org/users/alecm/.

Instalare

In order to use these functions, you must compile PHP with Crack support by using the --with-crack[=DIR] option.

Configurare la rulare

The behaviour of these functions is affected by settings in php.ini.

Tabel 1. Crack configuration options

Name	Default	Changeable
crack.default_dictionary	NULL	PHP_INI_SYSTEM

For further details and definition of the PHP_INI_* constants see ini_set().

Tipuri de resurse

Această extensie nu defineşte tipuri de resurse.

Constante predefinite

Această extensie nu defineşte constante.

Exemple

This example shows how to open a CrackLib dictionary, test a given password, retrieve any diagnostic messages, and close the dictionary.

Exemplu 1. CrackLib example


<?php
// Open CrackLib Dictionary
$dictionary = crack_opendict('/usr/local/lib/pw_dict')
     or die('Unable to open CrackLib dictionary');

// Perform password check
$check = crack_check($dictionary, 'gx9A2s0x');

// Retrieve messages
$diag = crack_getlastmessage();
echo $diag; // 'strong password'

// Close dictionary
crack_closedict($dictionary);
?>