Intervention/image · error · ModifierException

Failed to apply {self::class}, {message}

Error message

Failed to apply {self::class}, {message}

What it means

Error "Failed to apply {self::class}, {message}" thrown in Intervention/image.

Source

Thrown at src/Modifiers/AbstractDrawModifier.php:64

    {
        $borderColor = $this->drawable()->borderColor();

        if ($borderColor === null || $this->drawable()->hasBorder() === false) {
            return Color::transparent();
        }

        return $this->driver()->decodeColor($borderColor);
    }

    /**
     * Throw ModifierException with given message if result is false.
     *
     * @throws ModifierException
     */
    protected function abortUnless(mixed $result, string $message): void
    {
        if ($result === false) {
            throw new ModifierException(
                'Failed to apply ' . self::class . ', ' . $message,
            );
        }
    }
}

View on GitHub (pinned to 5598b9e397)

Solutions

1. Inspect the wrapped {message} for the driver-level cause and fix that first (invalid color, coordinates, or draw state)
2. Validate all drawing parameters (points, colors, sizes) before applying the draw modifier
3. Check the driver-specific documentation for the drawing primitive you use (line, polygon, ellipse, bezier)

When it happens

Trigger: Thrown at src/Modifiers/AbstractDrawModifier.php:64 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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