ПРОЕКТЫ 


  АРХИВ 


Apache-Talk @lexa.ru 

Inet-Admins @info.east.ru 

Filmscanners @halftone.co.uk 

Security-alerts @yandex-team.ru 

nginx-ru @sysoev.ru 


  СТАТЬИ 


  ПЕРСОНАЛЬНОЕ 


  ПРОГРАММЫ 



ПИШИТЕ
ПИСЬМА












     АРХИВ :: nginx-ru
Nginx-ru mailing list archive (nginx-ru@sysoev.ru)

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Создание нового модуля под nginx



http://www.riceonfire.org/emiller/nginx-modules-guide.html

-----Original Message-----
From: alex.k@xxxxxxxx
To: nginx-ru@xxxxxxxxx
Date: Mon, 28 Jan 2008 12:19:20 +0300
Subject: Создание нового модуля под nginx

> Всем привет!
> 
> У меня стоит задача, переделать набор скриптов на PHP, в модули под
> сервер nginx.
> Я скачал nginx-0.5.35 и попытался разобраться по какому принципу в
> него добавляются новые модули, но к сожалению не нашёл по данному
> вопросу описания, а разбираться во всём коде сервера, задача не
> тривиальная.
> Подскажите пожалуйста, где можно найти информацию по созданию нового
> модуля к серверу nginx.
> 
> 
> -- 
> Best regards,
>  alex                          mailto:alex.k@xxxxxxxx
> 
> 

Работаем с разделяемой памятью

Начиццо, для работы с ШМ существует такая хрень - как ngx_shm_zone_t:

struct ngx_shm_zone_s {
    void                     *data; /*Конечная цель мучений - собственно указатель на наши данные в этой зоне. Устанавливается нашим коллбэком.*/
    ngx_shm_t                 shm;  /*Шаг номер три.*/
    ngx_shm_zone_init_pt      init; /*Шаг номер два: коллбэк - инициализирующий зону - предоставляется модулем запросившим её создание.*/
    ngx_str_t                 name; /*Имя - по нему зоны будут различаться менеджилкой зон.*/
    void                     *tag;  /*Тут обычно живет адрес структуры модуля использующего зону.
};                                   *Назначение примерно такое-же - различать.
                                     *Если зона с таким тегом уже есть - при конфигурировании возвращается ошибка,
                                     *а в лог пишется - что такая зона уже используется "для других целей".
                                     */
Все зоны живут централизованно в структуре ngx_cycle_t (хоть это-то он не завязал на хттп). Создание очередной зоны как-правило происходит при вызове ngx_shared_memory_add() из обработчика требующей того директивы конфига нашего модуля. Этот вызов добавляет зону с заданными размером, именем, тегом и конфом (ngx_conf_t) в список зон. Затем модуль должен навесить свой хэндлер на ngx_shm_zone_t::init. После обработки конфига, функция инициализации вызовет коллбэки для всех зон у которых они были заданы функциями конфигурировавшими модули. Теперь шаг номер три - инициализация зоны: коллбэк имеет такой вид:
static ngx_int_t ngx_модуль_чего-то-там_init(ngx_shm_zone_t *shm_zone, void *data)
{
    ngx_slab_pool_t          *shpool;
    ngx_модуль_чего-то-там_t *shared_data;

    if (data) {
        shm_zone->data = "" /*ngx_cycle.c: shm_zone[i].init(&shm_zone[i], oshm_zone[n].data)*/
        return NGX_OK;
    }

    shpool = (ngx_slab_pool_t *) shm_zone->shm.addr;

    shared_data = ngx_slab_alloc(shpool, sizeof(ngx_модуль_чего-то-там_t));
    if (cache == NULL) {
        return NGX_ERROR;
    }
   /*Ну, тут мы работаем с полученной х..нёй. Всё тупо...*/
   ...
   /*А потом делаем так:*/
   shm_zone->data = "" 
}

Вот как-то так...

Далее в нашем коде можем брать полученный ngx_shm_zone_t * (который мы храним в main, server, loc или какой ещё конфигурации нашего модуля), примерно так:

ngx_shm_zone_t           *shm_zone;
ngx_slab_pool_t          *shpool;
ngz_модуль_main_conf_t   *mmcf;
ngz_модуль_чего-то-там   *shared_data;

...

shm_zone = mmcf->shm_zone;
shared_data = shm_zone->data;
shpool = (ngx_slab_pool_t *)shm_zone->shm.addr;

ngx_shmtx_lock(shpool->mutex);
 shared_data->бла-бла-бла...;
ngx_shmtx_unlock(shpool->mutex);





 




Copyright © Lexa Software, 1996-2009.