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.

This product includes software developed by the KLDP.net (http://modurl.kldp.net)


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
