BotDetect Laravel 4.2 CAPTCHA Integration Quickstart (BotDetect v3.0; deprecated)

1. Installing the BotDetect Laravel Captcha Composer Package

Note: If you do not have Composer yet, you can install it by following the instructions on https://getcomposer.org

"providers" => array(
  ...
  "LaravelCaptcha\Providers\LaravelCaptchaServiceProvider"
)

{
  "repositories": [
    {
      "type": "composer",
      "url": "http://packages.captcha.com"
    }
  ]
}

"providers" => array(
  ...
  "LaravelCaptcha\Providers\LaravelCaptchaServiceProvider"
)

2. Show a Captcha Challenge on the Form

Route::get('example', 'ExampleController@getExample');
Route::post('example', 'ExampleController@postExample');

<?php

// Importing the BotDetectCaptcha class
use LaravelCaptcha\Integration\BotDetectCaptcha;

class ExampleController extends BaseController {

  // get a captcha instance to handle for the example page
  private function getExampleCaptchaInstance() {
    // Captcha parameters
    $captchaConfig = [
      'CaptchaId' => 'ExampleCaptcha', // a unique Id for the Captcha instance
      'UserInputId' => 'CaptchaCode', // Id of the Captcha code input textbox
       // The path of the Captcha config file is inside the config folder
      'CaptchaConfigFilePath' => 'captcha_config/ExampleCaptchaConfig.php',
    ];
    return BotDetectCaptcha::GetCaptchaInstance($captchaConfig);
  }

  public function getExample() {
    // captcha instance of the example page
    $captcha = $this->getExampleCaptchaInstance();

    // passing Captcha Html to example view
    return View::make('example', array('captchaHtml' => $captcha->Html()));
  }

}

Captcha configuration options (/app/config/captcha_config/ExampleCaptchaConfig.php):

<?php if (!class_exists('CaptchaConfiguration')) { return; }
  
// BotDetect PHP Captcha configuration options

$LBD_CaptchaConfig = CaptchaConfiguration::GetSettings();

$LBD_CaptchaConfig->CodeLength = 4;
$LBD_CaptchaConfig->ImageWidth = 250;
$LBD_CaptchaConfig->ImageHeight = 50;

Showing a Captcha challenge in a View:

  {{ HTML::style(CaptchaUrls::LayoutStylesheetUrl()) }}
</head>

  [...]

  {{ $captchaHtml }}
  {{ Form::text('CaptchaCode', null, array('id' => 'CaptchaCode')) }}

3. Check User Input During Form Submission

<?php

// Importing the BotDetectCaptcha class
use LaravelCaptcha\Integration\BotDetectCaptcha;

class ExampleController extends BaseController {

  // get a captcha instance to handle for the example page
  private function getExampleCaptchaInstance() {
    // Captcha parameters
    $captchaConfig = [
      'CaptchaId' => 'ExampleCaptcha', // a unique Id for the Captcha instance
      'UserInputId' => 'CaptchaCode', // Id of the Captcha code input textbox
       // The path of the Captcha config file is inside the config folder
      'CaptchaConfigFilePath' => 'captcha_config/ExampleCaptchaConfig.php',
    ];
    return BotDetectCaptcha::GetCaptchaInstance($captchaConfig);
  }

  public function getExample() {
    // captcha instance of the example page
    $captcha = $this->getExampleCaptchaInstance();

    // passing Captcha Html to example view
    return View::make('example', array('captchaHtml' => $captcha->Html()));
  }

  public function postExample() {
    // captcha instance of the example page
    $captcha = $this->getExampleCaptchaInstance();

    // validate the user-entered Captcha code when the form is submitted
    $code = Input::get('CaptchaCode');
    $isHuman = $captcha->Validate($code);

    if ($isHuman) {
      // TODO: Captcha validation passed, perform protected  action
    } else {
      // TODO: Captcha validation failed, show error message
    }
  }

}

In-Depth Laravel CAPTCHA Instructions and Explanations

Detailed Laravel Captcha instructions and explanations can be found in the Laravel 4.2 Captcha integration how to guide.

Other BotDetect PHP CAPTCHA Quickstarts

[back to the top of the page]