An open API service indexing awesome lists of open source software.

https://github.com/chekun/captcha

A Fork of mewebstudio/captcha
https://github.com/chekun/captcha

Last synced: over 1 year ago
JSON representation

A Fork of mewebstudio/captcha

Awesome Lists containing this project

README

          

# Captcha for Laravel 5

A simple [Laravel 5](http://www.laravel.com/) service provider for including the [Captcha for Laravel 5](https://github.com/mewebstudio/captcha).

for Laravel 4 [Captcha for Laravel Laravel 4](https://github.com/mewebstudio/captcha/tree/master-l4)

## Preview
![Preview](http://i.imgur.com/HYtr744.png)

## 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": "dev-master"
},
"minimum-stability": "dev"
}
```

Update your packages with ```composer update``` or install with ```composer install```.

In Windows, you'll need to include the GD2 DLL `php_gd2.dll` as an extension in php.ini.

## 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',
]
```

Find the `aliases` key in `config/app.php`.

```php
'aliases' => [
// ...
'Captcha' => 'Mews\Captcha\Facades\Captcha',
]
```

## Configuration

To use your own settings, publish config.

```$ php artisan vendor:publish```

`config/captcha.php`

```php
return [
'default' => [
'length' => 5,
'width' => 120,
'height' => 36,
'quality' => 90,
],
// ...
];
```

## Example Usage
```php

// [your site path]/Http/routes.php

Route::any('captcha-test', function()
{
if (Request::getMethod() == 'POST')
{
$rules = ['captcha' => 'required|captcha'];
$validator = Validator::make(Input::all(), $rules);
if ($validator->fails())
{
echo '

Incorrect!

';
}
else
{
echo '

Matched :)

';
}
}

$form = '';
$form .= '';
$form .= '

' . captcha_img() . '

';
$form .= '

';
$form .= '

Check

';
$form .= '';
return $form;
});
```

# Return Image
```php
captcha();
```
or
```php
Captcha::create();
```

# Return URL
```php
captcha_src();
```
or
```
Captcha::src();
```

# 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 website](http://www.mewebstudio.com)