Captcha

Captcha

Instalação

Com compositor:

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

Uso

Você pode criar um captcha com o CaptchaBuilder :

 <?php

use Gregwar  Captcha  CaptchaBuilder ;

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

Você pode então salvá-lo em um arquivo:

 <?php

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

Ou produza-o diretamente:

 <?php

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

Ou incorpore-o diretamente na página HTML:

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

Você poderá obter o código e compará-lo com uma entrada do usuário:

 <?php

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

Você pode comparar a frase com a entrada do usuário:

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

API

Você pode usar essas funções:

• __construct($phrase = null) , constrói o construtor com a frase fornecida, se a frase for nula, uma aleatória será gerada
• getPhrase() , permite que você obtenha o conteúdo da frase
• setDistortion($distortion) , habilite ou desabilite a distorção, chame-a antes de build()
• isOCRReadable() , retorna true se o OCR puder ser lido usando o software ocrad , você precisará ter o shell_exec habilitado, o imagemagick e o ocrad instalados
• buildAgainstOCR($width = 150, $height = 40, $font = null) , constrói um código até que ele não seja legível pelo ocrad
• build($width = 150, $height = 40, $font = null) , cria um código com $width, $height e $font fornecidos. Por padrão, uma fonte aleatória da biblioteca será usada
• save($filename, $quality = 80) , salva o captcha em um jpeg no $filename, com a qualidade fornecida
• get($quality = 80) , retorna os dados JPEG
• output($quality = 80) , envia diretamente o código JPEG para um navegador
• setBackgroundColor($r, $g, $b) , define a cor de fundo para forçá-lo (isso desativará muitos efeitos e não é recomendado)
• setBackgroundImages(array($imagepath1, $imagePath2)) , Define imagens de fundo personalizadas para serem usadas como fundo de captcha. Recomenda-se desabilitar os efeitos de imagem ao passar imagens personalizadas para fundo (ignore_all_effects). Uma imagem aleatória é selecionada da lista passada, os caminhos completos para os arquivos de imagem devem ser passados.
• setInterpolation($interpolate) , habilite ou desabilite a interpolação (habilitada por padrão), desabilitar será mais rápido mas as imagens ficarão mais feias
• setIgnoreAllEffects($ignoreAllEffects) , desative todos os efeitos na imagem captcha. Recomendado para uso ao passar imagens de fundo personalizadas para o captcha.
• testPhrase($phrase) , retorna verdadeiro se a frase fornecida for boa
• setMaxBehindLines($lines) , define o número máximo de linhas atrás do código
• setMaxFrontLines($lines) , define o número máximo de linhas na frente do código

Se quiser alterar o número de caracteres, você pode chamar o construtor de frases diretamente usando parâmetros extras:

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

Você também pode passar diretamente a frase desejada para o construtor:

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

Exemplo completo

Se você quiser ver um exemplo, você pode dar uma olhada no demo/form.php , que usa demo/session.php para renderizar um captcha e verificá-lo após o envio

Pacote Symfony

Você pode dar uma olhada no seguinte repositório para aproveitar o pacote Symfony 2 que empacota este gerador de captcha: https://github.com/Gregwar/CaptchaBundle

Extensão Yii2

Você pode usar a seguinte extensão para integração com o Yii2 Framework: https://github.com/juliardi/yii2-captcha

Licença

Esta biblioteca está sob licença MIT, dê uma olhada no arquivo LICENSE