Crack Functions

Introduktion

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.

Note: This extension has been moved to the » PECL repository and is no longer bundled with PHP as of PHP 5.0.0.

Systemkrav

More information regarding CrackLib along with the library can be found at » https://sourceforge.net/projects/cracklib.

Installation

Denne » PECL udvidelse medfølger ikke i PHP. Uddybende information så som nye udgivelser, downloads, kildekoder, vedligeholder information samt en CHANGELOG, kan findes her: » https://pecl.php.net/package/crack.

I PHP 4 er denne PECL udvidelses kildekode kan blive fundet i ext/ biblioteket inde i PHP kildekoden eller ved PECL linket ovenover. In order to use these functions you must compile PHP with Crack support by using the --with-crack[=DIR] configuration option.

Windows users will enable php_crack.dll inside of php.ini in order to use these functions. I PHP 4 befinder denne DLL sig i extensions/ biblioteket inde i PHP Windows binær download. Du kan hente denne PECL udvidelse DLL fra » PHP Downloads siden eller på » https://snaps.php.net/.

Runtime Konfiguration

Virkemåden af disse funktioner er berørt af indstillinger i php.ini.

**Crack configuration options**
Name	Default	Changeable	Changelog
crack.default_dictionary	NULL	PHP_INI_PERDIR	PHP_INI_SYSTEM in crack <= 0.2. Available since PHP 4.0.5. Removed in PHP 5.0.0.

For flere detaljer og definationer af PHP_INI_* constanterne, se ini_set() dokumentation.

Ressourcetyper

The CrackLib extension defines a dictionary resource identifier returned by crack_opendict().

Foruddefinerede Konstanter

Denne udvidelse har ingen konstanter.

Eksempler

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

Example#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);
?>

Note: If crack_check() returns TRUE, crack_getlastmessage() will return 'strong password'.

crack_check — Performs an obscure check with the given password
crack_closedict — Closes an open CrackLib dictionary
crack_getlastmessage — Returns the message from the last obscure check
crack_opendict — Opens a new CrackLib dictionary