🥇Képek dinamikus átméretezése Nginx és LuaJIT (OpenResty) segítségével

Már régóta, inspirálva egy cikkből Képátméretezés valós időben betegték a képek átméretezését ngx_http_image_filter_module és minden megfelelően működött. De felmerült egy probléma, amikor a menedzsernek pontos méretű képekre volt szüksége bizonyos szolgáltatásokhoz, mivel ez a technikai követelményük volt. Például, ha van egy eredeti kép, amelynek mérete 1200×1200, és az átméretezésnél ilyesmit írunk: ?resize=600×400, akkor arányosan csökkentett képet kapunk a kisebbik szélnél, mérete 400×400. Csakúgy, mint lehetetlen nagyobb felbontású (upscale) képet kapni. Vagyis ?resize=1500×1500 visszaadja ugyanazt a képet 1200×1200

A segítségemre jött egy cikk OpenResty: a NGINX teljes értékű alkalmazásszerverré alakítása a Nginx és Lua működésének megértéséhez, valamint maga a Lua könyvtár isage/lua-imagick — Lua pure-c kötődések az ImageMagick-hoz. Miért ezt a megoldást választottam, miért nem például valami Python-ra — mert ez gyors és kényelmes. Nem is kell fájlokat létrehoznod, minden közvetlenül a Nginx konfigurációban van (nem kötelező).

Tehát mire van szükségünk

A példák a Debian alapjaira épülnek.

Nginx és nginx-extras telepítése

apt-get update
apt-get install nginx-extras

LuaJIT telepítése

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

Imagemagick telepítése

apt-get -y install imagemagick

és a könyvtárak magickwand hozzá, az én esetemben a 6. verzióhoz

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

Lua-imagick összeszerelése

Clone-oljuk a repót (vagy letöltjük a zip fájlt és kicsomagoljuk)

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

Ha minden jól ment, akkor beállíthatjuk a Nginxet.

Példát mutatok be a backend hoszt konfigurációjára, amely ténylegesen foglalkozik az átméretezéssel. Ezt a frontend szerver proxyzza, szintén Nginx-en, ahol caching történik egy időre (egy nap) és hasonló dolgok.

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
    }
}

Amit szükséges volt (képek kiterjesztése a széleken) a következő segítségével történik: img:extent() és a következő paraméterrel definiálva resize plusz jellel + a végén.

Az alábbi paraméterek érhetők el:

WxH (Tartsd meg az arányt, használd a nagyobb dimenziót)
WxH^ (Tartsd meg az arányt, használd a kisebb dimenziót (crop))
WxH! (Ignorálja az arányt)
WxH+ (Tartsd meg az arányt, adj oldalsó széleket)

Összefoglaló táblázat az átméretezés eredményeiről

A kérés uri paramétere
A kimeneti kép mérete

?resize=400×200
200×200

?resize=400×200^
400×400

?resize=400×200!
400×200 (Nem arányosan)

?resize=400×200+
400×200 (Arányosan)

Result

A megközelítés hatalmát és egyszerűségét figyelembe véve olyan dolgokat lehet megvalósítani, amelyek meglehetősen bonyolult logikát igényelnek, például vízjelek hozzáadása vagy a hozzáférés korlátozott engedélyezése. Az API képkezelési lehetőségeiről a könyvtár dokumentációjában lehet tájékozódni. isage/lua-imagick

Forrás: habr.com