PHPackages                             pkg-ru/imager-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. pkg-ru/imager-client

ActiveLibrary[Image & Media](/categories/media)

pkg-ru/imager-client
====================

Генерация ссылок на миниатюры картинки в микро-сервисе Imager

1.0.0(1y ago)12GPL-3.0GoPHP >=7.1

Since Mar 23Pushed 1y ago1 watchersCompare

[ Source](https://github.com/pkg-ru/imager-client)[ Packagist](https://packagist.org/packages/pkg-ru/imager-client)[ Docs](https://github.com/pkg-ru/imager)[ RSS](/packages/pkg-ru-imager-client/feed)WikiDiscussions master Synced today

READMEChangelog (1)DependenciesVersions (2)Used By (0)

[Imager](https://github.com/pkg-ru/imager) Client
=================================================

[](#imager-client)

Компонент для генерации ссылок на сжатые миниатюры картинок в микро-сервисе **Imager**.

> Для работы нужно настроить и запустить [микро-сервис Imager](https://github.com/pkg-ru/imager).

Документация: **RU** / [EN](./doc/README-EN.md)
-----------------------------------------------

[](#документация-ru--en)

- [Golang](./doc/GO-RU.md)
- [PHP](./doc/PHP-RU.md)
- [JavaScript (TS)](./doc/TS-RU.md)
- [Python3](./doc/PY-RU.md)

---

### Общие сведения

[](#общие-сведения)

Инициализация компонента **Imager**(*thumb*)

> ##### *thumb* - название настроек на сервере (по умолчанию: `default`)
>
> [](#thumb---название-настроек-на-сервере-по-умолчанию-default)
>
> Можно передать массив настроек, кроме реализации на языке Go.

Настройки обработки картинок на сервере **thumb**(*thumb*)

> ##### *thumb* - название настроек на сервере (по умолчанию: `default`)
>
> [](#thumb---название-настроек-на-сервере-по-умолчанию-default-1)

Ширина картинки **width**(*width*)

> ##### *width* - ширина.
>
> [](#width---ширина)
>
> Если передать `0`, то ширина не изменяется, и сохраняет свои пропорции относительно высоты.

Высота картинки **height**(*height*)

> ##### *height* - высота.
>
> [](#height---высота)
>
> Если передать `0`, то высота не изменяется, и сохраняет свои пропорции относительно ширины.

Установка ширины и высоты изображения **size**(*width*, *height*)

> ##### *width* - ширина.
>
> [](#width---ширина-1)
>
> Если передать `0`, то ширина не изменяется, и сохраняет свои пропорции относительно высоты.

> ##### *height* - высота.
>
> [](#height---высота-1)
>
> Если передать `0`, то высота не изменяется, и сохраняет свои пропорции относительно ширины.

Обрезка изображения в размер **crop**(*crop*)

> ##### *crop* - обрезка изображения (по умолчанию `false`).
>
> [](#crop---обрезка-изображения-по-умолчанию-false)
>
> Если `true` — при установке ширины и высоты этот параметр масштабирует и обрезает картинку в указанный размер.
> Если `false` — при установке ширины и высоты параметр масштабирует картинку в указанный размер.
> Поля, которые образуются в результате масштабирования, закрашиваются установленным цветом или остаются прозрачными (если это возможно).

Повтор анимации **loop**(*loop*)

> ##### *loop* - повтор анимации (по умолчанию `true`).
>
> [](#loop---повтор-анимации-по-умолчанию-true)
>
> Если `true` — анимация зацикливается.
> Если `false` — анимация проигрывается 1 раз.

Заливка фона цветом **color**(*r*, *g*, *b*)

> ##### *r* - Красный.
>
> [](#r---красный)
>
> ##### *g* - Зеленый.
>
> [](#g---зеленый)
>
> ##### *b* - Синий.
>
> [](#b---синий)
>
> Устанавливает цвет заливки фона в RGB формате.

Обрезание краев картинки **trim**(*active*, *rate*, *colors*)

> ##### *active* - активность фильтра.
>
> [](#active---активность-фильтра)
>
> ##### *rate* - степень сравнения цветов (чем ниже, тем точнее цвет).
>
> [](#rate---степень-сравнения-цветов-чем-ниже-тем-точнее-цвет)
>
> ##### *colors* - список цветов в RGB формате: `[[255, 255, 255], [0, 0, 0]]`.
>
> [](#colors---список-цветов-в-rgb-формате-255-255-255-0-0-0)
>
> С помощью этого фильтра можно обрезать картинку по прозрачным пикселям, черным/белым или любым другим цветам, которые находятся по краям (верх/низ/лево/право) картинки.

Активность обрезания краев картинки **trimActive**(*active*)

> ##### *active* - активность фильтра обрезания краев.
>
> [](#active---активность-фильтра-обрезания-краев)
>
> Если `true` — обрезаем.
> Если `false` — не обрезаем.

Степень сопоставления цвета для обрезания краев **trimRate**(*rate*)

> ##### *rate* - степень сопоставления цвета.
>
> [](#rate---степень-сопоставления-цвета)
>
> Чем ниже это значение, тем точнее сопоставляется цвет.

Цвета, которые будут обрезаны по краям **trimColors**(*colors*)

> ##### *colors* - список цветов.
>
> [](#colors---список-цветов)
>
> Список в RGB формате: `[[255, 255, 255], [0, 0, 0]]`.

Качество превью картинки **quality**(*quality*)

> ##### *quality* - качество результата.
>
> [](#quality---качество-результата)
>
> Чем ниже значение, тем хуже качество и меньше размер файла (не для файлов результата: gif/png).

Настройка (кроме Go) **setting**(*setting*)

> ##### *setting* - список/массив настроек (кроме Go).
>
> [](#setting---списокмассив-настроек-кроме-go)
>
> Пример:
>
> ```
> {
> # ширина
> 'width': 100,
> # высота
> 'height': 100,
> # качество
> 'quality': 85,
> # обрезка в размер
> 'crop': false,
> # повтор анимации
> 'loop': true,
> # цвет заливки
> 'color': [255, 255, 255],
> # обрезка краев
> 'trimActive': true,
> # степень сопоставления при обрезании краев
> 'trimRate': 20,
> # список цветов для обрезания краев
> 'trimColor': [[255, 255, 255], [0, 0, 0]],
> }
> ```

Копирование, чтобы не вносить изменения в общий экземпляр **copy**() / **clone**()

> Можно использовать для группировки по типам/настройкам ассетов.

Получение ссылки без изменения формата картинки **get**(*file*, *setting*)

> ##### *file* - путь к исходному файлу (относительно web).
>
> [](#file---путь-к-исходному-файлу-относительно-web)
>
> ##### *setting* - список/массив настроек (кроме Go).
>
> [](#setting---списокмассив-настроек-кроме-go-1)
>
> Генерирует ссылку на ассет картинки по установленным параметрам, без изменения расширения исходного файла.

Получение ссылки с конвертацией в другой формат **convert**(*file*, *format*, *setting*)

> ##### *file* - путь к исходному файлу (относительно web).
>
> [](#file---путь-к-исходному-файлу-относительно-web-1)
>
> ##### *format* - формат файла результата.
>
> [](#format---формат-файла-результата)
>
> ##### *setting* - список/массив настроек (кроме Go).
>
> [](#setting---списокмассив-настроек-кроме-go-2)
>
> Генерирует ссылку на ассет картинки по установленным параметрам и с установленным расширением файла результата.

---

Клонирование репозитория
------------------------

[](#клонирование-репозитория)

```
git clone https://github.com/pkg-ru/imager-client.git && cd imager-client
```

Установка контейнера разработки
-------------------------------

[](#установка-контейнера-разработки)

```
docker compose build && docker compose start
```

Запуск тестов
-------------

[](#запуск-тестов)

```
docker exec -it imager-client bash -c "go run test/*.go"
```

Сборка
------

[](#сборка)

```
docker exec -it imager-client bash -c "go run test/*.go && npm run build && python3 -m build"
```

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance42

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

467d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/82025496?v=4)[Владислав](/maintainers/pkg-ru)[@pkg-ru](https://github.com/pkg-ru)

---

Top Contributors

[![pkg-ru](https://avatars.githubusercontent.com/u/82025496?v=4)](https://github.com/pkg-ru "pkg-ru (11 commits)")

---

Tags

golanggolang-packagejavascriptjavascript-packagephpphp-packagepython3python3-packagetypescripttypescript-packageimagegifpngjpgassetsWebpavifimagerheicheif

### Embed Badge

![Health badge](/badges/pkg-ru-imager-client/health.svg)

```
[![Health](https://phpackages.com/badges/pkg-ru-imager-client/health.svg)](https://phpackages.com/packages/pkg-ru-imager-client)
```

###  Alternatives

[rosell-dk/webp-convert

Convert JPEG & PNG to WebP with PHP

6049.0M63](/packages/rosell-dk-webp-convert)[somehow-digital/typo3-media-processing

Media Processing

121.3k](/packages/somehow-digital-typo3-media-processing)[choowx/rasterize-svg

A PHP library for converting SVG to JPEG, PNG, and WEBP

2283.6k](/packages/choowx-rasterize-svg)[vajiral/php-image-compare

A light weight PHP class that can compare two (jpg/png) images to find if they are similar.

1897.9k1](/packages/vajiral-php-image-compare)[kinglozzer/tinypng

TinyPNG PHP API

1395.5k2](/packages/kinglozzer-tinypng)[rosell-dk/webp-convert-cloud-service

Cloud service for converting JPEG & PNG to WebP

546.0k5](/packages/rosell-dk-webp-convert-cloud-service)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)