🥇Рэсайз малюнкаў на лета з дапамогай 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 pure-c bindings to 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 (Keep aspect-ratio, use higher dimension)
WxH^ (Keep aspect-ratio, use lower dimension (crop))
WxH! (Ignore aspect-ratio)
WxH+ (Keep aspect-ratio, add side borders)

Зводная табліца з вынікамі рэсайзу

Параметр uri запыту
Памер выходнай выявы

?resize=400×200
200 × 200

?resize=400×200^
400 × 400

?resize=400×200!
400×200 (Не прапарцыйна)

?resize=400×200+
400×200 (Прапарцыйна)

Вынік

Улічваючы ўсю моц і прастату такога падыходу можна рэалізаваць рэчы з даволі складанай логікай, напрыклад дадаваць watermark'і ці рэалізаваць аўтарызацыю з размежаваным доступам. Для таго, каб даведацца пра магчымасці API для працы з выявамі, можна звярнуцца да дакументацыі бібліятэкі isage/lua-imagick

Крыніца: habr.com

Рэсайз малюнкаў на лета з дапамогай Nginx і LuaJIT (OpenResty)