base on Captcha for Laravel 5+ # Captcha for Laravel 10/11/12 [](https://travis-ci.org/mewebstudio/captcha) [](https://scrutinizer-ci.com/g/mewebstudio/captcha/?branch=master) [](https://packagist.org/packages/mews/captcha) [](https://packagist.org/packages/mews/captcha) [](https://packagist.org/packages/mews/captcha) [](https://packagist.org/packages/mews/captcha) A simple [Laravel 5/6/7/8/9/10/11/12](http://www.laravel.com/) service provider for including the [Captcha for Laravel](https://github.com/mewebstudio/captcha). for Laravel 4 [Captcha for Laravel Laravel 4](https://github.com/mewebstudio/captcha/tree/master-l4) for Laravel 5 to 12 [Captcha for Laravel Laravel 5 and Newer versions](https://github.com/mewebstudio/captcha/tree/master-l5-l9) ## Preview  - [Captcha for Laravel 5/6/7/8/9/10/11/12](#captcha-for-laravel-5-6-7) * [Preview](#preview) * [Installation](#installation) * [Usage](#usage) * [Configuration](#configuration) + [Custom settings:](#custom-settings) + [Disable validation:](#disable-validation) * [Example Usage](#example-usage) + [Session Mode:](#session-mode) + [Stateless Mode:](#stateless-mode) - [Return Image](#return-image) - [Return URL](#return-url) - [Return HTML](#return-html) - [To use different configurations](#to-use-different-configurations) * [Links](#links) ## Installation The Captcha Service Provider can be installed via [Composer](http://getcomposer.org) by requiring the `mews/captcha` package and setting the `minimum-stability` to `dev` (required for Laravel 5) in your project's `composer.json`. ```json { "require": { "laravel/framework": "5.0.*", "mews/captcha": "~3.0" }, "minimum-stability": "stable" } ``` or Require this package with composer: ``` composer require mews/captcha ``` Update your packages with ```composer update``` or install with ```composer install```. In Windows, you'll need to include the GD2 DLL `php_gd2.dll` in php.ini. And you also need include `php_fileinfo.dll` and `php_mbstring.dll` to fit the requirements of `mews/captcha`'s dependencies. ## Usage To use the Captcha Service Provider, you must register the provider when bootstrapping your Laravel application. There are essentially two ways to do this. Find the `providers` key in `config/app.php` and register the Captcha Service Provider. ```php 'providers' => [ // ... 'Mews\Captcha\CaptchaServiceProvider', ] ``` for Laravel 5.1+ ```php 'providers' => [ // ... Mews\Captcha\CaptchaServiceProvider::class, ] ``` For Laravel 11+ you can add the provider to `bootstrap\providers.php`. ```php return [ // ... Mews\Captcha\CaptchaServiceProvider::class ]; ``` Find the `aliases` key in `config/app.php`. ```php 'aliases' => [ // ... 'Captcha' => 'Mews\Captcha\Facades\Captcha', ] ``` for Laravel 5.1+ ```php 'aliases' => [ // ... 'Captcha' => Mews\Captcha\Facades\Captcha::class, ] ``` For Laravel 11+ : you do not need to add the alias, it will be added automatically. ## Configuration ### Custom settings: To use your own settings, publish config. ```$ php artisan vendor:publish --provider="Mews\Captcha\CaptchaServiceProvider"``` `config/captcha.php` ```php return [ 'default' => [ 'length' => 5, 'width' => 120, 'height' => 36, 'quality' => 90, 'math' => true, //Enable Math Captcha 'expire' => 60, //Captcha expiration ], // ... ]; ``` ### Images To use your own custom images for a background, set 'bgImage' to true and change the 'bgsDirectory' setting to your directory you want the image(s) to be used. If you just want to change the background color, then set 'bgImage' to false and the 'bgColor' will be applied. ### Disable validation: To disable the captcha validation use `CAPTCHA_DISABLE` environment variable. e.g. **.env** config: ```php CAPTCHA_DISABLE=true ``` ## Example Usage ### Session Mode: ```php // [your site path]/Http/routes.php Route::any('captcha-test', function() { if (request()->getMethod() == 'POST') { $rules = ['captcha' => 'required|captcha']; $validator = validator()->make(request()->all(), $rules); if ($validator->fails()) { echo '<p style="color: #ff0000;">Incorrect!</p>'; } else { echo '<p style="color: #00ff30;">Matched :)</p>'; } } $form = '<form method="post" action="captcha-test">'; $form .= '<input type="hidden" name="_token" value="' . csrf_token() . '">'; $form .= '<p>' . captcha_img() . '</p>'; $form .= '<p><input type="text" name="captcha"></p>'; $form .= '<p><button type="submit" name="check">Check</button></p>'; $form .= '</form>'; return $form; }); ``` Detailed Example in Laravel way view files ```html //register.blade.php <img src="{{ captcha_src() }}" alt="captcha"> <div class="mt-2"></div> <input type="text" name="captcha" class="form-control @error('captcha') is-invalid @enderror" placeholder="Please Insert Captch" > @error('captcha') <div class="invalid-feedback">{{ $message }}</div> @enderror ``` controller files ```php Validator::make($input, [ 'name' => ['required', 'string', 'max:255'], 'email' => [ 'required', 'string', 'email', 'max:255', Rule::unique(User::class), ], 'password' => $this->passwordRules(), 'captcha' => 'required|captcha' ])->validate(); ``` ### Stateless Mode: You get key and img from this url `http://localhost/captcha/api/math` and verify the captcha using this method: ```php //key is the one that you got from json response // fix validator // $rules = ['captcha' => 'required|captcha_api:'. request('key')]; $rules = ['captcha' => 'required|captcha_api:'. request('key') . ',math']; $validator = validator()->make(request()->all(), $rules); if ($validator->fails()) { return response()->json([ 'message' => 'invalid captcha', ]); } else { //do the job } ``` # Return Image ```php captcha(); ``` or ```php Captcha::create(); ``` # Return URL ```php captcha_src(); ``` or ``` Captcha::src('default'); ``` # Return HTML ```php captcha_img(); ``` or ```php Captcha::img(); ``` # To use different configurations ```php captcha_img('flat'); Captcha::img('inverse'); ``` etc. Based on [Intervention Image](https://github.com/Intervention/image) ^_^ ## Links * [Intervention Image](https://github.com/Intervention/image) * [L5 Captcha on Github](https://github.com/mewebstudio/captcha) * [L5 Captcha on Packagist](https://packagist.org/packages/mews/captcha) * [For L4 on Github](https://github.com/mewebstudio/captcha/tree/master-l4) * [License](http://www.opensource.org/licenses/mit-license.php) * [Laravel website](http://laravel.com) * [Laravel Turkiye website](http://www.laravel.gen.tr) * [mewebstudio](https://github.com/mewebstudio/captcha) ", Assign "at most 3 tags" to the expected json: {"id":"11408","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"