website-protection/cphub-verifier

Простой пакет Laravel для проверки токенов Captcha Hub

v1.0.2 2025-08-12 18:20 UTC

Requires

• php: >=7.4
• guzzlehttp/guzzle: ^6.0 || ^7.0
• laravel/framework: ^5.0 || ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0

MIT

• Website-Protection

README

Простой и удобный пакет для сервер-серверной проверки токенов от сервиса Captcha Hub для Laravel.

Установка

Вы можете установить пакет через Composer:

composer require website-protection/cphub-verifier

Конфигурация

1. Опубликуйте конфигурационный файл командой:

   php artisan vendor:publish --provider="WebsiteProtection\CaptchaHubVerifier\CaptchaHubVerifierServiceProvider" --tag="config"

   Это создаст файл config/cphub-verifier.php.

2. Добавьте ваш секретный ключ в файл .env:

   CPHUB_SECRET_KEY=ВАШ_СЕКРЕТНЫЙ_КЛЮЧ

Использование

Пакет предоставляет удобный фасад CaptchaHub для проверки токена.

Базовая проверка

В вашем контроллере используйте фасад для проверки токена, полученного из формы. Ключ будет автоматически взят из вашей конфигурации.

use Illuminate\Http\Request;
use WebsiteProtection\CaptchaHubVerifier\Facades\CaptchaHub;
use Illuminate\Validation\ValidationException;

class FormController extends Controller
{
    public function store(Request $request)
    {
        $token = $request->input('cphb-captcha-token');

        if (! CaptchaHub::verify($token)) {
            throw ValidationException::withMessages([
               'captcha' => 'Проверка на робота не пройдена.',
            ]);
        }

        // Успех! Логика обработки формы...
    }
}

Проверка с другим ключом

Если у вас несколько конфигураций капчи, вы можете передать нужный Secret Key вторым аргументом, переопределив ключ по умолчанию.

use WebsiteProtection\CaptchaHubVerifier\Facades\CaptchaHub;

$anotherSecretKey = 'ДРУГОЙ_СЕКРЕТНЫЙ_КЛЮЧ';
$token = $request->input('cphb-captcha-token');

if (CaptchaHub::verify($token, $anotherSecretKey)) {
    // Успех
}

Лицензия

The MIT License (MIT). Пожалуйста, смотрите Файл Лицензии для получения дополнительной информации.