Intervention/image · error · InvalidArgumentException

Unable to extract file extension from path "' . $this->path

Error message

Unable to extract file extension from path "' . $this->path . '"

What it means

FilePathEncoder::encode() determines the target format from pathinfo($this->path, PATHINFO_EXTENSION), or from the origin file extension when the path is null. When the path carries no extension at all (pathinfo returns ''), or the origin fallback is null, it throws InvalidArgumentException because no format can be determined.

Source

Thrown at src/Encoders/FilePathEncoder.php:40

        );
    }

    /**
     * {@inheritdoc}
     *
     * @see EncoderInterface::encode()
     *
     * @throws InvalidArgumentException
     * @throws NotSupportedException
     */
    public function encode(ImageInterface $image): EncodedImageInterface
    {
        $extension = is_null($this->path) ?
            $image->origin()->fileExtension() :
            pathinfo($this->path, PATHINFO_EXTENSION);

        if ($extension === null || $extension === '') {
            throw new InvalidArgumentException(
                'Unable to extract file extension from path "' . $this->path . '"',
            );
        }

        return $image->encode(
            $this->encoderByFileExtension(
                $extension,
            ),
        );
    }
}

View on GitHub (pinned to 5598b9e397)

Solutions

1. Append a supported extension to the output path: 'photos/final.jpg'
2. Check the path before saving and default the extension when missing
3. If the extension is intentionally absent, encode by an explicit encoder first and write the result yourself

Example fix

// before
$path = 'uploads/' . $post->slug; // 'uploads/my-blog-post' -> no extension
$image->save($path);

// after
$path = 'uploads/' . $post->slug . '.webp';
$image->save($path);

if (pathinfo($path, PATHINFO_EXTENSION) === '') {
    $path .= '.jpg'; // ensure an extension is present
}
$image->save($path);

function pathHasExtension(string $path): bool
{
    return pathinfo($path, PATHINFO_EXTENSION) !== '';
}

use Intervention\Image\Exceptions\InvalidArgumentException;

try {
    $image->encodeUsingPath($path);
} catch (InvalidArgumentException $e) {
    $image->encodeUsingPath($path . '.png');
}

When it happens

Trigger: Calling $image->save('photos/final') or $image->encodeUsingPath('/tmp/out') where the filename has no dot; saving dotfile-style names such as '.htaccess' (pathinfo reports no extension); or constructing new FilePathEncoder(null) for an image whose origin has no file extension.

Common situations: Filenames assembled from slugs, UUIDs or hashes where the extension part got lost during string building; security code that strips the original upload extension; template paths with a missing extension placeholder.

Related errors

• Argument $extension must not be an empty string
• Unable to find encoder for unknown image file extension "' .
• Quality must be in range 0 to 100
• Quality must be in range 0 to 100
• Quality must be in range 0 to 100

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