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) , создает конструктор с заданной фразой, если фраза равна нулю, будет сгенерирована случайная фраза.
• getPhrase() позволяет вам получить содержимое фразы
• setDistortion($distortion) , включите или отключите искажение, вызовите его перед build()
• isOCRReadable() возвращает true если OCR можно прочитать с помощью программного обеспечения ocrad , вам необходимо включить 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) сохраняет капчу в формате JPEG в $filename с заданным качеством.
• get($quality = 80) возвращает данные в формате JPEG.
• вывод($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

Вы можете взглянуть на следующий репозиторий, чтобы насладиться пакетом Symfony 2, упаковывающим этот генератор капчи: https://github.com/Gregwar/CaptchaBundle

Расширение Yii2

Вы можете использовать следующее расширение для интеграции с Yii2 Framework: https://github.com/juliardi/yii2-captcha.

Лицензия

Эта библиотека находится под лицензией MIT, посмотрите файл LICENSE .