zexbre /
一个基于驱动程序的简单垃圾邮件防护包。
v0.3.0
2024-04-02 17:41 UTC
Requires
- php: ^8.1
- ext-curl: *
- ext-dom: *
- ext-mbstring: *
Requires (Dev)
- phpunit/phpunit: ^10.5
Suggests
- zexbre/mathguard: Needed for support MathGuard verificator.
README
一个基于驱动程序的简单垃圾邮件防护包。
在将请求转发到系统进行进一步处理之前,先在客户端检查垃圾邮件消息。
安装
使用以下命令安装最新版本:
$ composer require zexbre/spam-protect
基本用法
客户端
<?php use ZexBre\SpamProtect\Factory\ReCaptchaVersion2Factory; ?> <html> <head> <?php // ... $widgetData = ReCaptchaVersion2Factory::getWidgetResponse([ 'reCaptchaSiteKey' => [RECAPTCHA-SITE-KEY], 'hl' => [LANGUAGE-CODE], // optional ]); echo $widgetData->htmlHead; ?> </head> <body> <?php // ... echo $widgetData->htmlBody; ?> </body> <html>
服务器端
<?php use ZexBre\SpamProtect\Factory\ReCaptchaVersion2Factory; // (1/3) preparation $spamProtect = ReCaptchaVersion2Factory::getProtector([ 'reCaptchaSecretKey' => [RECAPTCHA-SECRET-KEY], 'gReCaptchaResponse' => [RECAPTCHA-RESPONSE], 'acceptLanguage' => [ACCEPT-LANGUAGE-HEADER], // optional 'httpReferer' => [HTTP-REFERER-HEADER], // optional, see '$_SERVER["HTTP_REFERER"]' 'httpUserAgent' => [HTTP-USER-AGENT-HEADER], // optional, see '$_SERVER["HTTP_USER_AGENT"]' ]); // (2/3) verification $spamProtect->verify(); // (3/3) validation $isHuman = $spamProtect->isHuman(); // boolean $isRobot = $spamProtect->isRobot(); // boolean $isValidResponse = $spamProtect->isValidResponse(); // boolean $isInvalidResponse = $spamProtect->isInvalidResponse(); // boolean $errors = $spamProtect->getErrors(); // array
变更日志
有关最近更改的更多信息,请参阅 CHANGELOG-0.x。
贡献
请参阅 CONTRIBUTING 和 CODE OF CONDUCT 了解详细信息。
安全
如果您发现任何与安全相关的问题,请通过电子邮件 niks986@gmail.com 联系,而不是使用问题跟踪器。
鸣谢
许可协议
MIT 许可协议 (MIT)。有关更多信息,请参阅 许可文件。