CLX. XSLT Functions


This PHP extension provides a processor independent API to XSLT transformations. Currently this extension only supports the Sablotron library from the Ginger Alliance. Support is planned for other libraries, such as the Xalan library or the libxslt library.

XSLT (Extensible Stylesheet Language (XSL) Transformations) is a language for transforming XML documents into other XML documents. It is a standard defined by The World Wide Web Consortium (W3C). Information about XSLT and related technologies can be found at

注: This extension is different than the sablotron extension distributed with versions of PHP prior to PHP 4.1, currently only the new XSLT extension in PHP 4.1 is supported. If you need support for the old extension, please ask your questions on the PHP mailing lists.

注: 本扩展已被移动到 PECL 库中且自以下版本起不再被绑定到 PHP 中:5.0.0.

注: If you need xslt support with PHP 5 you can use the XSL extension.


This extension uses Sablotron and expat, which can both be found at Binaries are provided as well as source.


On Unix, run configure with the --enable-xslt --with-xslt-sablot options. The Sablotron library should be installed somewhere your compiler can find it.

Make sure you have the same libraries linked to the Sablotron library as those, which are linked with PHP. The configuration options: --with-expat-dir=DIR --with-iconv-dir=DIR are there to help you specify them. When asking for support, always mention these directives, and whether there are other versions of those libraries installed on your system somewhere. Naturally, provide all the version numbers.


Be sure your Sablot library is linked to -lstdc++ as otherwise your configure will fail, or PHP will fail to run or load.

JavaScript E-XSLT support: If you compiled Sablotron with JavaScript support, you must specify the option: --with-sablot-js=DIR.

Note to Win32 Users: In order to enable this module on a Windows environment, you must copy several files from the DLL folder of the PHP/Win32 binary package to the SYSTEM32 folder of your windows machine. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32). For PHP <= 4.2.0 copy sablot.dll and expat.dll to your SYSTEM32 folder. For PHP >= 4.2.1 copy sablot.dll, expat.dll and iconv.dll to your SYSTEM32 folder.


本扩展模块在 php.ini 中未定义任何配置选项。




以下常量由本扩展模块定义,因此只有在本扩展模块被编译到 PHP 中,或者在运行时被动态加载后才有效。


Drop all logging and error reporting. This is a generic option for all backends that may be added in the future.


Tell Sablotron to parse public entities. By default this has been turned off.


Do not add the meta tag "Content-Type" for HTML output. The default is set during compilation of Sablotron.


Suppress the whitespace stripping (on data files only).


Consider unresolved documents (the document() function) non-lethal.



Error return code, for scheme handlers.

xslt_backend_info --  Returns the information on the compilation settings of the backend
xslt_backend_name --  Returns the name of the backend
xslt_backend_version --  Returns the version number of Sablotron
xslt_create -- Create a new XSLT processor
xslt_errno -- Returns an error number
xslt_error -- Returns an error string
xslt_free -- Free XSLT processor
xslt_getopt --  Get options on a given xsl processor
xslt_process -- Perform an XSLT transformation
xslt_set_base -- Set the base URI for all XSLT transformations
xslt_set_encoding -- Set the encoding for the parsing of XML documents
xslt_set_error_handler -- Set an error handler for a XSLT processor
xslt_set_log -- Set the log file to write log messages to
xslt_set_object --  Sets the object in which to resolve callback functions
xslt_set_sax_handler -- Set SAX handlers for a XSLT processor
xslt_set_sax_handlers --  Set the SAX handlers to be called when the XML document gets processed
xslt_set_scheme_handler -- Set Scheme handlers for a XSLT processor
xslt_set_scheme_handlers --  Set the scheme handlers for the XSLT processor
xslt_setopt --  Set options on a given xsl processor

add a note add a note User Contributed Notes
06-Aug-2006 06:18
bat at flurf, you said that Sablotron implements XSLT 1.1, but according to its makers, "Sablotron is ...implementing XSLT 1.0, DOM Level2 and XPath 1.0" []
bat at flurf dot net
28-Mar-2006 08:40
maurits says that libxslt should be preferred over Sablotron, but I disagree.  libxslt only implements a fraction of the capabilities of Sablotron; in particular, this doesn't work in libxslt:

   <xsl:variable name="x">

   <xsl:for-each select="$x/a">
     <xsl:value-of select="."/>

