dumkaaa/bxoptimize

0.0.4 2017-04-04 05:10 UTC

This package is not auto-updated.

Last update: 2024-09-29 01:17:41 UTC


README

1C-Битрикс的图片优化和压缩库。

Latest Stable Version Latest Unstable Version PHP version Dependency Status

允许压缩和优化图片文件(png, jpg, gif, webp)、样式(css)和脚本(js)的大小。

同时,原始文件以file.png > file.png.original的形式保存在更改文件旁边,以便恢复。

安装

composer require dumkaaa/bxoptimize
composer run-script post-install-cmd -d ./vendor/dumkaaa/bxoptimize

基本使用

  • 从PHP运行

    $path = 'path/to/dir'; // пусть к папке для поиска файлов (обязательный)
    $finder = new \Dumkaaa\BxOptimize\Finder\FilesFinder($path);
    
    $handlers = [ //массив обработчиков (необязательный, по умолчанию - все)
        'image',
        'css',
    ]; 
    $handler = new \Dumkaaa\BxOptimize\Handler\HandlerProcessor($handlers);
    
    $optimizer = new \Dumkaaa\BxOptimize\Optimizer($finder, $handler);
    $optimizer->optimize();
  • 从命令行运行

    php path/to/vendor/bin/bxoptimize bxoptimize:optimize path/to/dir [<image css js>]

    参数: path/to/dir - 要搜索文件的文件夹路径(必需) [<images css js>] - 处理器数组(可选,默认为所有)

  • 从命令行运行

    • 在cli.php文件中添加以下行

      $application->add(new \Dumkaaa\BxOptimize\Cli\SymfonyOptimize());
    • 运行

      php cli.php bxoptimize:optimize path/to/dir [<image css js>]

扩展使用

可以连接自己的处理器或替换标准处理器。在这种情况下,处理器类必须继承自Dumkaaa\BxOptimize\Handler\Handler或实现Dumkaaa\BxOptimize\Handler\HandlerInterface接口。

自定义处理器应在启动前添加到处理器数组($handlers)或通过调用类Dumkaaa\BxOptimize\Handler\HandlerProcessoraddHandler($key, $classname, $replace = false)方法中添加。

    $handler->addHandler('css', '\\My\\Custom\\Handler\\CssHandler');

徽章

Scrutinizer Code Quality StyleCI Code Climate Issue Count

Build Status Code Coverage

License PHPPackages Rank

composer.lock