Intervention/image · error · DriverException

Failed to create new core

Error message

Failed to create new core

What it means

Constructing the internal Core around a fresh new Imagick() threw an ImagickException inside Driver::createCore(). This is an internal/low-level path used when assembling multi-frame cores; it is rare and almost always signals an Imagick object state problem rather than bad arguments. The native exception is chained as previous.

Source

Thrown at src/Drivers/Imagick/Driver.php:91

            throw new DriverException('Failed to create new image', previous: $e);
        }

        return new Image($this, new Core($imagick));
    }

    /**
     * {@inheritdoc}
     *
     * @see DriverInterface::createCore()
     *
     * @throws DriverException
     */
    public function createCore(array $frames): CoreInterface
    {
        try {
            $core = new Core(new Imagick());
        } catch (ImagickException $e) {
            throw new DriverException('Failed to create new core', previous: $e);
        }

        foreach ($frames as $frame) {
            $core->add($frame);
        }

        $this->applyDefaultSettings($core->native());

        return $core;
    }

    /**
     * {@inheritdoc}
     *
     * @see DriverInterface::colorProcessor()
     */
    public function colorProcessor(ImageInterface $image): ColorProcessorInterface
    {

View on GitHub (pinned to 5598b9e397)

Solutions

  1. Read $e->getPrevious()->getMessage() for the native reason
  2. Ensure every entry in $frames is a valid Imagick single-frame object
  3. If the imagick extension version is out of sync with the ImageMagick library, reinstall/align them and restart the worker
Defensive patterns

Strategy: try-catch

Try / catch

try {
    $core = $driver->createCore($frames);
} catch (\Intervention\Image\Exceptions\DriverException $e) {
    $native = $e->getPrevious()?->getMessage() ?? 'unknown';
    throw new RuntimeException('Core creation failed: ' . $native, 0, $e);
}

Prevention

When it happens

Trigger: Animation composition paths that call createCore() with frames while the Imagick extension/environment is in a degraded state; passing frames that leave the core in an inconsistent state.

Common situations: Long-running workers whose Imagick state degraded after prior errors; mismatched imagick extension vs ImageMagick library versions.

Related errors


AI-assisted analysis of Intervention/image@5598b9e397 (2026-08-23). Data as JSON: /api/errors/4167c677042d66a2. Report an issue: GitHub.