pkg-ru/imager-client
Composer 安装命令：
composer require pkg-ru/imager-client
包简介
Генерация ссылок на миниатюры картинки в микро-сервисе Imager
README 文档
README
Компонент для генерации ссылок на сжатые миниатюры картинок в микро-сервисе Imager.
Для работы нужно настроить и запустить микро-сервис Imager.
Документация: RU / EN
Общие сведения
Инициализация компонента
Imager(thumb)
thumb - название настроек на сервере (по умолчанию:
default)Можно передать массив настроек, кроме реализации на языке Go.
Настройки обработки картинок на сервере
thumb(thumb)
thumb - название настроек на сервере (по умолчанию:
default)
Ширина картинки
width(width)
width - ширина.
Если передать
0, то ширина не изменяется, и сохраняет свои пропорции относительно высоты.
Высота картинки
height(height)
height - высота.
Если передать
0, то высота не изменяется, и сохраняет свои пропорции относительно ширины.
Установка ширины и высоты изображения
size(width, height)
width - ширина.
Если передать
0, то ширина не изменяется, и сохраняет свои пропорции относительно высоты.
height - высота.
Если передать
0, то высота не изменяется, и сохраняет свои пропорции относительно ширины.
Обрезка изображения в размер
crop(crop)
crop - обрезка изображения (по умолчанию
false).Если
true— при установке ширины и высоты этот параметр масштабирует и обрезает картинку в указанный размер.
Еслиfalse— при установке ширины и высоты параметр масштабирует картинку в указанный размер.
Поля, которые образуются в результате масштабирования, закрашиваются установленным цветом или остаются прозрачными (если это возможно).
Повтор анимации
loop(loop)
loop - повтор анимации (по умолчанию
true).Если
true— анимация зацикливается.
Еслиfalse— анимация проигрывается 1 раз.
Заливка фона цветом
color(r, g, b)
r - Красный.
g - Зеленый.
b - Синий.
Устанавливает цвет заливки фона в RGB формате.
Обрезание краев картинки
trim(active, rate, colors)
active - активность фильтра.
rate - степень сравнения цветов (чем ниже, тем точнее цвет).
colors - список цветов в RGB формате:
[[255, 255, 255], [0, 0, 0]].С помощью этого фильтра можно обрезать картинку по прозрачным пикселям, черным/белым или любым другим цветам, которые находятся по краям (верх/низ/лево/право) картинки.
Активность обрезания краев картинки
trimActive(active)
active - активность фильтра обрезания краев.
Если
true— обрезаем.
Еслиfalse— не обрезаем.
Степень сопоставления цвета для обрезания краев
trimRate(rate)
rate - степень сопоставления цвета.
Чем ниже это значение, тем точнее сопоставляется цвет.
Цвета, которые будут обрезаны по краям
trimColors(colors)
colors - список цветов.
Список в RGB формате:
[[255, 255, 255], [0, 0, 0]].
Качество превью картинки
quality(quality)
quality - качество результата.
Чем ниже значение, тем хуже качество и меньше размер файла (не для файлов результата: gif/png).
Настройка (кроме Go)
setting(setting)
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).
setting - список/массив настроек (кроме Go).
Генерирует ссылку на ассет картинки по установленным параметрам, без изменения расширения исходного файла.
Получение ссылки с конвертацией в другой формат
convert(file, format, setting)
file - путь к исходному файлу (относительно web).
format - формат файла результата.
setting - список/массив настроек (кроме Go).
Генерирует ссылку на ассет картинки по установленным параметрам и с установленным расширением файла результата.
Клонирование репозитория
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"
pkg-ru/imager-client 适用场景与选型建议
pkg-ru/imager-client 是一款 基于 Go 开发的 Composer 扩展包，目前已累计 2 次下载、GitHub Stars 达 1， 最近一次更新时间为 2025 年 03 月 23 日， 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向： 「image」 「assets」 「png」 「gif」 「jpg」 「imager」 等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 pkg-ru/imager-client 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
基于 pkg-ru/imager-client 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
与 pkg-ru/imager-client 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：
Asset Management for PHP
Caching and compression for Twig assets (JavaScript and CSS).
Yii2 LightBox image galary widget uses Lightbox v2.10.0 by Lokesh Dhakar
The Yii2 extension uses jQuery jquery.carousel-1.1.min.js and makes image carousel from php array of structure defined.
Image optimization widget for Yii2 Framework with auto WebP/AVIF image format generation from PNG/JPG files.
Generates QR Codes
统计信息
- 总下载量： 2
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 1
- 点击次数： 23
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： GPL-3.0
- 更新时间： 2025-03-23