README

本包可以通过一系列图像优化工具来优化PNG、JPG、SVG和GIF图像。以下是使用方法：

use Spatie\ImageOptimizer\OptimizerChainFactory;

$optimizerChain = OptimizerChainFactory::create();

$optimizerChain->optimize($pathToImage);

位于$pathToImage的图像将被优化版本覆盖，该版本应该更小。包将自动检测您系统上安装了哪些优化二进制文件并使用它们。

以下是该包已完成的一些示例转换。

喜欢Laravel吗？那么请转到Laravel特定集成。

安装

您可以通过composer安装此包

composer require spatie/image-optimizer

优化工具

如果系统上存在这些优化器，则包将使用它们

以下是如何在Ubuntu上安装所有优化器的方法

sudo apt-get install jpegoptim
sudo apt-get install optipng
sudo apt-get install pngquant
sudo npm install -g svgo
sudo apt-get install gifsicle

以下是如何在MacOS上安装二进制文件的方法（使用Homebrew）

brew install jpegoptim
brew install optipng
brew install pngquant
brew install svgo
brew install gifsicle

哪些工具将做什么？

包将自动决定针对特定图像使用哪些工具。

JPGs

通过运行JpegOptim来减小JPG文件的大小。以下选项将被使用

-m85：这将以85%的质量存储图像。此设置似乎满足了Google的Pagespeed压缩规则
--strip-all：这将移除所有文本信息，例如注释和EXIF数据
--all-progressive：这将确保生成的图像是渐进式的，这意味着可以使用多个传递下载具有更高细节的图像。

PNGs

通过运行两个工具来减小PNG文件的大小。第一个是Pngquant 2，一个有损PNG压缩器。我们不设置额外的选项，使用它们的默认选项。之后，我们将图像通过第二个工具运行：Optipng。以下选项将被使用

-i0：这将生成一个非交错、渐进式扫描的图像
-o2：这将优化级别设置为二（多个IDAT压缩尝试）

SVGs

通过SVGO最小化SVG。将使用SVGO的默认配置，省略了cleanupIDs插件，因为已知该插件在单页上显示多个优化SVG时会引起问题。

请注意，SVGO可能会破坏您的svg。您可以在Sara Soueidan的这篇出色的博客文章中找到更多关于此的信息。

GIFs

通过Gifsicle优化GIF。以下选项将被使用

-O3：这将优化级别设置为Gifsicle的最大值，这会产生最慢但最好的结果

使用方法

这是使用包的默认方式

use Spatie\ImageOptimizer\OptimizerChainFactory;

$optimizerChain = OptimizerChainFactory::create();

$optimizerChain->optimize($pathToImage);

位于 $pathToImage 的图像将被一个优化版本覆盖，该版本应该更小。

该软件包将自动检测您的系统上安装了哪些优化二进制文件，并使用它们。

要保留原始图像，您可以通过传递一个名为optimize的第二个参数来实现。

use Spatie\ImageOptimizer\OptimizerChainFactory;

$optimizerChain = OptimizerChainFactory::create();

$optimizerChain->optimize($pathToImage, $pathToOutput);

在示例中，该软件包不会修改 $pathToImage，而是将优化版本写入 $pathToOutput。

设置超时

您可以通过调用 setTimeout 来设置每个单独优化器在链中使用的最大秒数。

$optimizerChain
    ->setTimeout(10)
    ->optimize($pathToImage);

在此示例中，链中的每个优化器将有最多10秒的时间来完成其工作。

创建您自己的优化链

如果您想自定义优化器的链，可以通过手动将 Optimizer 添加到 OptimizerChain 来实现。

以下是一个示例，我们只希望使用 optipng 和 jpegoptim。

use Spatie\ImageOptimizer\OptimizerChain;
use Spatie\ImageOptimizer\Optimizers\Jpegoptim;
use Spatie\ImageOptimizer\Optimizers\Pngquant;