In Sablotron, which implements XSLT 1.1, this works fine.  In libxslt's version, XSLT 1.0, a variable is a "result tree fragment", not a nodeset, and you are arbitrarily not allowed to do as much with it.

Further, Sablotron allows callbacks via the document() function (see information on xslt_set_scheme_handler()) and appears to give /slightly/ more informative error messages -- they identify the line number in the XSLT file at least.

In general, I can't recommend libxslt, which appears very underpowered.  Sablotron is considerably more impressive.
gabriel a-t bumpt do-t net
05-Feb-2006 06:50
If you need to transform an XML document that specifies the URL of its own prefered stylesheet (using the processing instruction <?xml-stylesheet href="xyz.xsl"?>, you can start by parsing the XML data to retrieve that URL, and then call the xslt_process function using the specified stylesheet :


/* A small class for stylesheet URL extraction from an XML */

class XMLStylesheet

$this->hParser = xml_parser_create();
xml_set_object($this->hParser, $this);
xml_set_processing_instruction_handler($this->hParser, 'fnProcessingInstruction');
$this->xml = file_get_contents($filename);
xml_parse($this->hParser, $this->xml, true);

fnProcessingInstruction($hParser, $target, $data)
$target == 'xml-stylesheet')
ereg('href="([^"]+)"', $data, $regs);
$this->stylesheet = $regs[1];

/* Now, instanciate an object of this class, given the filename of our XML data */
$xml = new XMLStylesheet('my_data.xml');

/* And finally, retrieve the URL of the stylesheet specified in the XML data. */
$xsl_url = $xml->getStylesheet());

/* Now you can xslt_process as usual. */

maurits at example dot com
06-Dec-2005 07:47
I tried to get Sablotron runnning on a Windows XP - Apache 2 -PHP5 System which is my developement system. I have Sablotron running on a life Linux server. After spending lots of  effort I gave up on Sablotron on Windows.

Then I found out that there is Libxslt, and it is allready working!

I am missing a hint on this page, that Sablotron is not really recommended any more and that people should start to migrate their code to Libxslt.
Jon Dawson
15-Jun-2005 04:23
Getting XSLT running under Red Hat/Plesk 7.5

The PHP installation on my VPS came with '--enable-xslt=shared' '--with-xslt-sablot' '--with-sablot-js=/usr' in the config line. However could not get any transformations to run. Finally got there following these steps:

1. ran 'yum install php-xslt'
2. This installed '' to usr/lib/php4 and other dependencies.
3. Add 'dl('');' to the top of your php files you want to perform a translation in. e.g.

// Allocate a new XSLT processor
$xh = xslt_create();
// Process the document, returning the result into the $result variable
$result = xslt_process($xh, 'test.xml', 'test.xsl');
// Output to browser
echo $result;
Pete Silvester
13-Apr-2005 11:50
When installing on debian using apt/binaries, after installing php4-xslt and sablotron, you may have to add this line to /etc/php4/apache/php.ini :
arossato at istitutocolli dot org
28-Aug-2004 04:12
It is possible to create the xslt extension as a shared object module statically linked with salbot and expat (I needed it for a project hosted in sourceforge where the sablot library is available).
Compile the module as usual:
cd ext/xslt
./configure --enable-module=so --enable-xslt=shared --with-xslt-sablot --with-expat

Then create a statically linked module:
gcc -Wl,-Bstatic -shared  xslt.lo sablot.lo  -o  /usr/local/lib/libsablot.a /usr/local/lib/libexpat.a --static-libgcc

change /usr/local/lib/libsablot.a and /usr/local/lib/libexpat.a according to the right path on your system.

You're done!
My is 5.2M...
tom at kornack dot com
25-Aug-2004 06:09
If you're wrangling with a plist in Mac OS X: here a bit of code to convert the plist into xml using xslt and then accessing it using simplexml. This was modified from . Please do post improvements. This has been tested against iPhoto's AlbumData as well as iTunes' data. Enjoy!

