Openresty, большой набор модулей для Nginx'a, открывает много возможностей для разработки прямо на популярном Web сервере. Одним из главных достоинств этого пакета является расширение для поддержки языка Lua в Nginx.

Установка

В Debian системах все, что нужно, есть в пакете:

apt-get install nginx-extras

Hello world

Выведем hello world:

server {

  location /hello {

    default_type 'text/plain';

    content_by_lua '

        ngx.say("Hello world!")

    ';

  }

}

# Выведем известную строку прямо с помощью Nginx'a

Теперь перезапустим Nginx:

nginx -s reload

И по адресу http://сайт/hello увидим:

Hello world!

Вывод HTML

Чтобы вывести HTML достаточно заменить тип контента и указать сам контент:

server {

  location /hello {

    default_type 'text/html';

    content_by_lua '

        ngx.say("Hello <b>world</b>!")

    ';

  }

}

# Выводим HTML из Nginx Lua

Организация кода

Для удобства стоит использовать внешние Lua файлы:

server {

  location / {

    default_type 'text/plain';

    content_by_lua_file /var/www/lua/index.lua;

    # Отключим кэширование кода для разработки

    # (это нужно закомментировать, когда выкатим на продакшн)

    lua_code_cache off;

  }

}

# загрузка Lua кода из внешних файлов

Во время разработки удобно использовать lua_code_cache, т.к. код файла можно будет менять без перезапуска Nginx'a.

Несколько обработчиков

server {

  location / {

    default_type 'text/plain';

    content_by_lua_file /var/www/lua/index.lua;

  }

  location /admin {

    default_type 'text/plain';

    content_by_lua_file /var/www/lua/admin.lua;

  }

}

Глобальные переменные

Для настроек и статистики удобно использовать глобальные переменные (они будут иметь одинаковые значения для всех запросов):

http {

    # объявляем глобальный контейнер

    lua_shared_dict stats 1m;

    server {

        location / {

            content_by_lua '

		# увеличим переменную hits на 1 при каждом запросе

                ngx.shared.stats:incr("hits", 1)

		# выведем текущее значение

                ngx.say(ngx.shared.stats:get("hits"))

            ';

        }

    }

}

# Используем глобальную переменную для подсчета количества запросов

Работа с данными

Nginx поддерживает работу с разными базами данных, в т.ч. Mysql и Redis.

apt-get install lua-nginx-redis

Пример простого скрипта для подсчета количества запросов в Redis'e:

server {

        location / {

            content_by_lua '

		local redis = require "nginx.redis"

		local red = redis:new()

		local ok, err = red:connect("127.0.0.1", 6379)

		ok, err = red:incr("test")

		local res, err = red:get("test")

		ngx.say("hits: ", res)

            ';

        }

}

# Увеличиваем счетчик test с помощью Redis

Самое главное

Openresty позволяет использовать Nginx не просто как Web сервер, а как полноценную платформу. С помощью Lua можно реализовать большой набор функционала, в т.ч. и работу с данными.