XSL

简介
安装／配置
- 需求
- 安装
- 运行时配置
- 资源类型
预定义常量
范例
- Example collection.xml and collection.xsl files
- Error handling with libxml error handling functions
XSLTProcessor — The XSLTProcessor class
- XSLTProcessor::__construct — Creates a new XSLTProcessor object
- XSLTProcessor::getParameter — Get value of a parameter
- XsltProcessor::getSecurityPrefs — Get security preferences
- XSLTProcessor::hasExsltSupport — Determine if PHP has EXSLT support
- XSLTProcessor::importStylesheet — Import stylesheet
- XSLTProcessor::registerPHPFunctions — Enables the ability to use PHP functions as XSLT functions
- XSLTProcessor::removeParameter — Remove parameter
- XSLTProcessor::setParameter — Set value for a parameter
- XSLTProcessor::setProfiling — Sets profiling output file
- XsltProcessor::setSecurityPrefs — Set security preferences
- XSLTProcessor::transformToDoc — Transform to a DOMDocument
- XSLTProcessor::transformToUri — Transform to URI
- XSLTProcessor::transformToXML — Transform to XML

用户评论:

[#1] Jaroslaw Zabiello [2011-06-23 07:10:21]

This is more usefull, no files needed, it just takes XML and XSL strings as input parameters and returns transformed XML

<?php function transform($xml, $xsl) { $xslt = new XSLTProcessor(); $xslt->importStylesheet(new SimpleXMLElement($xsl)); return $xslt->transformToXml(new SimpleXMLElement($xml)); } ?>

[#2] sudhir dot vis at gmail dot com [2009-04-25 11:40:01]

Here is a simplest way to transform the xml from php

<?php $sXml = "<xml>"; $sXml .= "<sudhir>hello sudhir</sudhir>"; $sXml .= "</xml>"; # LOAD XML FILE $XML = new DOMDocument(); $XML->loadXML( $sXml ); # START XSLT $xslt = new XSLTProcessor(); $XSL = new DOMDocument(); $XSL->load( 'xsl/index.xsl', LIBXML_NOCDATA); $xslt->importStylesheet( $XSL ); #PRINT print $xslt->transformToXML( $XML ); ?>

[#3] allens at nospam dot com [2009-04-19 20:45:08]

Problem:
Getting Netbeans error message:
Fatal error: Class 'xsltprocessor' not found

Solution:
place copy of php.ini in the c:\windows directory!

by default the php.ini file has xsl disabled......search for the line

;extension=php_xsl.dll

to enable XSL....remove ; so that the extension gets included

Then if Netbeans gives you the following message:
PHP Startup: Unable to load dynamic library './php_xsl.dll'

then you need to run the php-5.2.9-1-win32-installer.msi again
this time selecting the XSL extension!

[#4] visual77 at gmail dot com [2008-09-20 16:35:57]

The XSLTProcessor is kind of a pain to use to generate an entire website, mostly due to the tedious process of building an XML tree through DOMDocument's createElement and appendChild functions.

To get an entire website out of nothing but XML and XSL (which really is a superior system to just echoing out the HTML), you could use an object that does all the PHP data structure to XML data tree conversion, and combines with the XSLTProcessor for rendering. A good object like this is DOMi, which you can find at http://domi.sourceforge.net.

[#5] emilise dot victor at gmail dot com [2008-03-12 08:10:32]

Here is a way to get an output without using <xml:message> : use the var_dump function of php :
- First bind the php functions with
<?php $xslt->registerPHPFunctions() ?>
and xmlns:php="http://php.net/xsl" in the stylesheet
- Then you can call the var_dump function like this : <xsl:variable name="a" select="php:function('var_dump', $return)" />

I couldn't find a way to call the function and have it really print the result without creating a variable, but well, it's just for debugging...

[#6] shangxiao at php dot net [2008-01-10 17:38:45]

When using the DOM api to add xsl commands to your stylesheet dynamically, be sure to use createElementNS() rather than createElement() otherwise the XSLTProcessor will not recognise these DOM nodes.

Eg:
$xsl->createElementNS('http://www.w3.org/1999/XSL/Transform', 'xsl:element');

[#7] pb at online-magazin dot at [2007-10-11 15:13:57]

Calling the Saxon XSLT Processor is a very esay task to do!

You just need to do some simple task

1. Install the JavaBridge for PHP

2. Download the freeware (B) Saxon distribution from http://saxon.sourceforge.net/

3. Put the jar files in a directory whre you have access

4. Use this sample of code

// Directory where the jar files are located
define("SAXON_DIR", $_SERVER['DOCUMENT_ROOT']."/saxonb8.9.0/");

// include the jars
java_require(SAXON_DIR."saxon8.jar;".SAXON_DIR."saxon8-dom.jar");

$sXslFile = $_SERVER['DOCUMENT_ROOT']."/myfirst.xsl"; // The xsl file
$sXmlFile = $_SERVER['DOCUMENT_ROOT']."/myfirst.xml"; // The xml file

try
{
  $oXslSource = new java("javax.xml.transform.stream.StreamSource", "file://".$sXslFile);
  $oXmlSource = new java("javax.xml.transform.stream.StreamSource", "file://".$sXmlFile);

  $oFeatureKeys = new JavaClass("net.sf.saxon.FeatureKeys");

  // Create the Factory
  $oTransformerFactory = new java("net.sf.saxon.TransformerFactoryImpl");

  //Disable source document validation
  $oTransformerFactory->setAttribute($oFeatureKeys->SCHEMA_VALIDATION, 4);

  // Create a new Transformer
  $oTransFormer = $oTransformerFactory->newTransformer($oXslSource);

  // Create a StreamResult to store the output
  $oResultStringWriter = new java("java.io.StringWriter");
  $oResultStream = new java("javax.xml.transform.stream.StreamResult", $oResultStringWriter);

  // Transform
  $oTransFormer->transform($oXmlSource, $oResultStream);

  // Echo the output from the transformation
  echo java_cast($oResultStringWriter->toString(), "string");

}
catch(JavaException $e){
   echo java_cast($e->getCause()->toString(), "string");
   exit;
}

5. Enjoy

This is working quite well.

[#8] Vasil Rangelov [2007-08-21 07:31:02]

@basslines at gmail dot com
"
As far as I can tell, the most recent stable versions of LibXML/LibXSLT/LibEXSLT do NOT support xPath 2.0 / XSLT 2.0 transformations. The only support for XSLT 2.0 that I've found is in Java's SAXON processor (http://saxon.sourceforge.net/).
"

Using SAXON or AltovaXML by using their JAVA bindings could prove to be a difficult task to do, and .NET seems to be buggy (at least for me). However, I've made a class that uses SAXON or AltovaXML from the command line. AltovaXML could also be used with COM, provided it's registered as a COM component.

You can download my wrapper from:
http://xslt2processor.sourceforge.net/

I still need to implement a more graceful error handling (the way the XSL extension uses the Libxml functions), and once the bug
http://bugs.php.net/bug.php?id=41577
is fixed, I'll implement the .NET interfaces too.

I'll appreciate any feedback.

[#9] geoffreyj dot lee at gmail dot com [2007-07-01 23:02:20]

Here are a couple useful tips for those who care about cross-browser compatibility.

Given:

<script type="text/javascript" src="test.js"></script>

XSLT will automatically condense it to:

<script type="text/javascript" src="test.js"/>

While this is good, Internet Explorer breaks on empty script tags. So, the simple solution is to add something to prevent an empty tag. For example:

<script type="text/javascript" src="test.js"><xsl:comment/></script>

Produces:

<script type="text/javascript" src="test.js">

</script>

------------------------

Also, here is a way to use IE's conditional comments:

<xsl:comment>[if gte IE 5]>
<link rel="stylesheet" type="text/css" href="ie.css" />
<![endif]</xsl:comment>

Produces:



This will let you isolate IE-related CSS without needing to use ugly CSS hacks.

[#10] gabriel dot birke at web dot de [2007-05-10 03:19:24]

Each <xsl:message> tag will generate a PHP error (level Warning). If you want to collect and pretty-print them, you could use a custom error handling function that collects the warnings in a static variable.

[#11] mnot at mnot dot net [2007-05-08 20:59:21]

You can set an HTTP proxy for the XSLT document() function to use (as well as DTD external references) by setting http_proxy in the environment.

E.g., in Apache configuration;

SetEnv http_proxy http://127.0.0.1:3128/

[#12] Ryan D. Hatch [2007-05-02 01:14:21]

Looking for php_xsl.dll?

If you installed on Windows using the MSI Installer - you may not have it.

1.) Add/Remove Programs and Change PHP Installation. Select XSL Extension.

OR

2.) Download complete .zip file of PHP and you can copy php_xsl.dll into your PHP/etc directory.

Just a note.

Ryan D. Hatch

[#13] adrian at foeder dot de [2006-09-14 02:45:15]

If you want to use the document()-function inside your XSL stylesheet, please note that you have to use an absolute path there.
Important for windows users: the absolute path *has* to be with forward slashes, so subsitute windows-path-backslashes to forward slashes before you transform the document.

Examples:
This will NOT work:
<xsl:copy-of select="document('test.xml')" />

This will also NOT work:
<xsl:copy-of select="document('c:\temp\test.xml')" />

But this WILL work:
<xsl:copy-of select="document('c:/temp/test.xml')" />

[#14] [2006-04-27 18:26:27]

Enable libxslt library, PHP 5, under windows:

To Enable:
In your php.ini
1. Uncomment ;extension=php_xsl.dll
2. Change extension_dir to
extension_dir = "./ext"

To Confirm:
1. In a test.php page:
<?php phpinfo() ?>
2. Run test.php
3. Search for "libxslt Version". It should return a version number in a XSL headed table.

Further info Google
"Configuring and Testing PHP Servers for XSL Support"

[#15] Fabrice Bonny [2006-03-30 01:34:23]

In response to how to use entities from DTD (internal or external) in XSLT. It works if you do this way:

$xsl = new DOMDocument;
$xsl->resolveExternals = TRUE;
$xsl->substituteEntities = TRUE;
$xsl->load(...);

Hope this helps! ;-)

[#16] basslines at gmail dot com [2006-03-29 10:07:26]

As far as I can tell, the most recent stable versions of LibXML/LibXSLT/LibEXSLT do NOT support xPath 2.0 / XSLT 2.0 transformations. The only support for XSLT 2.0 that I've found is in Java's SAXON processor (http://saxon.sourceforge.net/).

[#17] [2006-03-17 09:14:53]

In response to appletalk at gmail dot com
<snip>
As many of you may have noticed, DOM parser gives errors if the ' ' entity is present. The E_WARN message looks like:
Warning: DOMDocument::load() [function.load]: Entity 'nbsp' not defined in ...
There're many ways to solve this:
.....
b) Defining  
At the top of the document, after the <?phpxml?> definition, add:
   <!DOCTYPE xsl:stylesheet [
   <!ENTITY nbsp " " >
   ]>
.......</snip>
Just wanted to let people know that option b does NOT work. I'm not sure why this isn't implemented correctly, but it isn't, so don't waste your time. It's unfortunate the DOMXSL transform is so much less capable than the old xslt function.

[#18] olivier dot sow at alias dot france [2005-08-05 06:27:38]

if you have 'XML parser error 4: not well-formed (invalid token)' error without but your are sure to do no error at all, try this:
<?php function XSL_transformation($XMLFile,$XSLFile,$ResultFile,$xsl_params){ $Str = ''; $xp = xslt_create() or trigger_error('Could not create XSLT process.', E_USER_ERROR); xslt_set_encoding($xp, 'ISO-8859-1'); // read the files into memory $xsl_string = join('', file($XSLFile)); $xml_string = join('', file($XMLFile)); // set the argument buffer $arg_buffer = array('/xml' => $xml_string, '/xsl' => $xsl_string); // process the two files to get the desired output if (($Str = xslt_process($xp, 'arg:/xml', 'arg:/xsl', NULL, $arg_buffer, $xsl_params))){ //Saves transformation result into '$ResultFile' $fp = fopen($ResultFile,"w+"); fwrite($fp,$Str); fclose($fp); return true; } return false; } ?>

found here: http://bugs.php.net/bug.php?id=16193

[#19] venkatesh at lammersmedical dot com [2005-03-01 06:17:50]

[#20] appletalk at gmail dot com [2005-02-04 22:32:50]

As many of you may have noticed, DOM parser gives errors if the ' ' entity is present. The E_WARN message looks like:

Warning: DOMDocument::load() [function.load]: Entity 'nbsp' not defined in ...

There're many ways to solve this:
a) The hard way
<xsl:text disable-output-escaping="yes"> &nbsp;</xsl:text>

b) Defining  
At the top of the document, after the <?phpxml?> definition, add:
   <!DOCTYPE xsl:stylesheet [
    <!ENTITY nbsp " " >
    ]>

c) External Doctype
Just in case you want need other HTML entities, you can call an external doctype with the proper definitions

<!DOCTYPE page SYSTEM "http://gv.ca/dtd/character-entities.dtd">

Of course, you can download the file and place it in your server.

[#21] kekoajs at yahoo dot com [2004-12-22 14:07:54]

Wow, I spent the better part of a day looking for how one could pass an entire test expression to an XSL stylesheet.  It seems that the XSLT 1.0 specification doesn't support it but PHP 5 (and maybe 4s) inclusion of  EXSLT allows one to do exactly that...

simply add these lines...

xmlns:dyn="http://exslt.org/dynamic"
extension-element-prefixes="dyn"

to the <xsl:stylesheet> element and when using an expression stored in a <xsl:param> element write

<xsl:if test="dyn:evaluate($param-name)">

and viola!  you can now use expressions generated externally in your stylesheet!

EXSLT adds many useful functions that can be integrated into your XSL in a similar fashion.  You can go to http://exslt.org/ to learn more...

[#22] rd at jerntorget dot se [2004-09-24 03:58:55]

If you get the following warning message:

xsltApplyOneTemplate: _if_ was not compiled in (if can for example be apply-template or some other method), i've found that the problem seems to be an   directly before the <xsl:if> or what ever is causing the problem.

One way to get thru the problem is to use span tags around   like : <span> </span>

[#23] jw at jwscripts dot com [2004-09-06 02:23:19]

The following code is a wrapper to support calls to some of the old xslt_* functions:

<?php if (PHP_VERSION >= 5) { // Emulate the old xslt library functions function xslt_create() { return new XsltProcessor(); } function xslt_process($xsltproc, $xml_arg, $xsl_arg, $xslcontainer = null, $args = null, $params = null) { // Start with preparing the arguments $xml_arg = str_replace('arg:', '', $xml_arg); $xsl_arg = str_replace('arg:', '', $xsl_arg); // Create instances of the DomDocument class $xml = new DomDocument; $xsl = new DomDocument; // Load the xml document and the xsl template $xml->loadXML($args[$xml_arg]); $xsl->loadXML($args[$xsl_arg]); // Load the xsl template $xsltproc->importStyleSheet($xsl); // Set parameters when defined if ($params) { foreach ($params as $param => $value) { $xsltproc->setParameter("", $param, $value); } } // Start the transformation $processed = $xsltproc->transformToXML($xml); // Put the result in a file when specified if ($xslcontainer) { return @file_put_contents($xslcontainer, $processed); } else { return $processed; } } function xslt_free($xsltproc) { unset($xsltproc); } } $arguments = array( '/_xml' => file_get_contents("newxslt.xml"), '/_xsl' => file_get_contents("newxslt.xslt") ); $xsltproc = xslt_create(); $html = xslt_process( $xsltproc, 'arg:/_xml', 'arg:/_xsl', null, $arguments ); xslt_free($xsltproc); print $html; ?>

[#24] rojaro [2004-06-23 19:43:58]

If you're want to use XML from a variable e.g. $xmldata but the XSLT-StyleSheet from a file, you can do it also the following way:

<?php $xslt = new xsltProcessor; $xslt->importStyleSheet(DomDocument::load('filename.xsl')); print $xslt->transformToXML(DomDocument::loadXML($xmldata)); ?>