A generator is responsible for generating challenge images and providing it back to the challenge processor. You may either use one of the provided generators, or implement your own if you wish to do so.

Generators for the GD and Imagick extensions are available by default. To use either of these generators, ensure that the GD extension or ImageMagick is installed and enabled for image processing.

The GD generator is located at \IconCaptcha\Challenge\Generators\GD::class, and the Imagick generator is located at \IconCaptcha\Challenge\Generators\Imagick::class.

The generator can be configured in the PHP configuration with the challenge.generator option.

'generator' => \IconCaptcha\Challenge\Generators\GD::class,

If you wish to create your own generator, ensure that your custom generator class extends the \IconCaptcha\Challenge\Image\AbstractImageGenerator class and implements all required functions. The AbstractImageGenerator base class implements the interface \IconCaptcha\Challenge\Image\ImageGeneratorInterface, which contains the function definitions which must be implemented.

use IconCaptcha\Challenge\Image\AbstractImageGenerator;

class YourGenerator extends AbstractImageGenerator
{
    public function loadImage(string $path)
    {
        // return ...;
    }

    // ...

    public function render($image): string
    {
        // ...

        return base64_encode($output);
    }
}

The following functions must be implemented in your custom challenge generator.