Merge branch 'master' of github.com:Gregwar/CaptchaBundle

added Czech translation

Controller/CaptchaController.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Gregwar\CaptchaBundle\Controller;
+
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+
+/**
+ * Generates a captcha via a URL
+ *
+ * @author Jeremy Livingston <jeremy.j.livingston@gmail.com>
+ */
+class CaptchaController extends Controller
+{
+    /**
+     * Action that is used to generate the captcha, save its code, and stream the image
+     *
+     * @param \Symfony\Component\HttpFoundation\Request $request
+     * @param string $key
+     *
+     * @return \Symfony\Component\HttpFoundation\Response
+     */
+    public function generateCaptchaAction(Request $request, $key)
+    {
+        $options = $this->container->getParameter('gregwar_captcha.config');
+        $session = $this->get('session');
+        $whitelistKey = $options['whitelist_key'];
+        $isOk = false;
+
+        if ($session->has($whitelistKey)) {
+            $keys = $session->get($whitelistKey);
+            if (is_array($keys) && in_array($key, $keys)) {
+                $isOk = true;
+            }
+        }
+
+        if (!$isOk) {
+            throw $this->createNotFoundException('Unable to generate a captcha via an URL with this session key.');
+        }
+
+        /* @var \Gregwar\CaptchaBundle\Generator\CaptchaGenerator $generator */
+        $generator = $this->container->get('gregwar_captcha.generator');
+
+        $persistedOptions = $session->get($key, array());
+        $options = array_merge($options, $persistedOptions);
+
+        $phrase = $generator->getPhrase($options);
+        $generator->setPhrase($phrase);
+        $persistedOptions['phrase'] = $phrase;
+        $session->set($key, $persistedOptions);
+
+        $response = new Response($generator->generate($options));
+        $response->headers->set('Content-type', 'image/jpeg');
+
+        return $response;
+    }
+}
+

DependencyInjection/Configuration.php

@@ -9,30 +9,45 @@ class Configuration implements ConfigurationInterface
 {
     /**
      * Generates the configuration tree.
+     *
      * @return TreeBuilder
      */
     public function getConfigTreeBuilder()
     {
         $treeBuilder = new TreeBuilder();
-        $rootNode = $treeBuilder->root('gregwar_captcha', 'array');
+        $rootNode = $treeBuilder->root('gregwar_captcha');
 
         $rootNode
             ->addDefaultsIfNotSet()
             ->children()
                 ->scalarNode('length')->defaultValue(5)->end()
-                ->scalarNode('width')->defaultValue(120)->end()
-                ->scalarNode('height')->defaultValue(40)->end()
+                ->scalarNode('width')->defaultValue(130)->end()
+                ->scalarNode('height')->defaultValue(50)->end()
                 ->scalarNode('font')->defaultValue(__DIR__.'/../Generator/Font/captcha.ttf')->end()
-                ->scalarNode('keep_value')->defaultValue(true)->end()
+                ->scalarNode('keep_value')->defaultValue(false)->end()
                 ->scalarNode('charset')->defaultValue('abcdefhjkmnprstuvwxyz23456789')->end()
                 ->scalarNode('as_file')->defaultValue(false)->end()
+                ->scalarNode('as_url')->defaultValue(false)->end()
+                ->scalarNode('reload')->defaultValue(false)->end()
                 ->scalarNode('image_folder')->defaultValue('captcha')->end()
                 ->scalarNode('web_path')->defaultValue('%kernel.root_dir%/../web')->end()
                 ->scalarNode('gc_freq')->defaultValue(100)->end()
                 ->scalarNode('expiration')->defaultValue(60)->end()
-                ->scalarNode('quality')->defaultValue(15)->end()
+                ->scalarNode('quality')->defaultValue(30)->end()
+                ->scalarNode('invalid_message')->defaultValue('Bad code value')->end()
+                ->scalarNode('bypass_code')->defaultValue(null)->end()
+                ->scalarNode('whitelist_key')->defaultValue('captcha_whitelist_key')->end()
+                ->scalarNode('humanity')->defaultValue(0)->end()
+                ->scalarNode('distortion')->defaultValue(true)->end()
+                ->scalarNode('max_front_lines')->defaultValue(null)->end()
+                ->scalarNode('max_behind_lines')->defaultValue(null)->end()
+                ->scalarNode('interpolation')->defaultValue(true)->end()
+                ->arrayNode('text_color')->prototype('scalar')->end()->end()
+                ->arrayNode('background_color')->prototype('scalar')->end()->end()
+                ->scalarNode('disabled')->defaultValue(false)->end()
             ->end()
         ;
+
         return $treeBuilder;
     }
 }

DependencyInjection/GregwarCaptchaExtension.php

@@ -4,15 +4,22 @@ namespace Gregwar\CaptchaBundle\DependencyInjection;
 
 use Symfony\Component\HttpKernel\DependencyInjection\Extension;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Definition;
 use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
 use Symfony\Component\Config\FileLocator;
 
+/**
+ * Extension used to load the configuration, set parameters, and initialize the captcha view
+ *
+ * @author Gregwar <g.passault@gmail.com>
+ */
 class GregwarCaptchaExtension extends Extension
 {
+    /**
+     * @param array $configs
+     * @param \Symfony\Component\DependencyInjection\ContainerBuilder $container
+     */
     public function load(array $configs, ContainerBuilder $container)
     {
-
         $loader = new YamlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
         $loader->load('services.yml');
 
@@ -20,11 +27,13 @@ class GregwarCaptchaExtension extends Extension
         $config = $this->processConfiguration($configuration, $configs);
 
         $container->setParameter('gregwar_captcha.config', $config);
+        $container->setParameter('gregwar_captcha.config.image_folder', $config['image_folder']);
+        $container->setParameter('gregwar_captcha.config.web_path', $config['web_path']);
+        $container->setParameter('gregwar_captcha.config.gc_freq', $config['gc_freq']);
+        $container->setParameter('gregwar_captcha.config.expiration', $config['expiration']);
+        $container->setParameter('gregwar_captcha.config.whitelist_key', $config['whitelist_key']);
 
         $resources = $container->getParameter('twig.form.resources');
-        $container->setParameter('twig.form.resources',array_merge(array('GregwarCaptchaBundle::captcha.html.twig'), $resources));
-
+        $container->setParameter('twig.form.resources', array_merge(array('GregwarCaptchaBundle::captcha.html.twig'), $resources));
     }
-
 }
