Captcha

Captcha

Instalación

Con compositor:

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

Uso

Puedes crear un captcha con CaptchaBuilder :

 <?php

use Gregwar  Captcha  CaptchaBuilder ;

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

Luego puedes guardarlo en un archivo:

 <?php

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

O enviarlo directamente:

 <?php

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

O insértelo directamente en la página HTML:

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

Podrás obtener el código y compararlo con una entrada del usuario:

 <?php

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

Puede comparar la frase con la entrada del usuario:

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

API

Puedes utilizar estas funciones:

• __construct($phrase = null) , construye el constructor con la frase dada, si la frase es nula, se generará una aleatoria
• getPhrase() , le permite obtener el contenido de la frase.
• setDistortion($distortion) , habilita o deshabilita la distorsión, llámala antes de build()
• isOCRReadable() , devuelve true si el OCR se puede leer usando el software ocrad , necesitarás tener shell_exec habilitado, imagemagick y ocrad instalados
• buildAgainstOCR($width = 150, $height = 40, $font = null) , genera un código hasta que ocrad no lo puede leer
• build($width = 150, $height = 40, $font = null) , crea un código con los $width, $height y $font dados. De forma predeterminada, se utilizará una fuente aleatoria de la biblioteca.
• save($filename, $quality = 80) , guarda el captcha en un archivo jpeg en $filename, con la calidad dada
• get($calidad = 80) , devuelve los datos jpeg
• salida($calidad = 80) , envía directamente el código jpeg a un navegador
• setBackgroundColor($r, $g, $b) , establece el color de fondo para forzarlo (esto desactivará muchos efectos y no se recomienda)
• setBackgroundImages(array($imagepath1, $imagePath2)) , establece imágenes de fondo personalizadas que se utilizarán como fondo captcha. Se recomienda desactivar los efectos de imagen al pasar imágenes personalizadas como fondo (ignore_all_effects). Se selecciona una imagen aleatoria de la lista pasada; se deben pasar las rutas completas a los archivos de imagen.
• setInterpolation($interpolate) , habilita o deshabilita la interpolación (habilitada por defecto), deshabilitarla será más rápido pero las imágenes se verán más feas
• setIgnoreAllEffects($ignoreAllEffects) , desactiva todos los efectos en la imagen captcha. Recomendado para usar al pasar imágenes de fondo personalizadas para el captcha.
• testPhrase($phrase) , devuelve verdadero si la frase dada es buena
• setMaxBehindLines($lines) , establece el número máximo de líneas detrás del código
• setMaxFrontLines($lines) , establece el número máximo de líneas en el frente del código

Si desea cambiar la cantidad de caracteres, puede llamar al generador de frases directamente usando parámetros adicionales:

 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 );

También puedes pasar directamente la frase deseada al constructor:

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

Ejemplo completo

Si desea ver un ejemplo, puede echar un vistazo a demo/form.php , que utiliza demo/session.php para representar un captcha y verificarlo después del envío.

Paquete Symfony

Puedes echar un vistazo al siguiente repositorio para disfrutar del paquete Symfony 2 que incluye este generador de captcha: https://github.com/Gregwar/CaptchaBundle

Extensión Yii2

Puede utilizar la siguiente extensión para integrarse con Yii2 Framework: https://github.com/juliardi/yii2-captcha

Licencia

Esta biblioteca está bajo licencia MIT, eche un vistazo al archivo LICENSE