Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/yoreek/nginx-xsltproc-module

XSLT processor based on Nginx
https://github.com/yoreek/nginx-xsltproc-module

Last synced: 3 months ago
JSON representation

XSLT processor based on Nginx

Host: GitHub
URL: https://github.com/yoreek/nginx-xsltproc-module
Owner: yoreek
License: other
Created: 2012-01-02T18:00:14.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2021-01-11T14:39:47.000Z (over 3 years ago)
Last Synced: 2024-01-20T15:42:31.370Z (5 months ago)
Language: C
Homepage:
Size: 1.2 MB
Stars: 4
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README
- Changelog: CHANGES
- License: LICENSE

Lists

awesome-nginx - nginx-xsltproc-module - XSLT processor bases on Nginx. (Third Party Modules / C Modules)
awesome-nginx - nginx-xsltproc-module - XSLT processor bases on Nginx. (Third Modules / C Modules)

README

Name
nginx-xsltproc-module - an extended version of the standard module
HttpXsltModule that allows you to specify a stylesheet in fastcgi
script by passing a specified header.

Synopsis
#nginx.conf
location / {
xsltproc on;

xsltproc_stylesheet_caching on;
xsltproc_stylesheet_root /var/www/example.com/template;
xsltproc_stylesheet_check_if_modify on;

xsltproc_profiler on;
xsltproc_profiler_stylesheet /var/www/example.com/template/profiler.xslt;
xsltproc_profiler_repeat on;

xsltproc_memcached on;
xsltproc_memcached_server 1.1.1.1:11211;
xsltproc_memcached_server 2.2.2.2:11211;
xsltproc_memcached_key_prefix site1_;
xsltproc_memcached_key_auto on;
xsltproc_memcached_expire 60m;

xsltproc_types application/xml;

xml_entities /site/dtd/entities.dtd;

fastcgi_pass 127.0.0.1:9009;
fastcgi_index index.fcgi;
fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
include fastcgi_params;
}

#index.fcgi
#!/usr/bin/perl

use strict;
use warnings;

use CGI::Fast;

my $socket = FCGI::OpenSocket("127.0.0.1:9009", 256);
my $request = FCGI::Request(\*STDIN, \*STDOUT, \*STDERR, \%ENV, $socket);

while ($request->Accept() >= 0) {

print
"X-Xslt-Stylesheet: /xslt/test.xslt?param1=1&param2='test'\r\n",
"Content-type: application/xml\r\n\r\n",
"";
}

Description
This module extends the standard module HttpXsltModule to specify
a stylesheet in fastcgi script by passing a specified header.

Header must be specified as:
X-Xslt-Stylesheet: [?=[&=...]]

Stylesheet path is root-relative.

Parameter values must be escaped with the URI escaping mechanism.

Directives
xsltproc
syntax: *xsltproc on|off*

default: *xsltproc off*

context: *http, server, location, if in location*

Turning this directive on will enable XSLT processing.

xsltproc_stylesheet_root
syntax: *xsltproc_stylesheet_root *

default: *no*

context: *http, server, location, if in location*

Sets the root directory for xslt-templates.

xsltproc_stylesheet_caching
syntax: *xsltproc_stylesheet_caching on|off*

default: *xsltproc_stylesheet_caching off*

context: *http, server, location, if in location*

Turning this directive on will enable stylesheet caching.

xsltproc_stylesheet_check_if_modify
syntax: *xsltproc_stylesheet_check_if_modify on|off*

default: *xsltproc_stylesheet_check_if_modify off*

context: *http, server, location, if in location*

Turning this directive on will check if a stylesheet has been modified
on every request and will update cache if need.

xsltproc_profiler
syntax: *xsltproc_profiler on|off*

default: *xsltproc_profiler off*

context: *http, server, location, if in location*

Turning this directive on will enable collection the profile information.

xsltproc_profiler_stylesheet
syntax: *xsltproc_profiler_stylesheet *

default: *no*

context: *http, server, location, if in location*

If parameter is specified, the profile information added with this template
in the resulting HTML document.

The structure of profile information:

...

...

...

...

An example the result document:

...

...

...

syntax: *xsltproc_memcached_server *

default: *none*

context: *http, server, location, if in location*

Push a server into the list of memcahed servers.

xsltproc_memcached_key_prefix
syntax: *xsltproc_memcached_key_prefix *

default: *none*

context: *http, server, location, if in location*

The memcached key is "$prefix..."

xsltproc_memcached_key_auto
syntax: *xsltproc_memcached_key_auto on|off*

default: *xsltproc_memcached_key_auto off*

context: *http, server, location, if in location*

Turning this directive on will calculate a memcached key as md5sum
of the body + stylesheet info (uri, mtime, params).

xsltproc_memcached_expire
syntax: *xsltproc_memcached_expire *

default: *0*

context: *http, server, location, if in location*

Expiration time.

xml_entities
syntax: *xml_entities *

default: *no*

context: *http, server, location, if in location*

Specifies the DTD file which describes symbolic elements (xml entities).
This file is compiled at the stage of configuration. For technical
reasons it's not possible to specify entities in the XML being processed,
therefore they are ignored, but this specially assigned file is used
instead. In this file it is not necessary to describe structure of
processed XML, it is sufficient only to declare necessary symbolic
elements, for example:

xsltproc_types
syntax: *xsltproc_types mime-type [mime-type...]*

default: *xsltproc_types text/xml*

context: *http, server, location, if in location*

Permit processing responses with specified MIME-types in addition to "text/xml".
If XSLT output mode is HTML, then the response MIME-type changes to "text/HTML".

Using XSLT functions

...

ngx:join
syntax: *string ngx:join(node-set, sep)*

Returns a string created by concatenating the string arguments and using
the sep argument as the separator.

example: ngx:join('string1', 'string2', /root/item, ', ')

xml: 'item1item2'

result: 'string1, string2, item1, item2'

ngx:uc
syntax: *string ngx:uc(string)*

Converts the string argument to upper-case

example: ngx:uc('abcDEF')

result: 'ABCDEF'

ngx:lc
syntax: *string ngx:lc(string)*

Converts the string argument to lower-case

example: *ngx:lc('abcDEF')*

result: 'abcdef'

ngx:ltrim
syntax: *string ngx:ltrim(string)*

Strip whitespace from the beginning of a string

example: ngx:ltrim(' string')

result: 'string'

ngx:rtrim
syntax: *string ngx:rtrim(string)*

Strip whitespace from the end of a string

example: ngx:rtrim('string ')

result: 'string'

ngx:trim
syntax: *string ngx:trim(string)*

Strip whitespace from the beginning and end of a string

example: ngx:trim(' string ')

result: 'string'

Installation
Grab the nginx source code from nginx.org (), for
example, the version 1.0.11, and then build the source with this module:

wget 'http://nginx.org/download/nginx-1.0.11.tar.gz'
tar -xzvf nginx-1.0.11.tar.gz
cd nginx-1.0.11/

./configure --add-module=/path/to/nginx-xsltproc-module

make -j2
make install

Download the latest version of the release tarball of this module from
nginx-xsltproc-module file list
().

Copyright & License
This module is based on the HttpXsltModule module in the Nginx 1.0.11 sources.
The original code is copyright Igor Sysoev.

This module is licensed under the terms of the BSD license.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:

* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.