dskripchenko / image-optimizer
图像优化/压缩库。该库可以非常简单方便地对 png、jpg 和 gif 文件进行优化。它使用了 optipng、pngquant、pngcrush、pngout、gifsicle、jpegoptim 和 jpegtran 工具。
Requires
- php: ^7.3 | ^8.0
- psr/log: ^3.0
- symfony/options-resolver: ~3.3 | ~4.0 | ~5.0
- symfony/process: ~3.3 | ~4.0 | ~5.0 | ~6.0
Requires (Dev)
- ext-gd: *
- phpunit/phpunit: ^9.5
This package is auto-updated.
Last update: 2024-09-10 12:54:20 UTC
README
这是一个方便且易于使用的图像文件优化器库。它使用了 optipng、pngquant、jpegoptim、svgo 等其他一些库,因此在使用之前,您应在服务器上安装适当的库。项目包含 Vagrantfile,它定义了安装了所有库的测试虚拟机,因此您可以通过查看 Vagrantfile 来检查如何安装所有这些内容。
感谢 ImageOptimizer 及其使用的库,您的图像文件可以减小到 10%-70%。
安装
使用 composer
composer require dskripchenko/image-optimizer
基本用法
$factory = new \ImageOptimizer\OptimizerFactory(); $optimizer = $factory->get(); $filepath = /* path to image */; $optimizer->optimize($filepath); //optimized file overwrites original one
配置
默认情况下,优化器不会抛出任何异常,如果文件无法优化或给定文件的优化库未安装,优化器将不会修改原始文件。当您想最终优化用户上传的文件时,这种行为是合适的。当您的用例中优化故障应导致异常时,已为这种情况创建了 ignore_errors
选项。
这个库非常智能,您无需配置 ImageOptimizer 所使用的所有库的二进制文件路径,库将在几个位置查找这些二进制文件,因此如果二进制文件放置在标准位置,它将自动找到。
支持选项
ignore_errors
(默认:true)single_optimizer_timeout_in_seconds
(默认:60) - 当您想控制优化持续的时间时很有用。例如,在某些情况下,当优化需要很长时间时,优化可能不值得。通过传递null
来关闭超时。output_filepath_pattern
(默认:%basename%/%filename%%ext%
) - 存储优化后文件的目录。默认情况下,它将覆盖原始文件。有 3 个占位符:%basename%
、%filename%
(不带扩展名和点)和%ext%
(带点的扩展名),它们将由原始文件中的值替换。execute_only_first_png_optimizer
(默认:true) - 执行第一个成功或所有png
优化器execute_only_first_jpeg_optimizer
(默认:true) - 执行第一个成功或所有jpeg
优化器optipng_options
(默认:array('-i0', '-o2', '-quiet')
) - 要传递给库的参数数组pngquant_options
(默认:array('--force')
)pngcrush_options
(默认:array('-reduce', '-q', '-ow')
)pngout_options
(默认:array('-s3', '-q', '-y')
)advpng_options
(默认:array('-z', '-4', '-q')
)gifsicle_options
(默认:array('-b', '-O5')
)jpegoptim_options
(默认:array('--strip-all', '--all-progressive')
)jpegtran_options
(默认:array('-optimize', '-progressive')
)svgo_options
(默认:array('--disable=cleanupIDs')
)custom_optimizers
(默认array()
)optipng_bin
(默认:将自动猜测) - 您可以强制指定二进制文件的路径,但默认情况下将自动猜测pngquant_bin
pngcrush_bin
pngout_bin
advpng_bin
gifsicle_bin
jpegoptim_bin
jpegtran_bin
svgo_bin
您可以将选项数组作为ImageOptimizer\OptimizerFactory
构造函数的第一个参数传入。第二个参数是可选的Psr\LoggerInterface
。
$factory = new \ImageOptimizer\OptimizerFactory(array('ignore_errors' => false), $logger);
支持的优化器
- 默认(
smart
)- 它猜测文件类型并为该文件类型选择优化器 png
- png文件的优化器链,默认使用pngquant
和optipng
。其中pngquant
是损失性优化jpg
- 将执行两种优化中的第一种:jpegtran
或jpegoptim
gif
-gifsicle
的别名pngquant
- 主页optipng
- 主页pngcrush
- 主页pngout
- 主页advpng
- 主页jpegtran
- 主页jpegoptim
- 主页gifsicle
- 主页svgo
- 主页
您可以通过将优化器名称传递给ImageOptimizer\OptimizerFactory
::get
方法来获取具体的优化器
//default optimizer is `smart` $optimizer = $factory->get(); //png optimizer $pngOptimizer = $factory->get('png'); //jpegoptim optimizer etc. $jpgOptimizer = $factory->get('jpegoptim');
自定义优化器
您可以轻松定义自定义优化器
$factory = new \ImageOptimizer\OptimizerFactory(array('custom_optimizers' => array( 'some_optimizier' => array( 'command' => 'some_command', 'args' => array('-some-flag') ) )), $logger);
然后使用
$customOptimizer = $factory->get('some_optimizier');
我得到“所有优化器都未能优化该文件”
可能您没有安装所需的优化器。让我们查看Vagrantfile
文件,以查看如何安装这些命令的示例。
为了查看所有中间错误,您可以使用日志记录器(默认情况下使用NullLogger
,因此日志不可用)
class StdoutLogger extends \Psr\Log\AbstractLogger { public function log($level, $message, array $context = array()) { echo $message."\n"; } } $factory = new \ImageOptimizer\OptimizerFactory(array(), new StdoutLogger()); $factory->get()->optimize('yourfile.jpg'); // and have a look at stdout
许可协议
MIT