-

Generator/CaptchaGenerator.php

@@ -3,276 +3,161 @@
 namespace Gregwar\CaptchaBundle\Generator;
 
 use Symfony\Component\Finder\Finder;
+use Symfony\Component\HttpFoundation\Session\SessionInterface;
+use Symfony\Component\Routing\RouterInterface;
+
+use Gregwar\Captcha\CaptchaBuilderInterface;
+use Gregwar\Captcha\PhraseBuilderInterface;
 
 /**
- * Generates a CAPTCHA image
- */
-class CaptchaGenerator {
-
-    /**
-     * Name of folder for captcha images
-     * @var string
-     */
-    public $imageFolder;
-
-    /**
-     * Absolute path to public web folder
-     * @var string
-     */
-    public $webPath;
-
-    /**
-     * Frequence of garbage collection in fractions of 1
-     * @var int
-     */
-    public $gcFreq;
-
-    /**
-     * Captcha Font
-     * @var string
-     */
-    public $font;
-
-    /**
-     * Maximum age of images in minutes
-     * @var int
-     */
-    public $expiration;
-
-    /**
-     * Random fingerprint
-     * Useful to be able to regenerate exactly the same image
-     * @var array
-     */
-    public $fingerprint;
-
-    /**
-     * Should fingerprint be used ?
-     * @var boolean
-     */
-    public $use_fingerprint;
-
-    /**
-     * The captcha code
-     * @var string
-     */
-    public $value;
-
-    /**
-     * Captcha quality
-     * @var int
-     */
-    public $quality;
-
-    public function __construct($value, $imageFolder, $webPath, $gcFreq, $expiration, $font, $fingerprint, $quality)
-    {
-        $this->value = $value;
-        $this->imageFolder = $imageFolder;
-        $this->webPath = $webPath;
-        $this->gcFreq = intval($gcFreq);
-        $this->expiration = intval($expiration);
-        $this->font = $font;
-        $this->fingerprint = $fingerprint;
-        $this->use_fingerprint = (bool)$fingerprint;
-        $this->quality = intval($quality);
-    }
-
-    /**
-     * Get the captcha embeded code
-     */
-    public function getCode($width = 120, $height = 40)
-    {
-        return 'data:image/jpeg;base64,'.base64_encode($this->generate($width, $height));
-    }
-
-    /**
-     * Creates a captcha image with provided dimensions
-     * and randomly executes a garbage collection
+ * Uses configuration parameters to call the services that generate captcha images
  *
-     * @param int $width
-     * @param int $height
-     * @return string Web path to the created image
+ * @author Gregwar <g.passault@gmail.com>
+ * @author Jeremy Livingston <jeremy.j.livingston@gmail.com>
  */
-    public function getFile($width = 120, $height = 40)
-    {
-        if (mt_rand(1, $this->gcFreq) == 1) {
-            $this->garbageCollection();
-        }
+class CaptchaGenerator
+{
+    /**
+     * @var \Symfony\Component\Routing\RouterInterface
+     */
+    protected $router;
 
-        return $this->generate($width, $height, true);
+    /**
+     * @var CaptchaBuilder
+     */
+    protected $builder;
+
+    /**
+     * @var PhraseBuilder
+     */
+    protected $phraseBuilder;
+
+    /**
+     * @var ImageFileHandler
+     */
+    protected $imageFileHandler;
+
+    /**
+     * @param \Symfony\Component\Routing\RouterInterface $router
+     * @param CaptchaBuilderInterface $builder
+     * @param ImageFileHandlerInterface $imageFileHandler
+     */
+    public function __construct(RouterInterface $router, CaptchaBuilderInterface $builder, PhraseBuilderInterface $phraseBuilder, ImageFileHandler $imageFileHandler)
+    {
+        $this->router           = $router;
+        $this->builder          = $builder;
+        $this->phraseBuilder    = $phraseBuilder;
+        $this->imageFileHandler = $imageFileHandler;    
     }
 
     /**
-     * Returns a random number or the next number in the
-     * fingerprint
-     */
-    public function rand($min, $max) 
-    {
-        if (!is_array($this->fingerprint)) {
-            $this->fingerprint = array();
-        }
-
-        if ($this->use_fingerprint) {
-            $value = current($this->fingerprint);
-            next($this->fingerprint);
-        } else {
-            $value = mt_rand($min, $max);
-            $this->fingerprint[] = $value;
-        }
-        return $value;
-    }
-
-    /**
-     * Get the CAPTCHA fingerprint
-     */
-    public function getFingerprint()
-    {
-        return $this->fingerprint;
-    }
-
-    /**
-     * Deletes all images in the configured folder
-     * that are older than 10 minutes
+     * Get the captcha URL, stream, or filename that will go in the image's src attribute
      *
-     * @return void
+     * @param $key
+     * @param array $options
+     *
+     * @return array
      */
-    public function garbageCollection()
+    public function getCaptchaCode(array &$options)
     {
-        $finder = new Finder();
-        $criteria = sprintf('<= now - %s minutes', $this->expiration);
-        $finder->in($this->webPath . '/' . $this->imageFolder)
-               ->date($criteria);
+        $this->builder->setPhrase($this->getPhrase($options));
 
-        foreach($finder->files() as $file)
-        {
-            unlink($file->getPathname());
+        // Randomly execute garbage collection and returns the image filename
+        if ($options['as_file']) {
+            $this->imageFileHandler->collectGarbage();
+
+            return $this->generate($options);
         }
+
+        // Returns the image generation URL
+        if ($options['as_url']) {
+            return $this->router->generate('gregwar_captcha.generate_captcha', array('key' => $options['session_key']));
+        }
+
+        return 'data:image/jpeg;base64,' . base64_encode($this->generate($options));
     }
 
     /**
-     * Generate the image
+     * Sets the phrase to the builder
      */
-    public function generate($width, $height, $createFile = false)
+    public function setPhrase($phrase)
     {
-        $i = imagecreatetruecolor($width,$height);
-
-        $col = imagecolorallocate($i, $this->rand(0,110), $this->rand(0,110), $this->rand(0,110));
-
-        imagefill($i, 0, 0, 0xFFFFFF);
-
-        // Draw random lines
-        for ($t=0; $t<10; $t++) {
-            $tcol = imagecolorallocate($i, 100+$this->rand(0,150), 100+$this->rand(0,150), 100+$this->rand(0,150));
-            $Xa = $this->rand(0, $width);
-            $Ya = $this->rand(0, $height);
-            $Xb = $this->rand(0, $width);
-            $Yb = $this->rand(0, $height);
-            imageline($i, $Xa, $Ya, $Xb, $Yb, $tcol);
+        $this->builder->setPhrase($phrase);
     }
 
-        // Write CAPTCHA text
-        $size = $width/strlen($this->value);
-        $font = $this->font;
-        $box = imagettfbbox($size, 0, $font, $this->value);
-        $txt_width = $box[2] - $box[0];
-        $txt_height = $box[1] - $box[7];
+    /**
+     * @param string $key
+     * @param array $options
+     *
+     * @return string
+     */
+    public function generate(array &$options)
+    {
+        $this->builder->setDistortion($options['distortion']);
 
-        imagettftext($i, $size, 0, ($width-$txt_width)/2, ($height-$txt_height)/2+$size, $col, $font, $this->value);
+        $this->builder->setMaxFrontLines($options['max_front_lines']);
+        $this->builder->setMaxBehindLines($options['max_behind_lines']);
 
-        // Distort the image
-        $X = $this->rand(0, $width);
-        $Y = $this->rand(0, $height);
-        $Phase=$this->rand(0,10);
-        $Scale = 1.3 + $this->rand(0,10000)/30000;
-        $Amp=1+$this->rand(0,1000)/1000;
-        $out = imagecreatetruecolor($width, $height);
-
-        for ($x=0; $x<$width; $x++)
-            for ($y=0; $y<$height; $y++) {
-                $Vx=$x-$X;
-                $Vy=$y-$Y;
-                $Vn=sqrt($Vx*$Vx+$Vy*$Vy);
-
-                if ($Vn!=0) {
-                    $Vn2=$Vn+4*sin($Vn/8);
-                    $nX=$X+($Vx*$Vn2/$Vn);
-                    $nY=$Y+($Vy*$Vn2/$Vn);
-                } else {
-                    $nX=$X;
-                    $nY=$Y;
-                }
-                $nY = $nY+$Scale*sin($Phase + $nX*0.2);
-
-                $p = $this->bilinearInterpolate($nX-floor($nX), $nY-floor($nY),
-                    $this->getCol($i,floor($nX),floor($nY)),
-                    $this->getCol($i,ceil($nX),floor($nY)),
-                    $this->getCol($i,floor($nX),ceil($nY)),
-                    $this->getCol($i,ceil($nX),ceil($nY)));
-
-                if ($p==0) {
-                    $p=0xFFFFFF;
+        if (isset($options['text_color']) && $options['text_color']) {
+            if (count($options['text_color']) !== 3) {
+                throw new \RuntimeException('text_color should be an array of r, g and b');
             }
 
-                imagesetpixel($out, $x, $y, $p);
+            $color = $options['text_color'];
+            $this->builder->setTextColor($color[0], $color[1], $color[2]);
         }
 
-        // Renders it
-        if (!$createFile) {
+        if (isset($options['background_color']) && $options['background_color']) {
+            if (count($options['background_color']) !== 3) {
+                throw new \RuntimeException('background_color should be an array of r, g and b');
+            }
+
+            $color = $options['background_color'];
+            $this->builder->setBackgroundColor($color[0], $color[1], $color[2]);
+        }
+
+        $this->builder->setInterpolation($options['interpolation']);
+
+        $fingerprint = isset($options['fingerprint']) ? $options['fingerprint'] : null;
+
+        $content = $this->builder->build(
+            $options['width'],
+            $options['height'],
+            $options['font'],
+            $fingerprint
+        )->getGd();
+
+        if ($options['keep_value']) {
+            $options['fingerprint'] = $this->builder->getFingerprint();
+        }
+
+        if (!$options['as_file']) {
             ob_start();
-            imagejpeg($out, null, $this->quality);
+            imagejpeg($content, null, $options['quality']);
+
             return ob_get_clean();
+        }
+
+        return $this->imageFileHandler->saveAsFile($content);
+    }
+
+    /**
+     * @param string $key
+     * @param array $options
+     *
+     * @return string
+     */
+    public function getPhrase(array &$options)
+    {
+        // Get the phrase that we'll use for this image
+        if ($options['keep_value'] && isset($options['phrase'])) {
+            $phrase = $options['phrase'];
         } else {
-            // Check if folder exists and create it if not
-            if (!file_exists($this->webPath . '/' . $this->imageFolder)) {
-                mkdir($this->webPath . '/' . $this->imageFolder, 0755);
-            }
-            $filename = md5(uniqid()) . '.jpg';
-            $filepath = $this->webPath . '/' . $this->imageFolder . '/' . $filename;
-            imagejpeg($out, $filepath, 15);
-            return '/' . $this->imageFolder . '/' . $filename;
-        }
+            $phrase = $this->phraseBuilder->build($options['length'], $options['charset']);
+            $options['phrase'] = $phrase;
         }
         
-    protected function getCol($image, $x, $y)
-    {
-        $L = imagesx($image);
-        $H = imagesy($image);
-        if ($x<0 || $x>=$L || $y<0 || $y>=$H)
-            return 0xFFFFFF;
-        else return imagecolorat($image, $x, $y);
-    }
-
-    protected function getRGB($col) {
-        return array(
-            (int)($col >> 16) & 0xff,
-            (int)($col >> 8) & 0xff,
-            (int)($col) & 0xff,
-        );
-    }
-
-    function bilinearInterpolate($x, $y, $nw, $ne, $sw, $se)
-    {
-        list($r0, $g0, $b0) = $this->getRGB($nw);
-        list($r1, $g1, $b1) = $this->getRGB($ne);
-        list($r2, $g2, $b2) = $this->getRGB($sw);
-        list($r3, $g3, $b3) = $this->getRGB($se);
-
-        $cx = 1.0 - $x;
-        $cy = 1.0 - $y;
-
-        $m0 = $cx * $r0 + $x * $r1;
-        $m1 = $cx * $r2 + $x * $r3;
-        $r = (int)($cy * $m0 + $y * $m1);
-
-        $m0 = $cx * $g0 + $x * $g1;
-        $m1 = $cx * $g2 + $x * $g3;
-        $g = (int)($cy * $m0 + $y * $m1);
-
-        $m0 = $cx * $b0 + $x * $b1;
-        $m1 = $cx * $b2 + $x * $b3;
-        $b = (int)($cy * $m0 + $y * $m1);
-
-        return ($r << 16) | ($g << 8) | $b;
+        return $phrase;
     }
 }
 

Generator/ImageFileHandler.php

@@ -0,0 +1,106 @@
+<?php
+
+namespace Gregwar\CaptchaBundle\Generator;
+
+use Symfony\Component\Finder\Finder;
+
+/**
+ * Handles actions related to captcha image files including saving and garbage collection
+ *
+ * @author Gregwar <g.passault@gmail.com>
+ * @author Jeremy Livingston <jeremy@quizzle.com>
+ */
+class ImageFileHandler
+{
+    /**
+     * Name of folder for captcha images
+     * @var string
+     */
+    protected $imageFolder;
+
+    /**
+     * Absolute path to public web folder
+     * @var string
+     */
+    protected $webPath;
+
+    /**
+     * Frequency of garbage collection in fractions of 1
+     * @var int
+     */
+    protected $gcFreq;
+
+    /**
+     * Maximum age of images in minutes
+     * @var int
+     */
+    protected $expiration;
+
+    /**
+     * @param $imageFolder
+     * @param $webPath
+     * @param $gcFreq
+     * @param $expiration
+     */
+    public function __construct($imageFolder, $webPath, $gcFreq, $expiration)
+    {
+        $this->imageFolder      = $imageFolder;
+        $this->webPath          = $webPath;
+        $this->gcFreq           = $gcFreq;
+        $this->expiration       = $expiration;
+    }
+
+    /**
+     * Saves the provided image content as a file
+     *
+     * @param string $contents
+     *
+     * @return string
+     */
+    public function saveAsFile($contents)
+    {
+        $this->createFolderIfMissing();
+
+        $filename = md5(uniqid()) . '.jpg';
+        $filePath = $this->webPath . '/' . $this->imageFolder . '/' . $filename;
+        imagejpeg($contents, $filePath, 15);
+
+        return '/' . $this->imageFolder . '/' . $filename;
+    }
+
+    /**
+     * Randomly runs garbage collection on the image directory
+     *
+     * @return bool
+     */
+    public function collectGarbage()
+    {
+        if (!mt_rand(1, $this->gcFreq) == 1) {
+            return false;
+        }
+
+        $this->createFolderIfMissing();
+
+        $finder = new Finder();
+        $criteria = sprintf('<= now - %s minutes', $this->expiration);
+        $finder->in($this->webPath . '/' . $this->imageFolder)
+            ->date($criteria);
+
+        foreach($finder->files() as $file) {
+            unlink($file->getPathname());
+        }
+
+        return true;
+    }
+
+    /**
+     * Creates the folder if it doesn't exist
+     */
+    protected function createFolderIfMissing()
+    {
+        if (!file_exists($this->webPath . '/' . $this->imageFolder)) {
+            mkdir($this->webPath . '/' . $this->imageFolder, 0755);
+        }
+    }
+}
+

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) <2011> Grégoire Passault
+Copyright (c) <2011-2013> Grégoire Passault
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -25,8 +25,9 @@ Add the following lines to your `deps` file:
 
 ```
     [GregwarCaptchaBundle]
-        git=git://github.com/Gregwar/CaptchaBundle.git
+        git=http://github.com/Gregwar/CaptchaBundle.git
         target=/bundles/Gregwar/CaptchaBundle
+        version=origin/2.0 <- add this if you are using Symfony 2.0
 ```
 
 Now, run the vendors script to download the bundle:
@@ -49,7 +50,7 @@ $ git submodule update --init
 Add the following to the "require" section of your `composer.json` file:
 
 ```
-    "gregwar/captcha-bundle": "1.0.0"
+    "gregwar/captcha-bundle": "dev-master"
 ```
 
 And update your dependencies
@@ -64,7 +65,7 @@ Now you will need to add the `Gregwar` namespace to your autoloader:
 <?php
 // app/autoload.php
 
-$loader->registerNamspaces(array(
+$loader->registerNamespaces(array(
     // ...
     'Gregwar' => __DIR__.'/../vendor/bundles',
 ));
@@ -105,27 +106,43 @@ You can use the "captcha" type in your forms this way:
     // ...
 ```
 
-Note that the generated image will be embeded in the HTML document, to avoid dealing
-with route and subrequests.
+Note that the generated image will, by default, be embedded in the HTML document
+to avoid dealing with route and subrequests.
 
 Options
 =======
 
-You can define the following type option :
+You can define the following configuration options globally:
 
-* **width**: the width of the captcha image (default=120)
-* **height**: the height of the captcha image (default=40)
-* **length**: the length of the captcha (number of chars, default 5)
-* **quality**: jpeg quality of captchas (default=15)
-* **charset**: the charset used for code generation (default=abcdefhjkmnprstuvwxyz23456789)
-* **font**: the font to use (default=Generator/Font/captcha.ttf)
-* **keep_value**: the value will be the same until the form is posted, even if the page is refreshed (default=true)
-* **as_file**: if set to true an image file will be created instead of embedding to please IE6/7 (default=false)
-* **image_folder**: name of folder for captcha images relative to public web folder in case **as_file** ist set to true (default="captcha")
+* **image_folder**: name of folder for captcha images relative to public web folder in case **as_file** is set to true (default="captcha")
 * **web_path**: absolute path to public web folder (default="%kernel.root_dir%/../web")
 * **gc_freq**: frequency of garbage collection in fractions of 1 (default=100)
 * **expiration**: maximum lifetime of captcha image files in minutes (default=60)
 
+You can define the following configuration options globally or on the CaptchaType itself:
+
+* **width**: the width of the captcha image (default=120)
+* **height**: the height of the captcha image (default=40)
+* **disabled**: disable globally the CAPTCHAs (can be useful in dev environment), it will
+  still appear but won't be editable and won't be checked
+* **length**: the length of the captcha (number of chars, default 5)
+* **quality**: jpeg quality of captchas (default=15)
+* **charset**: the charset used for code generation (default=abcdefhjkmnprstuvwxyz23456789)
+* **font**: the font to use (default is random among some pre-provided fonts), this should be an absolute path
+* **keep_value**: the value will be the same until the form is posted, even if the page is refreshed (default=true)
+* **as_file**: if set to true an image file will be created instead of embedding to please IE6/7 (default=false)
+* **as_url**: if set to true, a URL will be used in the image tag and will handle captcha generation. This can be used in a multiple-server environment and support IE6/7 (default=false)
+* **invalid_message**: error message displayed when an non-matching code is submitted (default="Bad code value", see the translation section for more information)
+* **bypass_code**: code that will always validate the captcha (default=null)
+* **whitelist_key**: the session key to use for keep the session keys that can be used for captcha storage, when using as_url (default=captcha_whitelist_key)
+* **reload**: adds a link to reload the code
+* **humanity**: number of extra forms that the user can submit after a correct validation, if set to a value different of 0, only 1 over (1+humanity) forms will contain a CAPTCHA (default=0, i.e each form will contain the CAPTCHA)
+* **distortion**: enable or disable the distortion on the image (default=true, enabled)
+* **max_front_lines**, **max_behind_lines**: the maximum number of lines to draw on top/behind the image. `0` will draw no lines; `null` will use the default algorithm (the
+number of lines depends on the size of the image). (default=null)
+* **background_color**: sets the background color, if you want to force it, this should be an array of r,g &b, for instance [255, 255, 255] will force the background to be white
+* **interpolation**: enable or disable the interpolation on the captcha
+
 Example :
 
 ```php
@@ -146,10 +163,30 @@ configuration entry in your `config.yml` file:
         height: 50
         length: 6
 
-Form theming
+Translation
+===========
+
+The messages are using the translator, you can either change the `invalid_message` option or translate it. Any contribution about the language is welcome !
+
+As URL
+============
+To use a URL to generate a captcha image, you must add the bundle's routing configuration to your app/routing.yml file:
+
+    gregwar_captcha_routing:
+        resource: "@GregwarCaptchaBundle/Resources/config/routing/routing.yml"
+
+This will use the bundle's route of "/generate-captcha/{key}" to handle the generation. If this route conflicts with an application route, you can prefix the bundle's routes when you import:
+
+    gregwar_captcha_routing:
+        resource: "@GregwarCaptchaBundle/Resources/config/routing/routing.yml"
+        prefix: /_gcb
+
+Since the session key is transported in the URL, it's also added in another session array, under the `whitelist_key` key, for security reasons
+
+Form Theming
 ============
 
-The widget support the standard symfony theming, see the [documentation](http://symfony.com/doc/current/book/forms.html#form-theming) for details on how to accomplish this.
+The widget support the standard Symfony theming, see the [documentation](http://symfony.com/doc/current/book/forms.html#form-theming) for details on how to accomplish this.
 
 The default rendering is:
 
@@ -158,7 +195,7 @@ The default rendering is:
 {% spaceless %}
     <img src="{{ captcha_code }}" title="captcha" width="{{ captcha_width }}" height="{{ captcha_height }}" />
     {{ form_widget(form) }}
-{% spaceless %}
+{% endspaceless %}
 {% endblock %}
 ```
 

Resources/config/routing/routing.yml

@@ -0,0 +1,3 @@
+gregwar_captcha.generate_captcha:
+    pattern:        /generate-captcha/{key}
+    defaults:       { _controller: GregwarCaptchaBundle:Captcha:generateCaptcha }

Resources/config/services.yml

@@ -1,8 +1,32 @@
-
 services:
-    # captcha type
     captcha.type:
         class: Gregwar\CaptchaBundle\Type\CaptchaType
-        arguments: [ "@session", %gregwar_captcha.config% ]
+        arguments:
+            - @session
+            - @gregwar_captcha.generator
+            - @translator
+            - %gregwar_captcha.config%
         tags:
             - { name: form.type, alias: captcha }
+
+    gregwar_captcha.generator:
+        class: Gregwar\CaptchaBundle\Generator\CaptchaGenerator
+        arguments:
+            - @router
+            - @gregwar_captcha.captcha_builder
+            - @gregwar_captcha.phrase_builder
+            - @gregwar_captcha.image_file_handler
+
+    gregwar_captcha.image_file_handler:
+        class: Gregwar\CaptchaBundle\Generator\ImageFileHandler
+        arguments:
+            - %gregwar_captcha.config.image_folder%
+            - %gregwar_captcha.config.web_path%
+            - %gregwar_captcha.config.gc_freq%
+            - %gregwar_captcha.config.expiration%
+
+    gregwar_captcha.captcha_builder:
+        class: Gregwar\Captcha\CaptchaBuilder
+
+    gregwar_captcha.phrase_builder:
+        class: Gregwar\Captcha\PhraseBuilder

Resources/translations/gregwar_captcha.cs.yml

@@ -0,0 +1 @@
+Renew: Obnovit

Resources/translations/gregwar_captcha.de.yml

@@ -0,0 +1 @@
+Renew: Erneuern

Resources/translations/gregwar_captcha.en.yml

@@ -0,0 +1 @@
+Renew: Renew

Resources/translations/gregwar_captcha.es.yml

@@ -0,0 +1 @@
+Renew: Renovar

Resources/translations/gregwar_captcha.fr.yml

@@ -0,0 +1 @@
+Renew: Renouveler

Resources/translations/gregwar_captcha.it.yml

@@ -0,0 +1 @@
+Renew: Rinnova

Resources/translations/gregwar_captcha.nl.yml

@@ -0,0 +1 @@
+Renew: Vernieuwen

Resources/translations/gregwar_captcha.pt_BR.yml

@@ -0,0 +1 @@
+Renew: Regerar

Resources/translations/gregwar_captcha.ro.yml

@@ -0,0 +1 @@
+Renew: Reimprospateaza

Resources/translations/gregwar_captcha.ru.yml

@@ -0,0 +1 @@
+Renew: Обновить

Resources/translations/gregwar_captcha.zh_CN.yml

@@ -0,0 +1 @@
+Renew: 看不清换一张？

Resources/translations/validators.cs.yml

@@ -0,0 +1 @@
+Bad code value: Špatný kontrolní kód

Resources/translations/validators.de.yml

@@ -0,0 +1 @@
+Bad code value: Code stimmt nicht überein

Resources/translations/validators.en.yml

@@ -0,0 +1 @@
+Bad code value: Code does not match

Resources/translations/validators.es.yml

@@ -0,0 +1 @@
+Bad code value: El valor no coincide

Resources/translations/validators.fr.yml

@@ -0,0 +1 @@
+Bad code value: Mauvaise valeur pour le code visuel

Resources/translations/validators.it.yml

@@ -0,0 +1 @@
+Bad code value: Il valore non coincide

Resources/translations/validators.nl.yml

@@ -0,0 +1 @@
+Bad code value: Code komt niet overeen

Resources/translations/validators.pt_BR.yml

@@ -0,0 +1 @@
+Bad code value: Código de verificação inválido

Resources/translations/validators.ro.yml

@@ -0,0 +1 @@
+Bad code value: Codul de securitate este incorect

Resources/translations/validators.ru.yml

@@ -0,0 +1 @@
+Bad code value: Неправильный код

Resources/translations/validators.zh_CN.yml

@@ -0,0 +1 @@
+Bad code value: 验证码不正确

Resources/views/captcha.html.twig

@@ -1,7 +1,20 @@
 {% block captcha_widget %}
+{% if is_human %}
+-
+{% else %}
 {% spaceless %}
-    <img src="{{ captcha_code }}" title="captcha" width="{{ captcha_width }}" height="{{ captcha_height }}" />
+    <img id="{{ image_id }}" src="{{ captcha_code }}" alt="" title="captcha" width="{{ captcha_width }}" height="{{ captcha_height }}" />
+    {% if reload %}
+    <script type="text/javascript">
+        function reload_{{ image_id }}() {
+            var img = document.getElementById('{{ image_id }}');
+            img.src = '{{ captcha_code }}?n=' + (new Date()).getTime();
+        }
+    </script>
+    <a class="captcha_reload" href="javascript:reload_{{ image_id }}();">{{ 'Renew'|trans({}, 'gregwar_captcha') }}</a>
+    {% endif %}
     {{ form_widget(form) }}
 {% endspaceless %}
+{% endif %}
 {% endblock %}
 

Type/CaptchaType.php

@@ -2,20 +2,17 @@
 
 namespace Gregwar\CaptchaBundle\Type;
 
-use Symfony\Component\HttpFoundation\Session\Session;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-
+use Symfony\Component\HttpFoundation\Session\SessionInterface;
 use Symfony\Component\Form\FormView;
 use Symfony\Component\Form\FormInterface;
 use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\Exception\FormException;
 use Symfony\Component\Form\FormBuilderInterface;
 use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-use Symfony\Component\Form\FormViewInterface;
+use Symfony\Component\Form\FormEvents;
+use Symfony\Component\Translation\TranslatorInterface;
 
 use Gregwar\CaptchaBundle\Validator\CaptchaValidator;
 use Gregwar\CaptchaBundle\Generator\CaptchaGenerator;
-use Gregwar\CaptchaBundle\DataTransformer\EmptyTransformer;
 
 /**
  * Captcha type
@@ -24,6 +21,27 @@ use Gregwar\CaptchaBundle\DataTransformer\EmptyTransformer;
  */
 class CaptchaType extends AbstractType
 {
+    /**
+     * @var \Symfony\Component\HttpFoundation\Session\SessionInterface
+     */
+    protected $session;
+
+    /**
+     * The session key
+     * @var string
+     */
+    protected $key = null;
+
+    /**
+     * @var \Gregwar\CaptchaBundle\Generator\CaptchaGenerator
+     */
+    protected $generator;
+
+    /**
+     * @var TranslatorInterface
+     */
+    protected $translator;
+
     /**
      * Options
      * @var array
@@ -31,92 +49,108 @@ class CaptchaType extends AbstractType
     private $options = array();
 
     /**
-     * Session key
-     * @var string
+     * @param \Symfony\Component\HttpFoundation\Session\SessionInterface $session
+     * @param \Gregwar\CaptchaBundle\Generator\CaptchaGenerator $generator
+     * @param array $options
      */
-    private $key = 'captcha';
-
-    public function __construct(Session $session, $config)
+    public function __construct(SessionInterface $session, CaptchaGenerator $generator, TranslatorInterface $translator, $options)
     {
         $this->session      = $session;
-        $this->options = $config;
+        $this->generator    = $generator;
+        $this->translator = $translator;
+        $this->options      = $options;
     }
 
+    /**
+     * @param \Symfony\Component\Form\FormBuilderInterface $builder
+     * @param array $options
+     */
     public function buildForm(FormBuilderInterface $builder, array $options)
     {
-        $this->key = $builder->getForm()->getName();
+        $this->key = 'gcb_'.$builder->getForm()->getName();
 
-        $builder->addValidator(
-            new CaptchaValidator($this->session, $this->key)
+        $validator = new CaptchaValidator(
+            $this->translator,
+            $this->session,
+            $this->key,
+            $options['invalid_message'],
+            $options['bypass_code'],
+            $options['humanity']
         );
+
+        $builder->addEventListener(FormEvents::POST_BIND, array($validator, 'validate'));
     }
 
-    public function buildView(FormViewInterface $view, FormInterface $form, array $options)
+    /**
+     * @param \Symfony\Component\Form\FormView $view
+     * @param \Symfony\Component\Form\FormInterface $form
+     * @param array $options
+     */
+    public function buildView(FormView $view, FormInterface $form, array $options)
     {
-        $fingerprint = null;
+        $isHuman = false;
 
-        if ($options['keep_value'] && $this->session->has($this->key.'_fingerprint')) {
-            $fingerprint = $this->session->get($this->key.'_fingerprint');
+        if ($options['reload'] && !$options['as_url']) {
+            throw new \InvalidArgumentException('GregwarCaptcha: The reload option cannot be set without as_url, see the README for more information');
         }
 
-        $generator = new CaptchaGenerator($this->generateCaptchaValue(), 
-                                          $options['image_folder'], 
-                                          $options['web_path'], 
-                                          $options['gc_freq'], 
-                                          $options['expiration'], 
-                                          $options['font'], 
-                                          $fingerprint, 
-                                          $options['quality']);
-
-        if ($options['as_file']) {
-            $captchaCode = $generator->getFile($options['width'], $options['height']);
-        } else {
-            $captchaCode = $generator->getCode($options['width'], $options['height']);
+        if ($options['humanity'] > 0) {
+            $humanityKey = $this->key.'_humanity';
+            if ($this->session->get($humanityKey, 0) > 0) {
+                $isHuman = true;
+            }
         }
 
-        if ($options['keep_value']) {
-            $this->session->set($this->key.'_fingerprint', $generator->getFingerprint());
+        if ($options['as_url']) {
+            $key = $this->key;
+            $keys = $this->session->get($options['whitelist_key'], array());
+            if (!in_array($key, $keys)) {
+                $keys[] = $key;
+            }
+            $this->session->set($options['whitelist_key'], $keys);
+            $options['session_key'] = $this->key;
         }
 
-        $view->addVars(array(
+        $view->vars = array_merge($view->vars, array(
             'captcha_width'     => $options['width'],
             'captcha_height'    => $options['height'],
-            'captcha_code'      => $captchaCode,
+            'reload'            => $options['reload'],
+            'image_id'          => uniqid('captcha_'),
+            'captcha_code'      => $this->generator->getCaptchaCode($options),
             'value'             => '',
+            'is_human'          => $isHuman
         ));
+
+        $persistOptions = array();
+        foreach (array('phrase', 'width', 'height', 'distortion', 'length', 'quality') as $key) {
+            $persistOptions[$key] = $options[$key];
         }
 
+        $this->session->set($this->key, $persistOptions);
+    }
+
+    /**
+     * @param \Symfony\Component\OptionsResolver\OptionsResolverInterface $resolver
+     */
     public function setDefaultOptions(OptionsResolverInterface $resolver)
     {
-        $this->options['property_path'] = false;        
+        $this->options['mapped'] = false;
         $resolver->setDefaults($this->options);
     }
 
+    /**
+     * @return string
+     */
     public function getParent()
     {
         return 'text';
     }
 
+    /**
+     * @return string
+     */
     public function getName()
     {
         return 'captcha';
     }
-
-    private function generateCaptchaValue()
-    {
-        if (!$this->options['keep_value'] || !$this->session->has($this->key)) {
-            $value = '';
-            $chars = str_split($this->options['charset']);
-
-            for ($i=0; $i<$this->options['length']; $i++) {
-                $value.= $chars[array_rand($chars)];
-            }
-
-            $this->session->set($this->key, $value);
-        } else {
-            $value = $this->session->get($this->key);
-        }
-
-        return $value;
-    }
 }

Validator/CaptchaValidator.php

@@ -2,20 +2,20 @@
 
 namespace Gregwar\CaptchaBundle\Validator;
 
-use Symfony\Component\Form\FormValidatorInterface;
-use Symfony\Component\HttpFoundation\Session\Session;
-use Symfony\Component\Form\FormInterface;
+use Symfony\Component\HttpFoundation\Session\SessionInterface;
 use Symfony\Component\Form\FormError;
+use Symfony\Component\Form\FormEvent;
+use Symfony\Component\Translation\TranslatorInterface;
 
 /**
  * Captcha validator
  *
  * @author Gregwar <g.passault@gmail.com>
  */
-class CaptchaValidator implements FormValidatorInterface
+class CaptchaValidator
 {
     /**
-     * Session
+     * @var \Symfony\Component\HttpFoundation\Session\SessionInterface
      */
     private $session;
 
@@ -24,45 +24,139 @@ class CaptchaValidator implements FormValidatorInterface
      */
     private $key;
 
-    public function __construct(Session $session, $key)
+    /**
+     * Error message text for non-matching submissions
+     */
+    private $invalidMessage;
+
+    /**
+     * Configuration parameter used to bypass a required code match
+     */
+    private $bypassCode;
+
+    /**
+     * Number of form that the user can submit without captcha
+     * @var int
+     */
+    private $humanity;
+
+    /**
+     * Translator
+     * @var TranslatorInterface
+     */
+    private $translator;
+
+    /**
+     * @param \Symfony\Component\HttpFoundation\Session\SessionInterface $session
+     * @param string $key
+     * @param string $invalidMessage
+     * @param string|null $bypassCode
+     */
+    public function __construct(TranslatorInterface $translator, SessionInterface $session, $key, $invalidMessage, $bypassCode, $humanity)
     {
+        $this->translator       = $translator;
         $this->session          = $session;
         $this->key              = $key;
+        $this->invalidMessage   = $invalidMessage;
+        $this->bypassCode       = $bypassCode;
+        $this->humanity         = $humanity;
     }
 
-    public function validate(FormInterface $form)
+    /**
+     * @param FormEvent $event
+     */
+    public function validate(FormEvent $event)
     {
-        $code = $form->getData();
-        $excepted_code = $this->getExceptedCode();
+        $form = $form = $event->getForm();
 
-        if (!($code && $excepted_code && is_string($code) && is_string($excepted_code)
-            && $this->niceize($code) == $this->niceize($excepted_code))) {
-            $form->addError(new FormError('Bad code value'));
+        $code = $form->getData();
+        $expectedCode = $this->getExpectedCode();
+
+        if ($this->humanity > 0) {
+            $humanity = $this->getHumanity();
+            if ($humanity > 0) {
+                $this->updateHumanity($humanity-1);
+                return;
+            }
+        }
+
+        if (!($code && is_string($code) && ($this->compare($code, $expectedCode) || $this->compare($code, $this->bypassCode)))) {
+            $form->addError(new FormError($this->translator->trans($this->invalidMessage, array(), 'validators')));
+        } else {
+            if ($this->humanity > 0) {
+                $this->updateHumanity($this->humanity);
+            }
         }
 
         $this->session->remove($this->key);
 
-        if ($this->session->has($this->key.'_fingerprint')) {
-            $this->session->remove($this->key.'_fingerprint');
+        if ($this->session->has($this->key . '_fingerprint')) {
+            $this->session->remove($this->key . '_fingerprint');
         }
     }
 
     /**
-     * Retrieve the excepted CAPTCHA code
+     * Retrieve the expected CAPTCHA code
+     *
+     * @return mixed|null
      */
-    private function getExceptedCode()
+    protected function getExpectedCode()
     {
-        if ($this->session->has($this->key)) {
-            return $this->session->get($this->key);
+        $options = $this->session->get($this->key, array());
+
+        if (is_array($options) && isset($options['phrase'])) {
+            return $options['phrase'];
         }
+
+        return null;
+    }
+
+    /**
+     * Retreive the humanity
+     *
+     * @return mixed|null
+     */
+    protected function getHumanity()
+    {
+        return $this->session->get($this->key . '_humanity', 0);
+    }
+
+    /**
+     * Updates the humanity
+     */
+    protected function updateHumanity($newValue)
+    {
+        if ($newValue > 0) {
+            $this->session->set($this->key . '_humanity', $newValue);
+        } else {
+            $this->session->remove($this->key . '_humanity');
+        }
+
         return null;
     }
 
     /**
      * Process the codes
+     *
+     * @param $code
+     *
+     * @return string
      */
-    private function niceize($code) 
+    protected function niceize($code)
     {
         return strtr(strtolower($code), 'oil', '01l');
     }
+
+    /**
+     * Run a match comparison on the provided code and the expected code
+     *
+     * @param $code
+     * @param $expectedCode
+     *
+     * @return bool
+     */
+    protected function compare($code, $expectedCode)
+    {
+        return ($expectedCode && is_string($expectedCode) && $this->niceize($code) == $this->niceize($expectedCode));
+    }
 }

composer.json

@@ -3,17 +3,22 @@
     "type": "captcha-bundle",
     "description": "Captcha bundle",
     "keywords": ["symfony2", "captcha", "bot", "visual", "code", "security", "spam"],
-    "homepage": "https://github.com/Gregwar/ImageBundle",
+    "homepage": "https://github.com/Gregwar/CaptchaBundle",
     "license": "MIT",
     "authors": [
         {
             "name": "Grégoire Passault",
             "email": "g.passault@gmail.com",
             "homepage": "http://www.gregwar.com/"
+        },
+        {
+            "name": "Jeremy Livingston",
+            "email": "jeremy.j.livingston@gmail.com"
         }
     ],
     "require": {
-        "php": ">=5.3.0"
+        "php": ">=5.3.0",
+        "gregwar/captcha": "v1.0.11"
     },
     "autoload": {
         "psr-0": {