[recovery mode] Hermitage — решение ваших проблем с хранением и обработкой изображений19.09.2016 18:33

Всем привет! Буду краток: в обмен на пять минут вашего времени отдел PHP-разработки компании Лайв Тайпинг расскажет вам о собственном микросервисе для хранения и обработки загружаемых изображений. Он называется Hermitage. Его задача — представлять изображение в разных версиях согласно заранее заданным параметрам. Hermitage будет полезен в ситуациях, когда необходим автономный и масштабируемый сервер для хранения изображений и манипуляций над ними.
hermitage

Чем хорош Hermitage на фоне других
Для примера возьмём Glide. Помимо того, что он и ему подобные сервисы каждый раз имеет дело с оригиналом изображения, обрабатывая его «на лету», он также принимает параметры манипуляции в каждом запросе к изображению. Это не только нагружает систему, но и вынуждает клиентскую сторону каждый раз передавать параметры для необходимой версии изображения.

С Hermitage клиент получает не обработанный здесь и сейчас исходник, а его версию. Для получения нужной версии изображения вы должны передать с запросом только название версии.

Когда сервер впервые получит запрос на выдачу версии, он произведет манипуляции над изображением по заранее известным ему параметрам и при следующих обращениях будет отдавать уже готовое изображение.

Изображения хранятся на любом удобном для вас хранилище, будь то AWS S3, Dropbox или FTP. Абстрагироваться от одного конкретного хранилища и подключить любое из них помогает библиотека FlySystem, а для манипуляций над изображениями используется Image от Intervention.

Как работает Hermitage
В целях экономии вашего времени мы сделали весёлые картинки о том, как всё это работает.

Сохранение изображения
1f02f63cfd49430187ff63de1748e504.jpg

Запрос изображения
268b1f5bd8e14266a9ed65f2a411785f.jpg

Запрос изображения клиентом может протекать по двум сценариям: когда версия изображения уже есть в облаке, и когда её там нет.

В первом случае сервис отдаёт клиенту версию изображения, получая её напрямую из облака:
0419584b788c4ad6810a55c00a11431d.jpg

А во втором — производит необходимые манипуляции над изображением, сохраняет его в облако и отдаёт клиенту:
c125540d143f484e89722fb001a8fc6b.jpg

API
Hermitage API до безобразия прост и предоставляет основную функциональность: сохранить, удалить и получить необходимый вариант изображения.

В целях безопасности запросы на сохранение и удаление изображения требуют подпись, уникальную для каждого запроса и основанную на URL запроса, http-методе, текущей метке времени и секретном ключе.

Получить изображение можно по URL: http://hermitage/{filename}:{version}
где {filename} — имя файла, а {version} — имя запрашиваемой версии изображения, прописанной в файле конфигурации данного приложения.

Более подробную информацию по API можно прочитать здесь.
Также уже имеется готовый клиент по работе с API на PHP: hermitage-php-client и адаптер для популярного фреймворка Yii2.

Как развернуть Hermitage
Требования:
  • PHP >= 7.0
  • PHP APCU
  • GD2/ImageMagick

Установка


Запускаем следующую команду Composer: 
composer create-project livetyping/hermitage-skeleton hermitage

Конфигурация


Копируем файл .env.example в .env
cp .env.example .env

Локальный файл .env выглядит так: 
AUTH_SECRET=changeme

###
# Adapter
##
STORAGE_ADAPTER=local

# AWS S3
#STORAGE_ADAPTER=s3
#STORAGE_S3_REGION=
#STORAGE_S3_BUCKET=
#STORAGE_S3_KEY=
#STORAGE_S3_SECRET=

Не забудьте сгенерировать рандомную строку и прописать AUTH_SECRET.

Прописываем необходимые версии изображений в файле config/versions.php: 

/**
 * [
 *    '{version-name}' => [
 *        'type' => '{manipulator-name}',
 *        // manipulator options
 *    ],
 * ]
 *
 * Default manipulators:
 *  - resize {@see \livetyping\hermitage\foundation\images\processor\manipulators\Resize}
 *  - fit {@see \livetyping\hermitage\foundation\images\processor\manipulators\Fit}
 */
return [
    'mini' => [
        'type' => 'resize',
        'height' => 200,
        'width' => 200,
    ],
    'small' => [
        'type' => 'resize',
        'height' => 400,
        'width' => 400,
    ],
    'thumb' => [
        'type' => 'fit',
        'height' => 100,
        'width' => 100,
    ],
];

В завершении всего вам остаётся только сконфигурировать веб-сервер. Будет это nginx или Apache, решать вам. Ссылки
  • Hermitage Skeleton
  • PHP-клиент для Hermitage
  • Адаптер клиента для Yii2

На этом всё. Если вам понравился микросервис, мы будем рады вашим коммитам.
Свои замечания и пожелания оставляйте в комментариях.

Комментарии (8)

  • 19 сентября 2016 в 14:13

    +1

    ↑

    ↓

    Остается только docker-образ создать для быстрого запуска.

  • 19 сентября 2016 в 14:19

    +2

    ↑

    ↓

    Т.е. взяли и быстренько уничтожили все плюсы CDN.

    • 19 сентября 2016 в 14:38 (комментарий был изменён)

      0

      ↑

      ↓

      А что вам мешает использовать вместе с CDN?
      Например, с AWS настраивается редирект с CDN на Hermitage, если файл отсутствует на S3.

  • 19 сентября 2016 в 15:01

    +1

    ↑

    ↓

    Эхх… Ну почему все ограничиваются только изображениями? Может подумаете над тем, чтобы сервис мог хранить любые типы файлов? Манипуляторы (типа width, height) можно было бы реализовать в виде полиморфных классов с возможностью расширения, в этом случае можно не только менять размеры изображений, но и работать со звуком, видео, документами и т.д. А если еще реализовать манипуляторы в виде очереди, так вообще… чет меня понесло, сам хотел такое сделать.

    • 19 сентября 2016 в 15:55

      0

      ↑

      ↓

      Потому что обработка видео потянет за собой ffmpeg и прочие зависимости и микросервис тут же превратится в макро.

      • 19 сентября 2016 в 15:59

        0

        ↑

        ↓

        А зачем микросервису реализовывать модификаторы для видео?

  • 19 сентября 2016 в 15:09

    0

    ↑

    ↓

    Хм, возможно, я немного не понял, но чем он лучше, например, imgwizard?

    • 19 сентября 2016 в 15:50

      0

      ↑

      ↓

      В статье приведено небольшое сравнение с Glide.

© Habrahabr.ru