Captcha

キャプチャ

インストール

作曲家と:

{
    ...
    "require" : {
        "gregwar/captcha" : " 1.* "
    }
}

使用法

CaptchaBuilderを使用してキャプチャを作成できます。

 <?php

use Gregwar  Captcha  CaptchaBuilder ;

$ builder = new CaptchaBuilder ;
$ builder -> build ();

その後、それをファイルに保存できます。

 <?php

$ builder -> save ( ' out.jpg ' );

または、直接出力します。

 <?php

header ( ' Content-type: image/jpeg ' );
$ builder -> output ();

または、HTML ページに直接インライン化します。

<img src=" <?php echo $ builder->inline(); ?> " />

コードを取得して、ユーザー入力と比較することができます。

 <?php

// Example: storing the phrase in the session to test for the user 
// input later
$ _SESSION [ ' phrase ' ] = $ builder -> getPhrase ();

フレーズをユーザー入力と比較できます。

 if ( $ builder -> testPhrase ( $ userInput )) {
    // instructions if user phrase is good
}
else {
    // user phrase is wrong
}

API

これらの関数を使用できます。

• __construct($phrase = null) 、指定されたフレーズを使用してビルダーを構築します。フレーズが null の場合、ランダムなフレーズが生成されます。
• getPhrase() 、フレーズの内容を取得できます
• setDistortion($distortion) 、ディストーションを有効または無効にします。 build()前に呼び出します。
• isOCRReadable() は、 ocradソフトウェアを使用して OCR を読み取ることができる場合にtrueを返します。shell_exec を有効にし、imagemagick と ocrad をインストールする必要があります。
• buildAgainstOCR($width = 150, $height = 40, $font = null) 、 ocradで読み取れなくなるまでコードをビルドします
• build($width = 150, $height = 40, $font = null) は、指定された $width、$height、$font を使用してコードをビルドします。デフォルトでは、ライブラリからランダムなフォントが使用されます。
• save($filename, $quality = 80) は、指定された品質でキャプチャを $filename 内の JPEG に保存します。
• get($quality = 80) 、jpegデータを返します
• Output($quality = 80) 、jpeg コードをブラウザに直接出力します。
• setBackgroundColor($r, $g, $b) 、背景色を強制的に設定します (これは多くの効果を無効にするため、お勧めできません)
• setBackgroundImages(array($imagepath1, $imagePath2)) , キャプチャの背景として使用されるカスタム背景画像を設定します。背景にカスタム画像を渡すときは、画像効果を無効にすることをお勧めします (ignore_all_Effects)。渡されたリストからランダムな画像が選択されます。画像ファイルへのフルパスを渡す必要があります。
• setInterpolation($interpolate) 、補間を有効または無効にします (デフォルトで有効)。無効にすると処理は速くなりますが、画像の見た目は悪くなります。
• setIgnoreAllEffects($ignoreAllEffects) 、キャプチャ画像のすべての効果を無効にします。キャプチャ用のカスタム背景画像を渡すときに使用することをお勧めします。
• testPhrase($phrase) 、指定されたフレーズが適切な場合は true を返します
• setMaxBehindLines($lines) 、コードの後ろの最大行数を設定します
• setMaxFrontLines($lines) 、コードの先頭の最大行数を設定します。

文字数を変更したい場合は、追加のパラメーターを使用してフレーズ ビルダーを直接呼び出すことができます。

 use Gregwar  Captcha  CaptchaBuilder ;
use Gregwar  Captcha  PhraseBuilder ;

// Will build phrases of 3 characters
$ phraseBuilder = new PhraseBuilder ( 4 );

// Will build phrases of 5 characters, only digits
$ phraseBuilder = new PhraseBuilder ( 5 , ' 0123456789 ' );

// Pass it as first argument of CaptchaBuilder, passing it the phrase
// builder
$ captcha = new CaptchaBuilder ( null , $ phraseBuilder );

必要なフレーズをビルダーに直接渡すこともできます。

 // Building a Captcha with the "hello" phrase
$ captcha = new CaptchaBuilder ( ' hello ' );

完全な例

例を見たい場合は、 demo/form.phpを見てください。これは、 demo/session.phpを使用してキャプチャをレンダリングし、送信後にそれを確認します。

シンフォニーバンドル

このキャプチャ ジェネレーターをパッケージ化した Symfony 2 バンドルを楽しむには、次のリポジトリを参照してください: https://github.com/Gregwar/CaptchaBundle

Yii2 拡張機能

Yii2 フレームワークと統合するには、次の拡張機能を使用できます: https://github.com/juliardi/yii2-captcha

ライセンス

このライブラリは MIT ライセンスの下にありますLICENSEファイルを参照してください。