Image optimization / compression library. This library is able to optimize png, jpg and gif files in very easy and handy way. It uses optipng, pngquant, pngcrush, pngout, gifsicle, jpegoptim and jpegtran tools.
This library is handy and very easy to use optimizer for image files. It uses optipng, pngquant, jpegoptim and few more libraries, so before use it you should install proper libraries on your server. Project contains Vagrantfile that defines testing virtual machine with all libraries installed, so you can check Vagrantfile how to install all those stuff.
Thanks to ImageOptimizer and libraries that it uses, your image files can be 10%-70% smaller.
composer require ps/image-optimizer
$factory = new \ImageOptimizer\OptimizerFactory(); $optimizer = $factory->get(); $filepath = /* path to image */; $optimizer->optimize($filepath); //optimized file overwrites original one
By default optimizer does not throw any exception, if file can not be optimized or optimizing library for given file is
not installed, optimizer will not touch original file. This behaviour is ok when you want to eventually optimize files
uploaded by user. When in your use case optimization fault should cause exception,
ignore_errors option was created
especially for you.
This library is very smart, you do not have to configure paths to all binaries of libraries that are used by ImageOptimizer, library will be looking for those binaries in few places, so if binaries are placed in standard places, it will be found automatically.
execute_only_first_png_optimizer(default: true) - execute the first successful or all
execute_only_first_jpeg_optimizer(default: true) - execute the first successful or all
array('-i0', '-o2', '-quiet')) - an array of arguments to pass to the library
array('-reduce', '-q', '-ow'))
array('-s3', '-q', '-y'))
array('-z', '-4', '-q'))
optipng_bin(default: will be guessed) - you can enforce paths to binaries, but by default it will be guessed
You can pass array of options as first argument of
ImageOptimizer\OptimizerFactory constructor. Second argument is
$factory = new \ImageOptimizer\OptimizerFactory(array('ignore_errors' => false), $logger);
- default (
smart) - it guess file type and choose optimizer for this file type
png- chain of optimizers for png files, by default it uses
pngquantis lossy optimization
jpg- first of two optimizations will be executed:
gif- alias to
You can obtain concrete optimizer by passing his name to
//default optimizer is `smart` $optimizer = $factory->get(); //png optimizer $pngOptimizer = $factory->get('png'); //jpegoptim optimizer etc. $jpgOptimizer = $factory->get('jpegoptim');