NAME
Plack::Middleware::XSLT - XSLT transformations with Plack
VERSION
version 0.20002
SYNOPSIS
# in your .psgi
enable 'XSLT';
# in your app
$env->{'xslt.style'} = 'stylesheet.xsl';
return [ 200, $headers, [ $xml ] ];
DESCRIPTION
Plack::Middleware::XSLT converts XML response bodies to HTML, XML, or text using XML::LibXSLT. The XSLT stylesheet is specified by the environment variable 'xslt.style'. If this variable is undefined or empty, the response is not altered. This rather crude mechanism might be enhanced in the future.
The Content-Type header is set according to xsl:output. Content-Length is adjusted.
CONFIGURATION
- cache
-
enable 'XSLT', cache => 1;
Enables caching of XSLT stylesheets. Defaults to false.
- path
-
enable 'XSLT', path => 'path/to/xsl/files';
Sets a path that will be prepended if xslt.style contains a relative path. Defaults to the current directory.
- parser_options
-
enable 'XSLT', parser_options => \%options;
Options that will be passed to the XML parser when parsing the input document. See "PARSER OPTIONS" in XML::LibXML::Parser.
HTTP EXCEPTIONS
If the transform exits via <xsl:message terminate="yes"
> and the message contains a line starting with a three-digit HTTP response status code, a corresponding HTTP::Exception is thrown.
AUTHOR
Nick Wellnhofer <wellnhofer@aevum.de>
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Nick Wellnhofer.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.