img

img показывает свойства изображений, меняет размеры и формат.

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

Обзор

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

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

Сначала проверь настройки на одной картинке, затем запускай обработку папки или списка. Оригинал не меняется без явного -r.

Синтаксис

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.

Во избежание нехватки памяти преобразование ограничено исходным файлом 32 МиБ и 24 млн пикселей входного или выходного изображения (до 16000 на сторону). Пакет ограничен 200 изображениями, список — 128 КиБ. Для преобразования требуется GD или Imagick.

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

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

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

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

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

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

Пакет Base

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

install img
Пакет Minimum

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

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

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

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

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

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

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

install img -u

Примеры

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

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

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

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

[binary file: photo.jpg]

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

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

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

v1.1.52026-11-01

Производственная доработка

Актуальная стабильная версия img. img показывает свойства изображений, меняет размеры и формат.

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