NAME

Apache::DefaultCharset - AddDefaultCharset configuration from mod_perl

SYNOPSIS

use Apache::DefaultCharset;

      # This module adds "add_default_charset_name" method
      $charset = $r->add_default_charset_name;
      $r->add_default_charset_name('euc-jp');

      # via Apache::DefaultCharset object
      $charset = Apache::DefaultCharset->new($r);
      print "default_charset_name is ", $charset->name;
      # or print "default charset is $charset"; will do (overload)
      $charset->name('euc-jp');

DESCRIPTION

Apache::DefaultCharset is an XS wrapper for Apache Core's "AddDefaultCharset" configuration.

EXAMPLES
Unicode Handling

Suppose you develop multi-language web application, and transparently decode native encodings into Unicode string inside Perl (5.8 or over would be better). First you should add

AddDefaultCharset euc-jp

in your "httpd.conf", then leave off "send_http_header" arguments just to text/html. Then you can get the current configuration with this module when you use "Encode" or "Text::Iconv" to decode the HTTP request query into Unicode.

Modification of DefaultCharset

Suppose you want to add utf-8 for XML files, and Shift_JIS for HTML files as HTTP charset attribute by default ("By default" means that if you set "content_type" explicitly in content-generation phase, that will be prior to the defalut). This module enables you to write "PerlFixupHandler" to configure "add_default_charset_name" in run-time.

AUTHOR

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

the Apache::DefaultCharset manpage

mod_perl cookbook at http://www.modperlcookbook.org/