README

此包是Laravel 5.7及以上版本对spatie/image-optimizer的特定集成。它可以通过一系列各种图像优化工具对PNG、JPG、SVG和GIF进行优化。该包将自动检测您的系统上安装了哪些优化二进制文件，并使用它们。

以下是使用方法

use ImageOptimizer;

// the image will be replaced with an optimized version which should be smaller
ImageOptimizer::optimize($pathToImage);

// if you use a second parameter the package will not modify the original
ImageOptimizer::optimize($pathToImage, $pathToOptimizedImage);

你说不喜欢门面？没问题！只需从容器中解析出配置的 Spatie\ImageOptimizer\OptimizerChain 实例

app(Spatie\ImageOptimizer\OptimizerChain::class)->optimize($pathToImage);

该包还包含一个中间件，可以自动优化所有请求中的图片。

你说不用Laravel？没问题！只需直接使用底层的spatie/image-optimizer。

安装

您可以通过composer安装此包

composer require spatie/laravel-image-optimizer

该包将自动注册自己。

该包使用许多二进制文件来优化图片。有关如何安装它们的信息，请参阅底层image-optimizer包的优化工具部分。该README还包含有关这些工具将对您的图片做什么的信息。

该包包含一些合理的默认值以优化图片。您可以通过发布配置文件来修改该配置。

php artisan vendor:publish --provider="Spatie\LaravelImageOptimizer\ImageOptimizerServiceProvider"

这是将要发布的config/image-optimizer文件的内容

use Spatie\ImageOptimizer\Optimizers\Svgo;
use Spatie\ImageOptimizer\Optimizers\Optipng;
use Spatie\ImageOptimizer\Optimizers\Gifsicle;
use Spatie\ImageOptimizer\Optimizers\Pngquant;
use Spatie\ImageOptimizer\Optimizers\Jpegoptim;

return [
    /**
     * When calling `optimize` the package will automatically determine which optimizers
     * should run for the given image.
     */
    'optimizers' => [

        Jpegoptim::class => [
            '-m85', // set maximum quality to 85%
            '--strip-all',  // this strips out all text information such as comments and EXIF data
            '--all-progressive'  // this will make sure the resulting image is a progressive one
        ],

        Pngquant::class => [
            '--force' // required parameter for this package
        ],

        Optipng::class => [
            '-i0', // this will result in a non-interlaced, progressive scanned image
            '-o2',  // this set the optimization level to two (multiple IDAT compression trials)
            '-quiet' // required parameter for this package
        ],

        Svgo::class => [
            '--disable=cleanupIDs' // disabling because it is know to cause troubles
        ],

        Gifsicle::class => [
            '-b', // required parameter for this package
            '-O3' // this produces the slowest but best results
        ],
    ],

    /**
     * The maximum time in seconds each optimizer is allowed to run separately.
     */
    'timeout' => 60,

    /**
     * If set to `true` all output of the optimizer binaries will be appended to the default log.
     * You can also set this to a class that implements `Psr\Log\LoggerInterface`.
     */
    'log_optimizer_activity' => false,
];

如果您想自动优化上传到您应用程序的图片，请将\Spatie\LaravelImageOptimizer\Middlewares\OptimizeImages::class添加到http内核中。

// app/Http/Kernel.php
protected $routeMiddleware = [
   ...
   'optimizeImages' => \Spatie\LaravelImageOptimizer\Middlewares\OptimizeImages::class,
];

用法

您可以从容器中解析出配置的 Spatie\ImageOptimizer\OptimizerChain 实例

// the image will be replaced with an optimized version which should be smaller
app(Spatie\ImageOptimizer\OptimizerChain::class)->optimize($pathToImage);

// if you use a second parameter the package will not modify the original
app(Spatie\ImageOptimizer\OptimizerChain::class)->optimize($pathToImage, $pathToOptimizedImage);

使用门面

use ImageOptimizer;

// the image will be replaced with an optimized version which should be smaller
ImageOptimizer::optimize($pathToImage);

// if you use a second parameter the package will not modify the original
ImageOptimizer::optimize($pathToImage, $pathToOptimizedImage);

你说不喜欢门面？没问题！只需从容器中解析出配置的 Spatie\ImageOptimizer\OptimizerChain 实例

app(Spatie\ImageOptimizer\OptimizerChain::class)->optimize($pathToImage);

使用中间件

所有请求到使用optimizeImages-中间件的路线的图片都将自动优化。

Route::middleware('optimizeImages')->group(function () {
    // all images will be optimized automatically
    Route::post('upload-images', 'UploadController@index');
});

添加您自己的优化器

要了解如何创建自己的优化器，请参阅底层spatie/image-optimizer包的README中的“编写自定义优化器”部分。

您可以在配置文件中的optimizers数组中将您优化器的完全限定类名作为键添加。

示例转换

以下是优化器做出的一些示例转换。

变更日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

测试

composer test

贡献

请参阅CONTRIBUTING以获取详细信息。

安全

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

明信片软件

您可自由使用此软件包（它遵循MIT许可协议），但如果它进入了您的生产环境，我们非常欢迎您从家乡给我们寄一张明信片，注明您正在使用我们的哪个软件包。

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

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

致谢

中间件优化请求中所有文件的思路来源于approached/laravel-image-optimizer。

支持我们

Spatie是一家位于比利时的安特卫普的网页设计公司。您可以在我们的网站上找到我们所有开源项目的概述。

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

许可协议

MIT许可协议（MIT）。请参阅许可文件以获取更多信息。

tnhnclskn / laravel-image-optimizer

维护者

详细信息