Lighttpd (3. deo) – Naprednije konfigurisanje Lighttpd servera (programiranje plugina)

Autor: Vladimir Cicović

U ovom dijelu ćemo napraviti naš prvi plugin za lighttpd server. Programiranje plugin-a traži dosta više posvećenosti nego što ćemo ponuditi u ovom članku, ali čitaocima dajemo mogućnost da krenu od ovog članka kao osnove. Od čitaoca se očekuje da poznaje jezik C, kompajliranje na Linux-u i osnove konfigurisanja Lighttpd-a. Pretpostavićemo da čitaoci imaju Debian ili Ubuntu (sistem pod virtual box-om je idealno rešenje). Komande prije nego krenemo sa programiranjem plugin-a su sljedeće:

apt-get install libtool automake pkg-config libbz2-dev libpcre3-dev zlib1g-dev make -y

Poslije instalacije biblioteka preuzećemo sources lighttpd-a:

wget http://download.lighttpd.net/lighttpd/releases-1.4.x/lighttpd-1.4.32.tar.gz

Pa raspakujemo sources:

tar -xf  lighttpd-1.4.32.tar.gz

Rutinska provjera da li je sources moguće iskompajlirati:

cd lighttpd-1.4.32 ; ./configure ; make

Ako poslije ovog konfigurisanja i kompajliranja ne bude problema, znači da imamo sources koji možemo da postavimo na naš operativni sistem.

Sljedeći korak biće kopiranje skeleton-a koji će poslužiti kao baza za naš plugin. Pretpostavka je da se nalazimo u fascikli lighttpd-1.4.32.

cd src ; cp mod_skeleton.c mod_hello.c

Zamjenićemo „mod_skeleton” unutar datoteke „mod_hello.c” sa:

sed -i 's/mod_skeleton/mod_hello/g' mod_hello.c

Sada ćemo otvoriti našim omiljenim editorom (pico, vi…):

pico mod_hello.c

Idemo do funkcije:

URIHANDLER_FUNC(mod_hello_uri_handler) {
...
}

Unutar ove funkcije postoje linije kôda koje brišemo tako da ostane samo:

URIHANDLER_FUNC(mod_hello_uri_handler) {

}

Sada između zagrada dodamo:

 
  plugin_data *p = p_d; 
  char *hello ="hello";
  buffer *l;
  UNUSED(srv);
  if (con->mode != DIRECT) return HANDLER_GO_ON;
  if (con->uri.path->used == 0) return HANDLER_GO_ON;
  mod_hello_patch_connection(srv, con, p);
  
  if ( strstr(con->uri.path->ptr,hello) == 0) return HANDLER_GO_ON; //Ako hello nije u putanji predaj izvršavanje drugom modulu
  
  //Sređujemo Header za naš odgovor
  response_header_overwrite(srv, con, CONST_STR_LEN("Content-Type")CONST_STR_LEN("text/plain"));
  //uzimamo buffer kao pokazivač kako bismo izvršili dodavanje našeg string-a
  l = chunkqueue_get_append_buffer(con->write_queue);
  //ovde dodajemo sa API-jem naš pokazivač na string hello
  buffer_append_string_len(l, CONST_STR_LEN(hello));   
  //Obaviještavamo server da je prenos svih datoteka završen
  con->file_finished = 1;
  
  //Naš modul šalje da je završena obrada i da može poslati klijentu
  return HANDLER_FINISHED; 

U datoteci lighttpd-1.4.32/src/Makefile.am dodamo sljedeće linije (negdje gdje je prikladno):

 lib_LTLIBRARIES += mod_hello.la
 mod_hello_la_SOURCES = mod_hello.c
 mod_hello_la_LDFLAGS = -module -export-dynamic -avoid-version -no-undefined
 mod_hello_la_LIBADD = $(common_libadd)

Sada pokrenemo niz komandi kako bismo iskompajlirali lighttpd sources (u fascikli /lighttpd-1.4.32):

 make clean
 ./autogen.sh
 ./configure
 make
 make install

U konfiguracijskoj datoteci za lighttpd:

server.modules = (
      "mod_access",
      "mod_alias",
      "mod_compress",
      "mod_redirect",
      #Naš modul hello
      "mod_hello",
)
server.document-root        = "/var/www"
server.upload-dirs          = ( "/var/cache/lighttpd/uploads" )
server.errorlog             = "/var/log/lighttpd/error.log"
server.pid-file             = "/var/run/lighttpd.pid"
server.username             = "www-data"
server.groupname            = "www-data"
server.port                 = 80
index-file.names            = ( "index.php", "index.html", "index.lighttpd.html" )
compress.cache-dir          = "/var/cache/lighttpd/compress/"
compress.filetype           = ( "application/javascript", "text/css", "text/html", "text/plain" )
include_shell "/usr/share/lighttpd/create-mime.assign.pl"
include_shell "/usr/share/lighttpd/include-conf-enabled.pl"

Da bismo testirali naš modul, iskompajliranu datoteku /lighttpd-1.4.32/src/lighttpd pokrećemo sa:

lighttpd -f lighttpd.conf

Testiramo sa:

curl http://127.0.0.1/hello

Gdje je vraćeni rezultat:

hello

Sa ovim člankom smo završili seriju o Lighttpd-u. Preporučujemo čitaocima da pregledaju module koji već postoje, kako bi možda napravili jedan koji bi mogao da se doda u lighttpd.

Prethodni deo