PHPackages russsiq/laravel-grecaptcha - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Validation & Sanitization](/categories/validation) 4. / 5. russsiq/laravel-grecaptcha ActiveLibrary[Validation & Sanitization](/categories/validation) russsiq/laravel-grecaptcha ========================== Расширение валидатора Laravel 9.x для проверки Google reCAPTCHA v3. 0.3.1(4y ago)11901MITPHPPHP 8.1.\*CI failing Since Mar 2Pushed 4y ago2 watchersCompare [ Source](https://github.com/russsiq/laravel-grecaptcha)[ Packagist](https://packagist.org/packages/russsiq/laravel-grecaptcha)[ Docs](https://github.com/russsiq/laravel-grecaptcha)[ RSS](/packages/russsiq-laravel-grecaptcha/feed)WikiDiscussions master Synced 3w ago READMEChangelog (10)Dependencies (3)Versions (14)Used By (1) Расширение валидатора Laravel 9.x для проверки Google reCAPTCHA v3 ================================================================== [](#расширение-валидатора-laravel-9x-для-проверки-google-recaptcha-v3) Расширение валидатора фреймворка Laravel 9.x для использования Google reCAPTCHA v3. Выполняет запрос к сервису об оценке действий пользователя без его участия для блокирования отправки форм ботами, которые чаще всего спамят. > Перед использованием пакета зарегистрируйтесь и получите **Ключ** и **Секретный ключ**: . Подключение ----------- [](#подключение) Для добавления зависимости в проект на Laravel, используйте менеджер пакетов Composer: ``` composer require russsiq/laravel-grecaptcha ``` Если в вашем приложении включен отказ от обнаружения пакетов в директиве `dont-discover` в разделе `extra` файла `composer.json`, то необходимо самостоятельно добавить следующее в файле `config/app.php`: - Провайдер услуг в раздел `providers`: ``` Russsiq\GRecaptcha\GRecaptchaServiceProvider::class, ``` - Псевдоним класса (Facade) в раздел `aliases`: ``` 'GRecaptcha' => Russsiq\GRecaptcha\Support\Facades\GRecaptcha::class, ``` ### Публикация файлов пакета [](#публикация-файлов-пакета) Публикация (копирование) всех доступных файлов для переопределения и тонкой настройки пакета осуществляется через интерфейс командной строки Artisan: ``` php artisan vendor:publish --provider="Russsiq\GRecaptcha\GRecaptchaServiceProvider" ``` Помимо этого, доступна групповая публикация файлов по отдельным меткам `config`, `fonts`, `lang`, `views`: ``` php artisan vendor:publish --provider="Russsiq\GRecaptcha\GRecaptchaServiceProvider" --tag=config --force ``` ``` php artisan vendor:publish --provider="Russsiq\GRecaptcha\GRecaptchaServiceProvider" --tag=fonts --force ``` ``` php artisan vendor:publish --provider="Russsiq\GRecaptcha\GRecaptchaServiceProvider" --tag=lang --force ``` ``` php artisan vendor:publish --provider="Russsiq\GRecaptcha\GRecaptchaServiceProvider" --tag=views --force ``` ### Настройка [](#настройка) Вставьте **Ключ** и **Секретный ключ** в соответствующие поля в файле `config/g_recaptcha.php` вашего проекта. Помимо капчи от Google расширение поддерживает пустой драйвер и драйвер капчи, основанный на вводе четырехзначного кода. Выбор выполняется в файле конфигурации расширения `config/g_recaptcha.php`: ``` return [ // Драйвер, используемый по умолчанию. // Поддерживаемые типы: `nullable`, `image_code`, `google_v3`. 'driver' => env('GRECAPTCHA_DRIVER', 'google_v3'), // Настройки драйверов. 'drivers' => [ // ...code ], ]; ``` Использование ------------- [](#использование) Добавьте скрытое поле в обрабатываемую форму, используя директиву `@g_recaptcha_input`. Например: ``` @error ('g-recaptcha-response') @lang('g_recaptcha::g_recaptcha.messages.fails') @enderror @csrf @if (config('g_recaptcha.used')) @g_recaptcha_input @endif ``` Добавьте JavaScript в главный шаблон перед закрывающим тегом ``, используя директиву `@g_recaptcha_script`. Обе директивы могут принимать по одному входящему параметру, в котором можно указать относительные пути на расположение шаблонов. После отправки формы и в случае применения асинхронного запроса (AJAX), для обновления скрытого поля используйте JavaScript функцию `grecaptcha_reload();`. > Обе директивы не являются обязательным к использованию: вы можете самостоятельно сформировать как скрытое поле, так и логику JavaScript. ### Объявление правил проверки (валидации) [](#объявление-правил-проверки-валидации) ``` /** * Получить массив правил валидации, * которые будут применены к запросу. * @return array */ public function rules(): array { return [ 'title' => [ // ...code ], 'body' => [ // ...code ], 'g-recaptcha-response' => [ 'bail', config('g_recaptcha.used') ? 'required' : 'nullable', 'string', 'g_recaptcha', ], ]; } ``` Тестирование ------------ [](#тестирование) Для запуска тестов используйте команду: ``` composer run-script test ``` Для запуска тестов и формирования agile-документации, генерируемой в HTML-формате и записываемой в файл [tests/testdox.html](tests/testdox.html), используйте команду: ``` composer run-script testdox ``` Удаление пакета --------------- [](#удаление-пакета) Для удаления пакета из вашего проекта на Laravel используйте команду: ``` composer remove russsiq/laravel-zipper ``` ### Лицензия [](#лицензия) `laravel-grecaptcha` – программное обеспечение с открытым исходным кодом, распространяющееся по лицензии [MIT](LICENSE). ### Health Score 30 — LowBetter than 62% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community10 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~69 days Recently: every ~128 days Total 13 Last Release 1478d ago PHP version history (6 changes)0.0.1PHP >=7.2.0 0.1.2PHP >=7.2.5 0.1.3PHP >=7.3.0 0.2PHP ^7.3|^8.0 0.2.4PHP ^8.0 0.3.0PHP 8.1.\* ### Community Maintainers ![](https://www.gravatar.com/avatar/128e56a6429fdc3f0bedabc7d9a353d68429d5219c33f87633e3ef21122d7b6e?d=identicon)[russsiq](/maintainers/russsiq) --- Top Contributors [![russsiq](https://avatars.githubusercontent.com/u/11920039?v=4)](https://github.com/russsiq "russsiq (130 commits)") --- Tags laravelGoogle ReCaptcha ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/russsiq-laravel-grecaptcha/health.svg) ``` [![Health](https://phpackages.com/badges/russsiq-laravel-grecaptcha/health.svg)](https://phpackages.com/packages/russsiq-laravel-grecaptcha) ``` ### Alternatives [laravel/socialite Laravel wrapper around OAuth 1 & OAuth 2 libraries. 5.7k108.5M855](/packages/laravel-socialite)[craftcms/cms Craft CMS 3.6k3.6M3.0k](/packages/craftcms-cms)[laravel/boost Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code. 3.5k21.5M547](/packages/laravel-boost)[spatie/laravel-health Monitor the health of a Laravel application 87512.0M157](/packages/spatie-laravel-health)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9762.4M125](/packages/roots-acorn)[nativephp/mobile NativePHP for Mobile 1.1k75.1k90](/packages/nativephp-mobile) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)