127 lines
3.2 KiB
Markdown
127 lines
3.2 KiB
Markdown
# RuCaptcha
|
|
|
|
[](https://badge.fury.io/rb/rucaptcha)
|
|
[](https://travis-ci.org/huacnlee/rucaptcha)
|
|
|
|
This is a Captcha gem for Rails Applications. It runs an ImageMagick command to draw Captcha image - so it has NO performance issues or memory leak issues.
|
|
|
|
**There is NO: RMagick**
|
|
|
|
Idea by: https://ruby-china.org/topics/20558#reply4
|
|
|
|
[中文介绍和使用说明](https://ruby-china.org/topics/27832)
|
|
|
|
|
|
## Feature
|
|
|
|
- Only need `ImageMagick`, No `RMagick`, No `mini_magick`;
|
|
- For Rails Application;
|
|
- Simple, Easy to use;
|
|
- File Caching for performance.
|
|
|
|
## Requirements
|
|
|
|
- ImageMagick
|
|
|
|
#### Ubuntu
|
|
|
|
```
|
|
sudo apt-get install imagemagick
|
|
```
|
|
|
|
#### Mac OS X
|
|
|
|
```bash
|
|
brew install imagemagick ghostscript
|
|
```
|
|
|
|
## Example
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
Put rucaptcha in your `Gemfile`:
|
|
|
|
```
|
|
gem 'rucaptcha'
|
|
```
|
|
|
|
Create `config/initializers/rucaptcha.rb`
|
|
|
|
```rb
|
|
RuCaptcha.configure do
|
|
# Number of chars, default: 4
|
|
self.len = 4
|
|
# Image font size, default: 45
|
|
self.font_size = 45
|
|
# Cache generated images in file store, this is config files limit, default: 100
|
|
# set 0 to disable file cache.
|
|
self.cache_limit = 100
|
|
# Custom captcha code expire time if you need, default: 2 minutes
|
|
# self.expires_in = 120
|
|
# Color style, default: :colorful, allows: [:colorful, :black_white]
|
|
# self.style = :colorful
|
|
end
|
|
```
|
|
|
|
Edit `config/routes.rb`, add the following code:
|
|
|
|
```rb
|
|
Rails.application.routes.draw do
|
|
...
|
|
mount RuCaptcha::Engine => "/rucaptcha"
|
|
...
|
|
end
|
|
```
|
|
|
|
Controller `app/controller/account_controller.rb`
|
|
|
|
```rb
|
|
class AccountController < ApplicationController
|
|
def create
|
|
@user = User.new(params[:user])
|
|
if verify_rucaptcha?(@user) && @user.save
|
|
redirect_to root_path, notice: 'Sign up successed.'
|
|
else
|
|
render 'account/new'
|
|
end
|
|
end
|
|
end
|
|
```
|
|
|
|
View `app/views/account/new.html.erb`
|
|
|
|
```erb
|
|
<form>
|
|
...
|
|
<div class="form-group">
|
|
<%= rucaptcha_input_tag(class: 'form-control', placeholder: 'Input Captcha') %>
|
|
<%= rucaptcha_image_tag(alt: 'Captcha') %>
|
|
</div>
|
|
...
|
|
</form>
|
|
```
|
|
|
|
### Write your test skip captcha validation
|
|
|
|
```rb
|
|
describe 'sign up and login', type: :feature do
|
|
before do
|
|
allow_any_instance_of(ActionController::Base).to receive(:verify_rucaptcha?).and_return(true)
|
|
end
|
|
|
|
it { ... }
|
|
end
|
|
```
|
|
|
|
|
|
|