README

mod_url README document for Lighttpd
# $Id: README,v 1.4 2014-03-06 09:38:34 oops Exp $

mod_url is lighttpd module that fix mismatched URL encoding between server and client.
This module is operated on lighttpd 1.4.x.


1. Compile

   First, edit configura.ac

      1. open the configure.ac
      2. search do_build variable
      3. add mod_url in do_build variable

   Second, edit src/Makefile.am and input follow lines

      lib_LTLIBRARIES += mod_url .la
      mod_accesslog_la_SOURCES = mod_url .c
      mod_accesslog_la_LDFLAGS = -module -export-dynamic -avoid-version -no-undefined
      mod_accesslog_la_LIBADD = $(common_libadd)

   If you build with libiconv, set mod_accesslog_la_LIBADD to follows:

      mod_accesslog_la_LIBADD = -liconv $(common_libadd)
      

   And, build lighttpd
   shell> autoreconf -fi
   shell> ./configure
   shell> make
   shell> make install

2. Usage

   1. Edit your lighttpd configuration file.

      Regist mod_url module on server.module directive.

      server.modules = (
           ...,
           "mod_url"
      )

   2. Activate the mod_url and set encoding variables properly:

      url.debug           :

        Default value is disable [enable/disable]

        Print debug messages at error log file.

      url.enabled         :

        Default value is disable [enable/disable]

        Activate mod_url.

      url.server_encoding :

        default value is EUC-KR

        Encoding of Server side. Value is must one of iconv's ENCODINGs

      url.client_encoding :

        default value is UTF-8

        Encoding of Client side. Value is must one of iconv's ENCODINGs