XSL
- Introduction
- Installing/Configuring
- Predefined Constants
- Examples
- 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
Коментарии
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));
?>
The following code is a wrapper to support calls to some of the old xslt_* functions:
<?
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;
?>
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>
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...
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 <?xml?> 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.
Here is function to read from the XSL sheet which is saved as a text file.
function ReadExcelSheet($filename){
$test=file($filename);
$ar1=str_replace("~[^\t]*\t","\t",$test);
$ar2=str_replace("~","",$ar1);
$ar=str_replace("?","",$ar2);
$temp=array();
for ($i=0; $i<count($ar); $i++) {
if((substr($ar[$i],0,1)!= "\t")){
if($ar[$i]!=="\r\n"){
array_push($temp,$ar[$i]);
}
}
}
$name=split("\t",$temp[0]);
$ExcelList=array();
for($i=1;$i<count($temp);$i++){
$split_result=split("\t",$temp[$i]);
array_push($ExcelList,$split_result);
}
$result=insert_into_array($ExcelList,0,$name);
return($result);
}
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 <?xml?> 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.
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/).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! ;-)
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"
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')" />
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
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/
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.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:
<!--[if gte IE 5]>
<link rel="stylesheet" type="text/css" href="ie.css" />
<![endif]-->
This will let you isolate IE-related CSS without needing to use ugly CSS hacks.
@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.
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.
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');
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
<? $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...
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.
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!
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 );
?>
This is more usefull, no files needed, it just takes XML and XSL strings as input parameters and returns transformed XML
<?php
/**
* @param $xml
* @param $xsl
* @return string xml
*/
function transform($xml, $xsl) {
$xslt = new XSLTProcessor();
$xslt->importStylesheet(new SimpleXMLElement($xsl));
return $xslt->transformToXml(new SimpleXMLElement($xml));
}
?>