Generation fails early for missing input, unsupported image formats, invalid colors, or an unavailable rasterization pipeline.
| Error | Cause |
|---|---|
MissingInputFileException |
The configured source path is not a file |
RasterizerUnavailableException |
No compatible adapter completed rasterization |
FaviconException |
Base runtime failure for package generation errors |
InvalidArgumentException |
A color is not a six-digit hexadecimal value |
use Alto\Favicon\Exception\FaviconException;
try {
$report = $generator->generate($options);
} catch (FaviconException $error) {
// Report the failed generation.
}The rasterizer pipeline logs adapter failures through the optional PSR logger before trying the next adapter. Inject a logger when diagnostics need to expose which executable or extension failed.
Existing output files are not errors. They are skipped unless force mode is
enabled and appear as skipped in the generation report.