NAME Apache::MimeXML - mod_perl mime encoding sniffer for XML files SYNOPSIS Simply add this line to srm.conf or httpd.conf: PerlTypeHandler +Apache::MimeXML Alternatively add it only for certain files or directories using the standard Apache methods. There is about a 30% slowdown for files using this module, so you probably want to restrict it to certain XML locations only. DESCRIPTION An XML Content-Type sniffer. This module reads the encoding attribute in the xml declaration and returns an appropriate content-type heading. If no encoding declaration is found it returns utf-8 or utf-16 depending on the specific encoding. CONFIGURATION There are a few small configuration options for this module, allowing you to set various parameters. XMLMimeType Allows you to set the mime type for XML files: PerlSetVar XMLMimeType application/xml That changes the mime type from the default text/xml to application/xml. You can use this on a per-directory basis. XMLUtf16EncodingBE Allows you to set the encoding of big-endian (read: normal) utf 16 (unicode) documents. The default is 'utf-16' PerlSetVar XMLUtf16EncodingBE utf-16-be XMLUtf16EncodingLE Allows you to set the encoding of little-endian utf-16 encoded documents. The default is 'utf-16-le' PerlSetVar XMLUtf16EncodingLE utf-16-wierd Use From Other Modules If you want to use Apache::MimeXML's detection routines from other modules, you can manually call the check_for_xml() function yourself, passing in either a filename, or an open filehandle. The function returns the encoding if it finds that the file contains XML, otherwise it returns nothing: my $encoding; if ($encoding = Apache::MimeXML::check_for_xml($filename)) { print "$filename is XML in $encoding encoding\n"; } AUTHOR Matt Sergeant matt@sergeant.org LICENCE This module is distributed under the same terms as perl itself