1. FEERSUM ENJINN
nginx: inside

2. Фичи nginx
● event driven
● non-blocking
● modular

3. Устройство:
процессы

4. Nginx Master
● Мониторит воркеры
● Обработка сигналов
-INT — выход
-HUP — переконфигурация
-USR1 — log rotate

5. Nginx Worker
● Обработка запросов
● Выполняет команды из мастер-
процесса

6. Cache Manager,
Cache Loader
● loader: подгружает информацию о
содержимом кеша
● manager: отслеживает протухание
записей в кеше

7. HTTP Request:
немного механики

8. Обработка запроса
● Получить данные, распарсить запрос
● Найти соответствующие сервер и location
● Запустить обработчики фаз
● Сгенерировать ответ
● Применить фильтры к заголовкам и телу
ответа
● Отправить клиенту то, что получилось

9. Фазы обработки
● Post Read (например, для realip)
● Rewrite & read config
● Проверка доступа
● Проверка существования файлов
(если надо)
● Генерация контента
● Запись логов

10. Устройство:
модули

11. Модули ядра
● event
● http main
(легко запомнить)

12. Основные модули
● HTTP Core
● Upstream
● Access
● Rewrite
● Charset
● Log
… и другие

13. И ещё модули
(опционально)
HTTP Addition SSL
Embedded Perl Stub Status
FLV WebDAV
Gzip Precompression Google Perftools
Random Index XSLT
GeoIP Secure Link
Real IP Image Filter

14. Модуль
Hello World

15. Что требуется?
● Директивы конфига
● Обработчики
● Установка обработчиков
● Порядок инициализации модуля
● Описание модуля

16. Директивы конфига
static ngx_command_t ngx_http_hello_commands[] = {
{ ngx_string("hello"),
NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS,
ngx_http_hello,
0,
0,
NULL },
ngx_null_command
};

17. Обработчики
static ngx_int_t
ngx_http_hello_handler(ngx_http_request_t *r)
{
/* То, что делает модуль - находится здесь */
return NGX_OK;
}

18. Установка обработчиков
static char *
ngx_http_hello(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
{
ngx_http_core_loc_conf_t *clcf;
clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);
clcf->handler = ngx_http_hello_handler;
return NGX_CONF_OK;
}

19. Порядок инициализации
(контекст)
static ngx_http_module_t ngx_http_hello_module_ctx = {
NULL, /* preconfiguration */
NULL, /* postconfiguration */
NULL, /* create main configuration */
NULL, /* init main configuration */
NULL, /* create server configuration */
NULL, /* merge server configuration */
NULL, /* create location configurtion */
NULL /* merge location configuration */
}

20. Описание модуля
ngx_module_t ngx_http_hello_module = {
NGX_MODULE_V1,
&ngx_http_hello_module_ctx, /* module context */
ngx_http_hello_commands, /* module directives */
NGX_HTTP_MODULE, /* module type */
NULL, /* init master */
NULL, /* init module */
NULL, /* init process */
NULL, /* init thread */
NULL, /* exit thread */
NULL, /* exit process */
NULL, /* exit master */
NGX_MODULE_V1_PADDING
};

21. Build It!
● Файл config
ngx_addon_name=ngx_http_hello_module
HTTP_MODULES="$HTTP_MODULES ngx_http_hello_module"
NGX_ADDON_SRCS="$NGX_ADDON_SRCS
$ngx_addon_dir/ngx_http_hello_module.c"
● Configure nginx
./configure --add-module=path/to/your/new/module/directory

22. Инструменты
отладки

23. Valgrind
● Проверка memory leaks

24. Strace
● Трассировка системных
вызовов
● Deadlock detector

25. GDB
● Где упало?
● Кто записал в память?
● Трассировка

26. Работает?
Grats!