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