$optimizerChain = (new OptimizerChain)
   ->addOptimizer(new Jpegoptim([
       '--strip-all',
       '--all-progressive',
   ]))

   ->addOptimizer(new Pngquant([
       '--force',
   ]))

请注意，您可以将 Optimizer 应用的选项传递给其构造函数。

编写自定义优化器

想使用其他命令行工具来优化图像？没问题。只需编写自己的优化器。优化器是实现 Spatie\ImageOptimizer\Optimizers\Optimizer 接口的任何类。

namespace Spatie\ImageOptimizer\Optimizers;

use Spatie\ImageOptimizer\Image;

interface Optimizer
{
    /**
     * Returns the name of the binary to be executed.
     *
     * @return string
     */
    public function binaryName(): string;

    /**
     * Determines if the given image can be handled by the optimizer.
     *
     * @param \Spatie\ImageOptimizer\Image $image
     *
     * @return bool
     */
    public function canHandle(Image $image): bool;

    /**
     * Set the path to the image that should be optimized.
     *
     * @param string $imagePath
     *
     * @return $this
     */
    public function setImagePath(string $imagePath);

    /**
     * Set the options the optimizer should use.
     *
     * @param array $options
     *
     * @return $this
     */
    public function setOptions(array $options = []);

    /**
     * Get the command that should be executed.
     *
     * @return string
     */
    public function getCommand(): string;
}

如果您想查看示例实现，请查看该软件包中附带的可用的优化器：现有优化器。

您可以通过在 OptimizerChain 上使用 addOptimizer 方法轻松添加您的优化器。

use Spatie\ImageOptimizer\ImageOptimizerFactory;

$optimizerChain = OptimizerChainFactory::create();

$optimizerChain
   ->addOptimizer(new YourCustomOptimizer())
   ->optimize($pathToImage);

记录优化过程

默认情况下，该软件包不会抛出任何错误，只是静默操作。要验证软件包正在做什么，您可以设置一个记录器。

use Spatie\ImageOptimizer\OptimizerChainFactory;

$optimizerChain = OptimizerChainFactory::create();

$optimizerChain
   ->useLogger(new MyLogger())
   ->optimize($pathToImage);

记录器是实现 Psr\Log\LoggerInterface 的类。一个完全兼容的好日志库是 Monolog。该软件包将记录使用的 Optimizers、执行的命令及其输出。

示例转换

以下是一些由该软件包完成的实际转换示例。

png

原始：Photoshop '网页保存' | PNG-24 带透明度
40 Kb

优化
16 Kb (40%)

jpg

原始：Photoshop '网页保存' | 质量 60，已优化
547 Kb

优化
525 Kb (95%)

致谢：Jeff Sheldon，via Unsplash

svg

原始：Illustrator | 网络优化 SVG 导出
26 Kb

优化
20 Kb (76%)

变更日志

有关最近更改的更多信息，请参阅变更日志。

测试

composer test

贡献

有关详细信息，请参阅贡献。

安全

如果您发现任何安全相关的问题，请通过电子邮件 freek@spatie.be 反馈，而不是使用问题跟踪器。

明信片软件

您可以使用此软件包（它是 MIT 许可的），但如果它进入您的生产环境，我们非常感谢您从您的家乡寄给我们一张明信片，说明您正在使用我们的哪些软件包。

我们的地址是：Spatie，Samberstraat 69D，2060 安特卫普，比利时。

我们将所有收到的明信片发布在我们的公司网站上。

致谢

此软件包受到 psliwa/image-optimizer 的启发。

由 Joke Forment 提供

支持我们

斯帕蒂是一家位于比利时安特卫普的网页设计公司。您可以在我们的网站上找到所有开源项目的概述。点击这里查看。

您的业务是否依赖于我们的贡献？请通过Patreon联系我们并支持我们。所有承诺都将用于分配人力资源进行维护和新功能开发。

许可协议

MIT 许可协议（MIT）。有关更多信息，请参阅许可文件。

tnduoc / image-optimizer

维护者

详细信息