= new DomDocument();
$inputdom = new DomDocument();
$inputdom->load("iTunes Music Library.xml");
$proc = new XsltProcessor();
$xsl = $proc->importStylesheet($xsl);
$newdom = $proc->transformToDoc($inputdom);
$sxe = simplexml_import_dom($newdom);

Here's the plistConvert.sxl file:

<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl  ="" version="1.0">
<xsl:output method="xml" indent="yes"/>

<xsl:template match="/plist">

<xsl:template match="dict">
   <xsl:for-each select="key">
     <xsl:variable name='n1' select='translate(., " ", "_")'/>
     <xsl:variable name='pName'>
           <!-- Need to do this because number tags like <0> are not valid?! -->
         <xsl:when test='contains("0123456789", substring($n1, 1, 1))'>
           <xsl:value-of select='concat("number_", $n1)'/>
           <xsl:value-of select='$n1'/>

     <xsl:element name="{$pName}">
       <xsl:for-each select='following-sibling::*[1]'>
           <xsl:when test='name() = "dict"'>
             <xsl:apply-templates select='.'/>

           <xsl:when test='name() = "array"'>
             <xsl:attribute name="array">collection</xsl:attribute>

           <xsl:when test='name() = "string"'>
             <xsl:value-of select='.'/>

           <xsl:when test='name() = "integer"'>
<!--              <xsl:attribute name="type">integer</xsl:attribute> -->
             <xsl:value-of select='.'/>

           <xsl:when test='name() = "date"'>
<!--              <xsl:attribute name="type">date</xsl:attribute> -->
             <xsl:value-of select='.'/>

           <xsl:when test='name() = "true"'>True</xsl:when>
           <xsl:when test='name() = "false"'>False</xsl:when>
           <xsl:when test='name() = "real"'>
             <xsl:value-of select='.'/>
           <xsl:when test='name() = "data"'>
             <xsl:value-of select='.'/>
             <xsl:message>pListConverter: <xsl:value-of select='name()'/> not implemented!

<!-- don't pass text thru -->
<xsl:template match="text()|@*">

will at NOSPAM dot wdp dot ndo dot co dot uk
17-Nov-2003 06:09
As an update to the previous advice about the undefined references problem when installing PHP with Sablotron, PHP 4.3.4 has a new EXTRA_LDFLAGS_PROGRAM line added to the Makefile. Make sure to add -lstdc++ to this line as well as the EXTRA_LDFLAGS line.
crtn at users dot sourceforge dot net
08-Jun-2003 12:41
Another way to get around the EXPAT-SABLOTRON problems (seg faults) is supposedly to recompile apache with:
d dot brotherstone at pobox dot com
28-May-2003 12:14
If you get problems with undefined references to gxx_s type stuff, UPDATE LIBTOOL!  I found 1.4.1 worked for some configurations, 1.4.3 worked for almost none, but 1.5 worked for every combination of Sablotron/gettext/sybase/zlib/postgres --with options I tried. 

Make sure you follow the advice of adding -lstdc++ to EXTRA_LD_FLAGS in Makefile after you've run ./configure, and BEFORE you've run make (if you issue make, you'll need to do a make clean before you make again, after changing the Makefile, or it still won't work reliably).

Cheers, Dave.
DrTebi at NOSPAM dot yahoo dot NOSPAM dot com
13-May-2003 12:37
I would like to add that there is no problem to install PHP with Sablotron on a Gentoo Linux system (

Just make sure you emerged the expat and sablotron packages like so:

emerge expat
emerge sablotron

After this, there should be no linking problem or whatsoever:

./configure --with-xslt --with-sablotron

and you should be set ;-)
ohlesbeauxjours at yahoo dot fr
21-Mar-2003 04:18
In reply to Jaron, who needed to evaluate PHP code inside the stylesheet, look at a post I sent about xslt_set_scheme_handlers().
Scheme handlers are very useful, since they allow the XSLT engine and PHP to fully interact (they will communicate through XML strings).

