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')" />
CLXXVI. XSL functions
Introduction
The XSL extension implements the XSL standard, performing XSLT transformations using the libxslt library
Requirements
This extension uses libxslt which can be found at http://xmlsoft.org/XSLT/. libxslt version 1.1.0 or greater is required.
Installation
PHP 5 includes the XSL extension by default and can be enabled by adding the argument --with-xsl[=DIR] to your configure line. DIR is the libxslt installation directory.
Predefined Classes
XSLTProcessor
Constructor
XSLTProcessor->__construct() - construct a new XSLTProcessor object
Methods
XSLTProcessor->getParameter() - Get value of a parameter
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->transformToDoc() - Transform to DOMDocument
XSLTProcessor->transformToURI() - Transform to URI
XSLTProcessor->transformToXML() - Transform to XML
Examples
Many examples in this reference require both an XML and an XSL file. We will use collection.xml and collection.xsl that contains the following:
Predefined Constants
The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.
- Table of Contents
- XSLTProcessor->__construct() -- Creates a new XSLTProcessor object
- XSLTProcessor->getParameter() -- Get value of a parameter
- 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->transformToDoc() -- Transform to a DOMDocument
- XSLTProcessor->transformToURI() -- Transform to URI
- XSLTProcessor->transformToXML() -- Transform to XML
XSL functions
14-Sep-2006 09:45
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"
30-Mar-2006 09:34
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! ;-)
29-Mar-2006 06:07
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 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.
05-Aug-2005 01:27
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:
<?
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
01-Mar-2005 02:17
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);
}
05-Feb-2005 06:32
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.
22-Dec-2004 10:07
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...
24-Sep-2004 10:58
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>
06-Sep-2004 09:23
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;
?>
24-Jun-2004 02:43
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));
?>