genkgo / xsl
XSL 2.0 Transpiler in PHP
Installs: 74 094
Dependents: 4
Suggesters: 1
Security: 0
Stars: 51
Watchers: 8
Forks: 7
Open Issues: 5
Requires
- php: ~8.2.0 || ~8.3.0
- ext-dom: *
- ext-intl: *
- ext-json: *
- ext-libxml: *
- ext-xsl: *
- psr/simple-cache: ^3.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- phpstan/phpstan: ^1.0
- phpstan/phpstan-phpunit: ^1.0
- phpunit/phpunit: ^9
- dev-master
- 1.5.0
- 1.4.0
- 1.3.1
- 1.3.0
- 1.2.0
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.8
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 1.0.0-beta1
- 1.0.0-alpha11
- 1.0.0-alpha10
- 1.0.0-alpha9
- 1.0.0-alpha8
- 1.0.0-alpha7
- 1.0.0-alpha6
- 1.0.0-alpha5
- 1.0.0-alpha4
- 1.0.0-alpha3
- 1.0.0-alpha2
- 1.0.0-alpha1
- 0.6.11
- 0.6.10
- 0.6.9
- 0.6.8
- 0.6.7
- 0.6.6
- 0.6.5
- 0.6.4
- 0.6.3
- 0.6.2
- 0.6.1
- 0.6.0
- 0.5.21
- 0.5.20
- 0.5.19
- 0.5.18
- 0.5.17
- 0.5.16
- 0.5.15
- 0.5.14
- 0.5.13
- 0.5.12
- 0.5.11
- 0.5.10
- 0.5.9
- 0.5.8
- 0.5.7
- 0.5.6
- 0.5.5
- 0.5.4
- 0.5.3
- 0.5.2
- 0.5.1
- 0.5.0
- 0.4.0
- 0.3.1
- 0.3.0
- 0.2.4
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.0
This package is auto-updated.
Last update: 2024-10-25 10:27:05 UTC
README
XSL 2.0 Transpiler in PHP.
Installation
Requires supported PHP version. It is installable and autoloadable via Composer as genkgo/xsl.
Quality
To run the unit tests at the command line, issue ./vendor/bin/phpunit -c phpunit.xml
. This library attempts to comply with
PSR-1, PSR-2, and PSR-4. If you notice compliance oversights, please send a patch via pull request.
Getting Started
Replace XSLTProcessor
with Genkgo\Xsl\XsltProcessor
, change version="1.0"
in version="2.0"
and you are done!
<?php use Genkgo\Xsl\XsltProcessor; use Genkgo\Xsl\Cache\NullCache; $xslDoc = new DOMDocument(); $xslDoc->load('Stubs/collection.xsl'); $xmlDoc = new DOMDocument(); $xmlDoc->load('Stubs/collection.xml'); $transpiler = new XsltProcessor(new NullCache()); $transpiler->importStylesheet($xslDoc); echo $transpiler->transformToXML($xmlDoc);
Create your own extenions
You can also register your own extensions. Just implement the XmlNamespaceInterface
and you
are ready to use your own element transformations and xpath functions. See the example below and the integration
test to understand how it works.
<?php // use omitted for readability class MyExtension implements XmlNamespaceInterface { const URI = 'https://github.com/genkgo/xsl/tree/master/tests/Stubs/Extension/MyExtension'; public function register(TransformerCollection $transformers, FunctionCollection $functions) { $functions->set( self::URI, new class extends AbstractLazyFunctionMap { public function newFunctionList(): array { return [ 'hello-world' => ['newStringFunction', MyExtension::class], ]; } } ); } public static function helloWorld(Arguments $arguments) { return 'Hello World was called and received ' . count($arguments->unpack()) . ' arguments!'; } } $factory = new ProcessorFactory(new NullCache(), [new MyExtension()]); $processor = $factory->newProcessor();
and then call the function in your style sheet.
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:my="https://github.com/genkgo/xsl/tree/master/tests/Stubs/Extension/MyExtension"> <xsl:output omit-xml-declaration="yes" /> <xsl:template match="/"> <xsl:value-of select="my:hello-world(1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10)" /> </xsl:template> </xsl:stylesheet>
will yield: Hello World was called and received 20 arguments!
.
Caching: transpile once
Depending on the complexity of your stylesheet, the transpiling process could slow down the processing of your
document. Therefore, you probably want to cache the result stylesheet. By adding
psr/simple-cache
to your composer.json, you will add the possibility to enable caching.
See the example below, or the integration test
to see how it works.
<?php use Genkgo\Xsl\Cache\ArrayCache; use Genkgo\Xsl\ProcessorFactory; $factory = new ProcessorFactory(new ArrayCache()); $processor = $factory->newProcessor();
Contributing
- Found a bug? Please try to solve it yourself first and issue a pull request. If you are not able to fix it, at least give a clear description what goes wrong. We will have a look when there is time.
- Want to see a feature added, issue a pull request and see what happens. You could also file a bug of the missing feature and we can discuss how to implement it.