mod_fileiri: new Apache module under development

Development Notes | Testing | Documentation

For contributions (comments, testing, ports, patches,...) please contact Martin Dürst

Source

See C file in CVS

Documentation

See XML file in CVS (still a lot to be done)

Talks

Internationalized Resounce Identifiers (IRIs) - Server-side Implementation, 24th Internationalization & Unicode Conference in Atlanta, GA, USA, 4 September 2004.

Development notes

Things to work on next:

• Think through end conditions in the code to doublecheck (we may be able to stop sooner on some cases)
• Check conflicts (e.g. both UTF-8 and legacy files exist)
• Test with Off directories and nonconvertible names
• Work through logging details
• Check what AllowOverride category(ies) the directives should go into (currently Options, maybe also FileInfo)
• Look at port to Apache 1.3

Things that work:

• Interaction with mod_speling
• Nested directories
• Multiple languages/encodings
• External redirects to UTF-8 (with Location: header; permanent)
• Double redirects (first external to UTF-8, then internally back to legacy)
• Only one external redirect per overall request
• Backwards mode with files in UTF-8 but requests in legacy

Directives (this may be outdated, not totally sure):

• FileIRImain option, settings:
  • On: Pathnames and filenames in legacy encoding, indicated by FilenameCharset. External permanent redirect to UTF-8 if necessary, serving content from UTF-8 URI.
  • Backwards: Pathnames and filenames in UTF-8. External permanent redirect to UTF-8 if request in OldFilenameCharset.
  • Off: No conversion is done. Any other/undefined value is equivalent to Off
• FilenameCharset: character encoding of pathnames and filenames in the directory (or below)
• OldFilenameCharset: former character encoding of pathnames and filenames in the directory (or below), before switching to UTF-8.

2-d table:

Testing

List of file names to test with (U: UTF-8, L: Legacy):

Hierarchical tests

UTF-8 -> legacy: Übersetzung/перевод/Übersetzung.html

mixed -> legacy: UÜbersetzung/Uперевод/LÜbersetzung.html, UÜbersetzung/Lперевод/UÜbersetzung.html, UÜbersetzung/Lперевод/LÜbersetzung.html, LÜbersetzung/Uперевод/UÜbersetzung.html, LÜbersetzung/Uперевод/LÜbersetzung.html, LÜbersetzung/Lперевод/UÜbersetzung.html

legacy -> legacy: Übersetzung/перевод/Übersetzung.html

UTF-8 -> UTF-8: Übersetzung/перевод/Übersetzung.html

mixed -> UTF-8: UÜbersetzung/Uперевод/LÜbersetzung.html, UÜbersetzung/Lперевод/UÜbersetzung.html, UÜbersetzung/Lперевод/LÜbersetzung.html, LÜbersetzung/Uперевод/UÜbersetzung.html, LÜbersetzung/Uперевод/LÜbersetzung.html, LÜbersetzung/Lперевод/UÜbersetzung.html

legacy -> UTF-8: Übersetzung/перевод/Übersetzung.html

Special cases

Nonexisting documents: réservation (UTF-8->legacy), réservation (legacy->legacy), réservation (legacy->UTF-8), réservation (UTF-8->UTF-8)

Misspellings: résumè (UTF-8->legacy), résumè (legacy->legacy), résumè (legacy->UTF-8), résumè (UTF-8 -> UTF-8)