XVI. クラック関数 (Crack)

導入

このモジュールの関数により、パスワードの '強度' を試すための CrackLib ライブラリが使用可能となります。パスワードの '強度' は、長さ、大文字/ 小文字の使用で確認され、指定した CrackLib の辞書を用いて確認されます。 CrackLib は、パスワードを '強化する' ために有用な統計情報も出力します。

注意: この拡張モジュールは PECL レポジトリに移動されており、以下のバージョン以降 PHP にバンドルされなくなっています。 PHP 5.0.0.

要件

CrackLib に関するより詳細な情報は、 http://sourceforge.net/projects/cracklib にあります。

インストール手順

この PECL 拡張モジュールは PHP にバンドルされていません。この PECL 拡張モジュールをインストールする方法は、マニュアルの PECL 拡張モジュールのインストールという章にあります。新規リリース・ダウンロード・ソースファイル・管理者情報・CHANGELOG といった関連する情報については、次の場所にあります。 http://pecl.php.net/package/crack.

PHP 4 の場合、この PECL 拡張モジュールのソースは、PHP のソースの ext/ ディレクトリ、または上の PECL リンクで入手可能です。これらの関数を使用するためには、設定オプション --with-crack[=DIR] を用いて Crackサポートを有効にしてPHPをコンパイルする必要があります。

Windowsユーザは、これらの関数を使用するために、 php.ini の中に php_crack.dll を追加します。 PHP 4 の場合、この DLL は PHP の Windows ダウンロードバイナリの extensions/ ディレクトリにあります。この PECL 拡張モジュール用の DLL は、PHP のダウンロードページあるいは http://pecl4win.php.net/ からダウンロードできます。

実行時設定

php.ini の設定により動作が変化します。

表 1. Crack設定オプション

名前	デフォルト	変更可能	変更履歴
crack.default_dictionary	NULL	PHP_INI_PERDIR	PHP 4.0.5 から利用可能です

PHP_INI_* 定数の詳細および定義については付録I を参照してください。

リソース型

CrackLib 拡張モジュールでは、crack_opendict() が返すディレクトリリソース識別子を定義しています。

定義済み定数

定数は定義されていません。

例

以下の例は、CrackLib 辞書をオープンする方法を示しており、指定したパスワードを試験し、解析メッセージを取得し、辞書を閉じます。

例 1. CrackLib の例

<?php
// CrackLib
                        辞書をオープンする
$dictionary = crack_opendict('/usr/local/lib/pw_dict')


                             or
                        die('Unable to
                        open CrackLib
                        dictionary');


                        
//
                        パスワードチェックを行う
$check = crack_check($dictionary, 'gx9A2s0x');

                        
//
                        メッセージを取得する
$diag = crack_getlastmessage();


                        echo $diag; //
                        'strong password'

                        

                        // 辞書を閉じる
crack_closedict($dictionary);

                        ?>

注意: crack_check() は TRUE を返し、 crack_getlastmessage() は 'strong password' を返します。

目次
crack_check -- 指定したパスワードに関して強度チェックを行う
crack_closedict -- オープンされているCrackLib辞書を閉じる
crack_getlastmessage -- 直近の強度チェックからのメッセージを返す
crack_opendict -- 新規CrackLib辞書をオープンする