head	1.5;
access;
symbols;
locks; strict;
comment	@# @;


1.5
date	2016.02.02.17.40.41;	author oops;	state Exp;
branches;
next	1.4;

1.4
date	2014.03.24.16.28.02;	author oops;	state Exp;
branches;
next	1.3;

1.3
date	2012.01.24.17.35.03;	author oops;	state Exp;
branches;
next	1.2;

1.2
date	2007.11.09.18.25.58;	author oops;	state Exp;
branches;
next	1.1;

1.1
date	2007.06.05.19.50.35;	author oops;	state Exp;
branches;
next	;


desc
@@


1.5
log
@update document
@
text
@mod_url README document for Apache 2

# $Id: README,v 1.4 2014/03/24 16:28:02 oops Exp $

mod_url is Apache module that fix mismatched URL encoding between server and client.
This module is operated on Apache 2. For apache1 see also follow URL:
http://modurl.kldp.net/ or http://kldp.net/projects/modurl/

Current version is tested follw versions:
    2.0.64
    2.2.31
    2.4.18


1. Overview

   working follows. if your configuration as follows..

   SERVER_ENCODING EUC-KR
   CLIENT_ENCODING UTF-8

   1. Main server
      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      replace internal path of r->uri, r->unparsed_uri and r->parsed_uri.path
      On filename translation hook, replace %ED%95%9C%EA%B8%80 to
      %C7%D1%B1%DB.

   2. Virtual Host
      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      replace internal path of r->uri, r->unparsed_uri and r->parsed_uri.path
      On filename translation hook, replace %ED%95%9C%EA%B8%80 to
      %C7%D1%B1%DB.

   3. Virtual Host Alias module
      use 304 Redirection on fixups hook

   4. UserDir
      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      replace internal path of r->uri, r->unparsed_uri and r->parsed_uri.path
      On filename translation hook, replace %ED%95%9C%EA%B8%80 to
      %C7%D1%B1%DB.

      If apache server hasn't mod_userdir module, use 304 Redirection
      on fixups hook


2. Compile

   2.1 DSO build
       shell> apxs -i -c mod_url.c

       or do follow command on mod_url source directory

       shell> make

   2.2 static build
       shell> cp -r mod_url/ /path/apache-src/src/modules/url
       shell> rm /path/apache-src/src/modules/url/GNUmakefile
       shell> cd /path/apache-src
       shell> ./configure .... --enable-modules=all ..
              or
       shell> ./configure --enable-url=shared ...

2. Usage

   3.1 Edit your conf/httpd.conf file, and add a LoadModule line:

       LoadModule  redurl_module   modules/mod_url.so

   3.2 Activate the mod_url and set encoding variables properly:

       <IfModule mod_url.c>
           CheckURL On
           ServerEncoding EUC-KR
           ClientEncoding UTF-8
       </IfModule>

   3.3 support per directory config

       <Directory /path/some>
           <IfModule mod_url.c>
               CheckURL Off
           </IfModule>
       </Directory>

@


1.4
log
@remove dependency mod_userdir
@
text
@d3 1
a3 1
# $Id: README,v 1.3 2012/01/24 17:35:03 oops Exp $
d11 2
a12 4
    2.2.21

Attension!!!:
   Maybe this module does not Thread Safe. So, don't recommanded apache thread mpm!
@


1.3
log
@update last test apache version
@
text
@d3 1
a3 1
# $Id: README,v 1.2 2007/11/09 18:25:58 oops Exp $
a72 14
   2.3 Warn!
       mod_url has dependency of mod_userdir. If your apache don't include
       mod_userdir module, you can build with follows.

       2.3.1 DOS build
           shell> apxs -i -c -DURL_NOUSERDIR mod_url.c

           or do follow command on mod_url source directory

           shell> make EXTRA_CFLAGS="-DURL_NOUSERDIR"

       2.3.2 static build
           shell> EXTRA_CFLAGS="-DURL_NOUSERDIR" ./configure ... --add-module=mod_url.c ..

a78 6
       If you built with no URL_NOUSERDIR build constant, be careful after load
       mod_userdir then, load mod_url.

       LoadModule  userdir_module   modules/mod_userdir.so
       LoadModule  redurl_module    modules/mod_url.so

@


1.2
log
@bug #304629: fixed content-type ploblems on internal replace path mode
@
text
@d3 1
a3 1
# $Id: README,v 1.1 2007/06/05 19:50:35 oops Exp $
d10 2
a11 2
    2.0.59
    2.2 (Don't check yet. Maybe will operate..)
@


1.1
log
@support IE7 and redesign check_redurl
@
text
@d2 2
a3 1
# $Id: $
d10 2
a11 2
    2.0.52
    2.2.3
d17 30
a46 1
1. Compile
d48 11
a58 1
   1.1 DSO build
d65 1
a65 1
   1.2 static build
d73 14
d89 6
a94 1
   1. Edit your conf/httpd.conf file, and add a LoadModule line:
d96 2
a97 1
      LoadModule  redurl_module   modules/mod_url.so
d99 1
a99 1
   2. Activate the mod_url and set encoding variables properly:
d101 5
a105 5
      <IfModule mod_url.c>
          CheckURL On
          ServerEncoding EUC-KR
          ClientEncoding UTF-8
      </IfModule>
d107 1
a107 1
   3. support per directory config
d109 5
a113 5
      <Directory /path/some>
          <IfModule mod_url.c>
              CheckURL Off
          </IfModule>
      </Directory>
@