With xslt_set_scheme_handlers(), you can give the XSLT engine an advanced access to the file system (or even to the other I/O interfaces), and perform various tasks (checking the existence of a file, creating new files "on the fly", deleting, etc...)
... all that in only one stylesheet :)

aargh at 44rgh dot net
14-Oct-2002 06:47
Compilation on RedHat 7.0 PHP-4.1.2-7.0.4.
Compilation failed when providing --enable-xslt --with-xslt-sablot --with-sablot-js.
Problem was that an additonal flag needed to be specified or the build would fail complaining that js-libs ... could not be found.

LIBS="-lttf -lpng -ljpeg -lz -lnsl -ljs"; export LIBS

The additional flag "-ljs" needed to be set.
jw at shapers dot nl
27-Sep-2002 11:09
In addition to "tk dot lists at fastmail dot fm"'s comment on Windows dependencies: You'll also need iconv.dll in your SYSTEM32 folder. At least, that's what I needed to get it working on my PHP4.2.3-Win install.
gbarattoKILLSPAMMERS at superb dot net
19-Sep-2002 01:55
Regarding the `__gxx_personality_v0' problem described by, you have to use LDFLAGS=-lstdc++  as well before configuring php (and not apache) when compiling php as a shared object.

Thank you Dennis
30-Aug-2002 08:52
For those guys who mess up with compiling the current Sablotron 0.95 sources from

Here is a patch which corrects a typo.
Or - go to src/engine/domprovider.cpp and change "voiD" to "void" in line 558 and compile again...

*** domprovider.cpp.diff        Thu Aug 29 23:32:59 2002
--- domprovider.cpp    Thu Aug 29 23:32:14 2002
*** 555,561 ****
   if (external) cdelete(external);
! void DOMProviderUniversal::setExtProvider(DOMHandler *domh, voiD *data)
   if (external) cdelete(external);
   if (domh)
--- 555,561 ----
   if (external) cdelete(external);
! void DOMProviderUniversal::setExtProvider(DOMHandler *domh, void *data)
   if (external) cdelete(external);
   if (domh)
dennisNOSPAM at infoleak dot com
23-May-2002 12:23
Building Sablotron on Solaris with.
gcc 3.0.3 and native linker
libtool (sunfreeware)
apache 1.3.24

When configuring Apache you might experience this error.. undefined reference to `operator new[](unsigned)' undefined reference to `__cxa_call_unexpected' undefined reference to `vtable for __cxxabiv1::__si_class_type_info' undefined reference to `operator delete(void*)' undefined reference to `__gxx_personality_v0' undefined reference to `vtable for __cxxabiv1::__class_type_info' undefined reference to `operator delete[](void*)' undefined reference to `vtable for __cxxabiv1::__vmi_class_type_info' undefined reference to `operator new(unsigned)'

To cure it make sure that during the configure stage you feed configure LDFLAGS variable like so.

LDFLAGS=' -lstdc++' ./configure

Otherwise Apache's compiler sanity check will balk.
ken1138 at altavista dot com
11-Jan-2002 06:15
The XSLT functions may experience conflicts with Apache in some configurations, causing random segfaults in httpd.  Apache has included a 'lite' version of expat in their recent distributions, which can cause conflicts with expat.  Apache1.3.22 solves the problem by configuring itself to use the expat you have installed, instead of the built-in. If you compiled Apache before you installed expat, make sure you upgrade and/or recompile your Apache server with the same version of expat that PHP and Sablotron are using.
Jaron dot Schaeffer at jayweb dot de
10-Jan-2002 05:25
I extended the example of Daniel Unterberger even more. I had the problem to evaluate PHP code within my xml data files (e.g. to output database results) and after that apply a xsl stylesheet to the generated data.

When I tried Daniel's solution I found it quite useful but noticed that you can't "print out" from your PHP Code. You're bound to annoying return()-Statements, wich makes it impossible to loop outputs or concatenate strings and then return them. If you try to do so, you will notice that a statement like
  for($i=0; $i<10; $i++)
   echo "This is number ".$i;

will result in PHP to do the output right in the moment when the eval()-Statement is run.

Things do, at least, work fine if you keep it simple:

  return("Hello World!");

I tried to fix that and came to a solution. The following code is just a snippet from my XSLT-class. The uppercase letters are constants defined in a header file. (e.g. define('PHP_EVAL_START_TAG', '<php:eval>');

 function xmlString() {

   $fd = fopen($this->xmlFileLocation, 'r');
   $xmlString = fread($fd, filesize($this->xmlFileLocation));

   if($this->contentType == DYNAMIC_CONTENT) {

     while(!(strpos($xmlString, PHP_EVAL_START_TAG) === false)) {

   $startPos = strpos($xmlString, PHP_EVAL_START_TAG);
   $endPos  = strpos($xmlString, PHP_EVAL_END_TAG);

   eval(substr($xmlString, $startPos + strlen(PHP_EVAL_START_TAG), $endPos - $startPos - strlen(PHP_EVAL_START_TAG)));
   $evaluatedString = ob_get_contents();

   $xmlString =
       substr($xmlString, 0, $startPos).$evaluatedString.substr($xmlString, $endPos + 11);
sandro_zic at web dot de
28-Aug-2001 09:57
[Editor's note: moved this note here where it belongs -]

This shows how you can use the XSLT functions to add dynamic content to the result tree, i.e. how to hand over parameters to the XSL stylesheet and write to Sablotron's document buffer.

First we assign the value of the parameter to an array in PHP:
$xslt_params["test"] = "Run-time parameter.";

The parameter is envoced in XSL by
<h1>Value of run-time parameter:</h1>
<b><xsl:value-of select="$test" /></b>

Don't forget to define the parameter at the beginning of your stylesheet:
<xsl:param name="test"/>

How can we add dynamic content from a database to the XSLT output? In Sablotron, this is done using the document buffer function.

Retrieve a table's content, store it in a XML structure assigned to an array in PHP:
$xslt_args["buffer1"] =
       This is message 1 of buffer 1.
       This is message 2 of buffer 1.

This is how you add the buffer to the result tree in your XSL document:
<h1>Dynamic content from document buffer 1:</h1>
<xsl:for-each select="document('arg:/buffer1')/TestBuffer/Message">
   <b><xsl:value-of select="Content" /></b><br/>

To get the whole thing running, following functions have to be executed:
$processor = xslt_create();
xslt_run ($processor, "file://".$DOCUMENT_ROOT.$xsl_file, "file://".$DOCUMENT_ROOT.$xml_file, "arg:/_result", $xslt_params, $xslt_args);
$result = xslt_fetch_result ($processor);
echo $result;

The complete XSL file looks like this:
<?xml version="1.0" encoding="iso-8859-1"?>
<xsl:stylesheet xmlns:xsl="" version="1.0">
<xsl:output method="html" version="1.0" standalone="yes" indent="yes" />

<!-- define parameter -->
<xsl:param name="test"/>

<xsl:template match="/">           

<!-- run-time parameter -->
<h1>Value of run-time parameter:</h1>
<b><xsl:value-of select="$test" /></b>

<!-- dynamic content -->
<h1>Dynamic content from document buffer 1:</h1>
<xsl:for-each select="document('arg:/buffer1')/TestBuffer/Message">
   <b><xsl:value-of select="Content" /></b><br/>


d dot u at mail dot com
14-Jun-2001 03:19
... addition to last message

sorry shanx (miss-spelled).
having a full example you must call it like in the shanx-example. Hint dont use echo inside of <php:eval> but return, because it is only string concatenation.

##  require "";

$xslt = new xsltTransform("life.xsl", "life.xml");
print (

d dot u at mail dot com
14-Jun-2001 02:43
I extended the example of shanks (very helpful for me tnx), so you can call php inside your xslt file, I had the problem to pass url-parameters and did not understand how to solve it, so I use php.


 * A class to transform XML through XSLT using PHP4 Sablotron extension

 ## file extended by Daniel Unterberger (
 ## changes: some  php:eval's added

class xsltTransform


     * Constructor to the xsl_transform ticket
     * @param $xsl_file The XSLT file containing the transformation info
     * @param $xml_file The XML file containing the actual data
     * @see readFile()
function xsltTransform($xsl_file = '', $xml_file = '')
$this->xsl_string = $this->readFile($xsl_file,'php:eval');
$this->xml_string = $this->readFile($xml_file);

     * Function to read through the file
     * @param $fileName Which file to read?
function readFile($fileName,$php_eval="")
// get contents of a file into a string
$fd = fopen( $fileName, "r" );
$content = fread( $fd, filesize( $fileName ) );
fclose( $fd );

       ## extension by Daniel Unterberger (

while ( $php_eval and ( $pos_start=strpos($content,'<php:eval>') ))
substr($content,$pos_start+10,$pos_end-$pos_start-10) ).

       if (
$GLOBALS["debug"]=="ON") print "<xmp>$content</xmp>";
## see xslt-file for debuggin if you call page.php?debug=ON (remove on life-server)

       ## end extension

return $content;


     * Function to apply the actual transformation
function applyTransformation()
$this->result = '';
$this->msg = xslt_process($this->xsl_string, $this->xml_string, $this->result);
$this->msg) print ("Transformation failed.");

// End of class, do not remove


in the xslt you can call it now with

<tag><php:eval> return $GLOBALS["filter"]; /* all php allowed */ </php:eval></tag>

hope this gives new inspiration
maximo at migliari dot com
28-Apr-2001 12:31

0) Prepare your virtual server environment.  Telnet to your iserver and type:
   mkdir -p ~/usr/local/apache/1.3/bin
   ln /usr/bin/make ~/usr/bin/make
   ln /usr/local/apache/1.3/bin/apxs ~/usr/local/apache/1.3/bin/apxs
   ln /usr/local/apache/1.3/bin/httpd ~/usr/local/apache/1.3/bin/httpd

1) download the following files:
   expat-1.95.tar.gz -
   Sablot-0.52.tar.gz -
   php4-latest.tar.gz -

2) copy these files to ~/usr/local

3) expand all these files uing tar -xvzf

4) go into expat directory and type:
   ./configure --prefix=/usr/home/your_iserver_login_name/usr/local
   make install
   the files will be installed under ~/usr/local/lib and ~/usr/local/include

5) set the following environment variables:
   setenv LD_LIBRARY_PATH /usr/home/your_iserver_login_name/usr/local/lib
   setenv LD_RUN_PATH /usr/home/your_iserver_login_name/usr/local/
   setenv CPLUS_INCLUDE_PATH /usr/home/your_iserver_login_name/usr/local/include
   setenv LIBRARY_PATH /usr/home/your_iserver_login_name/usr/local/lib

6) go into the Sablotron directory and type:
   ./configure --prefix=/usr/home/your_iserver_login_name/usr/local
   make install

7) go into the php directory and type:
   ./configure --with-apxs=/usr/local/apache/1.3/bin/apxs \
   --disable-debug \
   --enable-trans-sid \
   --enable-versioning \
   --enable-ftp \
   --with-mysql=/usr/home/your_iserver_login_name/usr/local/mysql \
   --with-xml \
   --enable-magic-quotes \
   --enable-track-vars \
   --enable-sablot-errors-descriptive \
   --with-sablot=/usr/home/your_iserver_login_name/usr/local \


   make install

the final command - make install - should give an error about not being able to install pear.
This is normal, as pear tries to copy itself outside of your virtual server space.  Since pear
is not an essential part of PHP - you can ignore this. (maybe there is a command for ./configure
in php that allows us to specify the directory in which pear will be installed?

8) final steps:
   go to ~/usr/local/etc/httpd/conf
   edit httpd.conf
   comment out the LoadModule directive for the previous php .so module.
   not that you should see the new module you just compile already inserted in the httpd.conf as
   the last line of all LoadModule directives. (it should be called

   now just go back to the command prompt after you have edited httpd.conf and type:

   now go to your httpd document root (usually htdocs), and create a php file with the following
   code in it:


   load the file in your browser, and you should see that everything has been installed properly :)