dumkaaa/bxoptimize

BxOptimize

Библиотека под 1C-Битрикс для оптимизации и сжатия картинок, стилей, скриптов прочей статики., _(*1)

, _(*2)

Позволяет сжимать и оптимизировать размер файлов картинок (png, jpg, gif, webp), стилей (css) и скриптов (js)., _(*3)

При этом оригинальные файлы сохраняются рядом с измененным в виде file.png > file.png.original для возможности восстановления., _(*4)

Установка

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

Базовое использование

• Запуск из PHP, _(*5)

  $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();
  

• Запуск из консоли, _(*6)

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

  Параметры: path/to/dir - пусть к папке для поиска файлов (обязательный) [<images css js>] - массив обработчиков (необязательный, по умолчанию - все), _(*7)

• Запуск из cli, _(*8)

  • В файл cli.php добавить строку:, _(*9)

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

  • Запуск:, _(*10)

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

Расширенное использование

Можно подключать свои обработчики или заменять стандартные. При этом класс обработчика должен наследоваться от Dumkaaa\BxOptimize\Handler\Handler или реализовывать интерфейс Dumkaaa\BxOptimize\Handler\HandlerInterface., _(*11)

Кастомные обработчики должны быть добавлены в массив обработчиков ($handlers) перед запуском или вызовом метода addHandler($key, $classname, $replace = false) класса Dumkaaa\BxOptimize\Handler\HandlerProcessor, _(*12)

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

Badges

, _(*13)

, _(*14)

, _(*15)

, _(*16)