Image optimization library inspired by psliwa/image-optimizer. It allows processing image paths by automatically detecting the file type and feeding it to certain chain.
Currently we support the following server side libraries for optimization. You must install them on your server in order to use this library. Of you want to add more you can do so by using your own command.
*Giflossy is a fork of gifsicle so you can use the main library by excluding the --lossy argument (see options)
Initialize the purifier with sensible defaults
$options = [];
$purifierFactory = new ImagePurifierFactory($options, $logger);
$purifier = $purifierFactory->create();
$purifier->purify('path/to/image.png');The ImagePurifierFactory takes two optional arguments $options and $logger.
This is an anatomy of an factory option
[
// This is the chain config. You can define your own chain and feed it commands
'chains' => [
JpegChain::class => [ // Chains must be real classes which contains commands to be executed
'commands' => [
'mozJpeg' => [
'bin' => 'cjpeg', // Path to the executable. The lbrary tries to resolve it itself
'arguments' => ['-optimize', '-progressive'], // What arguments to run
'customClass' => MozJpeg::class, // If you want you can give custom class that must implements our CommandInterface
],
],
'first_only' => false, // If this is true only the first command will be executed
],
...
],
'suppress_errors' => false // If set to true exceptions will be catched and only logs will be written,
]);You can pass custom logger to the ImagePurifierFactory which must implement Psr\Log\LoggerInterface
Pngquant will exit with code 98 if the file was already optimized (at least this is what we experienced on tests).
This is for you to handle if the errors are not suppressed. If this happens we throw CommandException with special code 98
*In general it is a good idea to make sure files are optimized only once.
Example:
try{
$purifier->purify($filePath);
}catch(CommandException $e){
if($e->getCode() === 98){
// handle png quant already processed
}
}To be done
You can run the tests by executing
composer testWe aim at 100% test coverage.