zexbre/

一个基于驱动程序的简单垃圾邮件防护包。

v0.3.0 2024-04-02 17:41 UTC

This package is auto-updated.

Last update: 2024-10-02 21:03:24 UTC


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

贡献

请参阅 CONTRIBUTINGCODE OF CONDUCT 了解详细信息。

安全

如果您发现任何与安全相关的问题,请通过电子邮件 niks986@gmail.com 联系,而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议 (MIT)。有关更多信息,请参阅 许可文件