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
}

應用程式介面

您可以使用這些功能：

• __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文件