🥇Промяна на размера на изображения в реално време с Nginx и LuaJIT (OpenResty)

Отдавна вдъхнових се от статията Динамично преоразяване на изображения бе настроен за промяна на размера на изображенията с помощта на ngx_http_image_filter_module и всичко работеше както трябва. Но се появи един проблем, когато на мениджъра му се наложи да получава изображения с точни размери за качване на определени услуги, тъй като това бяха техните технически изисквания. Например, ако имаме оригинал на изображение с размер 1200×1200, и при промяна на размера пишем нещо като ?resize=600×400, то ще получим пропорционално намалено изображение по най-малкия ръб с размер 400×400. Също така е невъзможно да се получи изображение с по-голямо разрешение (upscale). Тоест, ?resize=1500×1500 ще върне същото изображение 1200×1200

На помощ дойде статията OpenResty: превръщаме NGINX в пълен сървър за приложения за разбирането как работи Nginx с Lua и самата библиотека за Lua isage/lua-imagick — чисти Lua биндинги към ImageMagick. Защо беше избрано такова решение, а не, да речем, нещо на Python — защото е бързо и удобно. Няма да е необходимо да създавате файлове, всичко е направо в конфигурацията на Nginx (не е задължително).

И така, какво ще ни е необходимо

Примерите ще бъдат представени въз основа на Debian.

Инсталиране на nginx и nginx-extras

apt-get update
apt-get install nginx-extras

Инсталиране на LuaJIT

apt-get -y install lua5.1 luajit-5.1 libluajit-5.1-dev

Инсталиране на imagemagick

apt-get -y install imagemagick

и библиотеки magickwand към него, в моя случай за версия 6

apt-cache search libmagickwand
apt-get -y install libmagickwand-6.q16-3 libmagickwand-6.q16-dev

Сглобяване на lua-imagick

Клонирайте репозитория (или вземете zip архива и го разархивирайте)

cd ~
git clone https://github.com/isage/lua-imagick.git
cd lua-imagick
mkdir build
cd build
cmake ..
make
make install

Ако всичко премине успешно, можете да конфигурирате Nginx.

Ще дам пример за конфигурация на backend хост, който всъщност се занимава с промяна на размера. Той се проксира от фронт сървъра също с Nginx, на който се извършва кеширане за определено време (една седмица) и т.н.

nginx backend config

# Backend image server
server {
    listen       8082;
    listen [::]:8082;
    set $files_root /var/www/example.lh/frontend/web;
    root $files_root;
    access_log off;
    expires 1d;

    location /files {
        # дефолтные значения ресайза
        set $w 700;
        set $h 700;
        set $q 89;

        #1-89 allowed
        if ($arg_q ~ "^([1-9]|[1-8][0-9])$") {
            set $q $arg_q;
        }

        if ($arg_resize ~ "([d-]+)x([d+!^]+)") {  
            set $w $1;
            set $h $2;
            rewrite  ^(.*)$   /resize/$w/$h/$q$uri     last;
        }

        rewrite  ^(.*)$   /resize/$w/$h/$q$uri     last;
    }

    location ~* ^/resize/([d]+)/([d+!^]+)/([d]+)/files/(.+)$ {
        default_type 'text/plain';

        set $w $1;
        set $h $2;
        set $q $3;
        set $fname $4;

        # Есть возможность вынести весь Lua код в отдельный файл
        # content_by_lua_file /var/www/some.lua;
        # lua_code_cache off; #dev
        content_by_lua '
        local magick = require "imagick"
        local img = magick.open(ngx.var.files_root .. "/files/" .. ngx.var.fname)
        if not img then ngx.exit(ngx.HTTP_NOT_FOUND) end
        img:set_gravity(magick.gravity["CenterGravity"])

        if string.match(ngx.var.h, "%d+%+") then
            local h = string.gsub(ngx.var.h, "(%+)", "")
            resize = ngx.var.w .. "x" .. h
            -- для png с альфа каналом
            img:set_bg_color(img:has_alphachannel() and "none" or img:get_bg_color())
            img:smart_resize(resize)
            img:extent(ngx.var.w, h)
        else
                img:smart_resize(ngx.var.w .. "x" .. ngx.var.h)
        end

        if ngx.var.arg_q then img:set_quality(ngx.var.q) end

        ngx.say(img:blob())
        ';
    }
}

# Upstream
upstream imageserver {
    server localhost:8082;
}

server {
    listen 80;
    server_name examaple.lh;

    # отправляем все jpg и png картинки на imageserver
    location ~* ^/files/.+.(jpg|png) {
        proxy_buffers 8 2m;
        proxy_buffer_size 10m;
        proxy_busy_buffers_size 10m;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_pass     http://imageserver;  # Backend image server
    }
}

Това, което беше необходимо (разширяване на изображението по краищата) става с помощта на img:extent() и се определя с параметъра resize с знак + в края.

Налични са следните параметри:

WxH (Запазване на съотношението на страните, използване на по-висока размерност)
WxH^ (Запазване на съотношението на страните, използване на по-ниска размерност (къс))
WxH! (Игнориране на съотношението на страните)
WxH+ (Запазване на съотношението на страните, добавяне на странични граници)

Обобщаваща таблица с резултати от промяна на размера

Параметър uri на заявката
Размер на изходното изображение

?resize=400×200
200×200

?resize=400×200^
400×400

?resize=400×200!
400×200 (Не пропорционално)

?resize=400×200+
400×200 (Пропорционално)

Резюме

С оглед на цялата мощ и простота на такъв подход, могат да се реализират неща с доста сложна логика, например добавяне на водни знаци или реализация на авторизация с ограничен достъп. За да разберете възможностите на API за работа с изображения, можете да се обърнете към документацията на библиотеката. isage/lua-imagick

Източник: habr.com