Please note that the manual is a little bit misleading when providing references. The sourceforge URL cited
(i.e. http://sourceforge.net/projects/cracklib) is the homepage of cracklib the enabler (upon which other things build), NOT the crack PECL extension. If you are a PHP user looking for the crack PECL extension, you should NOT download from sourceforge. Instead, you should download from the PECL homepage (http://pecl.php.net). When you are there, search for "crack" not "cracklib".
Crack Functions
簡介
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: 本擴充功能已被移動到 » PECL 函式庫中且自以下版本起不再被包含到 PHP 中:5.0.0.
需求
More information regarding CrackLib along with the library can be found at » http://sourceforge.net/projects/cracklib.
安裝
本 » PECL 擴充功能未包含於 PHP 中。 安裝此 PECL 擴充功能的訊息可在手冊中標題為 PECL 擴充功能安裝的一章中找到。 更多訊息如新版本,下載,原始文件,維護者訊息以及更新日誌等可以在這裡找到: » http://pecl.php.net/package/crack.
在 PHP 4 中本 PECL 擴充功能的原始程式位於 PHP 原始程式中的 ext/ 目錄下或者在上面的 PECL 連結中。 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. 在 PHP 4 中本 DLL 位於 PHP Windows 執行套件中的 extensions/ 目錄下。 可以從 » PHP 下載頁面或者 » http://snaps.php.net/ 下載此 PECL 擴充功能的 DLL 文件。
執行時期設定
這些函式的行為受 php.ini 的影響。
| 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. |
資源類型
The CrackLib extension defines a dictionary resource identifier returned by crack_opendict().
預設常數
本擴充功能未定義任何常數。
範例
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'.
Table of Contents
- 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
Crack
23-Nov-2007 06:24
06-Jun-2007 12:08
For those of you not familiar with the CrackLib Library:
CrackLib (or PHP Crack) can not cope with plaintext wordlists.
You have to generate a binary version of any plaintext list first.
After you have done this you get 3 files with different extensions:
my_list.txt
---->
my_list.pwd
my_list.hwm
my_list.pwi
crack_opendict() must be called with the first argument describing the path and base filename of the binary wordlist, e.g. C:\....\my_list or /usr/local/... (see below)
Now the bad news - how to generate the 3 files:
The only way i managed to do it:
o Download the CrackLib package from sourceforge (see link in php.net txt)
o USE UNIX/LINUX:
o run configure
o run make all
o run make install
o run make dict (having the wordlists in the /dict directory)
o look for the files in /usr/local/share/cracklib/
o copy the files in a convenient directory
That's it.
