img

Показывает параметры изображений и пакетно меняет размер, формат и качество JPEG, PNG и WebP.

ФайлыВерсия 1.1.4Стабильная
lil-terminal

Обзор

img — компактный инструмент для веб-изображений: без дополнительных расширений показывает сведения о файле, а при наличии GD или Imagick меняет размер и формат JPEG, PNG и WebP для одного файла, каталога, маски или списка.

Пакетная обработка изображений

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

Синтаксис

lil-terminal
img <file> [options] · img -f [dir] [mask] [options] · img [options] < <list>

Справочник

img <file>

показать информацию об изображении

-s <size>

изменить размер пропорционально; одно число задаёт максимальную сторону

-s <size> -w | -h

изменить размер пропорционально по выбранной ширине или высоте

-s <WxH>

изменить размер точно до <WxH>

-t <format>

преобразовать в веб-формат: jpg|png|webp

-q <1..100>

задать качество результата; по умолчанию 85

-o <dst>

записать одно преобразованное изображение по указанному пути

-r

заменить исходное изображение после успешного преобразования

-f [dir] [mask]

обработать подходящие изображения в каталоге; по умолчанию текущий каталог и *

< <list>

обработать пути изображений из текстового файла, по одному в строке

Активный файл

В текущем ядре успешно открытый файл сразу становится доступен через $. Если этот модуль — установленный обработчик с наивысшим приоритетом для расширения файла, достаточно ввести только имя файла: ядро направит его в эту команду. Это часть поведения ядра; явной формой команды остаётся img <file>.

Безопасность

По умолчанию преобразование создаёт соседний файл name.img.ext и не заменяет существующий результат. -o задаёт явный путь для одного файла, а -r следует использовать только для осознанной замены исходника. Пакетный режим не обходит каталоги рекурсивно. При -r формат изображения должен оставаться прежним; для преобразования в другой формат не используйте -r или задайте -o.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Проверить изображение в текущем каталоге

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install img
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install img -m
Точная публичная версия

Установить именно эту опубликованную версию.

install img -v 1.1.4
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade img
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install img -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Проверить изображение в текущем каталоге
cd \sandbox\images | img photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Показать информацию об изображении
photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Изменить размер пропорционально; одно число задаёт максимальную сторону
img $ -s 1200 -t webp -q 82
photo.jpg > photo.img.webp
Изменить размер пропорционально по выбранной ширине или высоте
img photo.jpg -s 32 -w -o photo-thumb.jpg
photo.jpg > photo-thumb.jpg
Изменить размер пропорционально; одно число задаёт максимальную сторону
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
Обработать пути изображений из текстового файла, по одному в строке
img -s 1200 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Заменить исходное изображение после успешного преобразования
img photo.jpg -s 40 -r
photo.jpg > photo.jpg
Показать информацию об изображении
img \sandbox\images\missing.jpg
Файл не найден

Файл из примера: sandbox/images/photo.jpg

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

[binary file: photo.jpg]

Связанная документация

Как защищены файловые операции? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.1.42026-08-09

Гибкое пропорциональное масштабирование

Добавлены размер по длинной стороне, явная ширина/высота, точный WxH и компактный вывод источник > результат.

# История версий