47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
|
# laminas-xml
|
||
|
|
|
||
|
|
[](https://github.com/laminas/laminas-xml/actions?query=workflow%3A"Continuous+Integration")
|
||
|
|
|
||
|
|
An utility component for XML usage and best practices in PHP
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
You can install using:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
$ curl -s https://getcomposer.org/installer | php
|
||
|
|
$ php composer.phar install
|
||
|
|
```
|
||
|
|
|
||
|
|
Notice that this library doesn't have any external dependencies, the usage of composer is for autoloading and standard purpose.
|
||
|
|
|
||
|
|
## Laminas\Xml\Security
|
||
|
|
|
||
|
|
This is a security component to prevent [XML eXternal Entity](https://www.owasp.org/index.php/XML_External_Entity_%28XXE%29_Processing) (XXE) and [XML Entity Expansion](http://projects.webappsec.org/w/page/13247002/XML%20Entity%20Expansion) (XEE) attacks on XML documents.
|
||
|
|
|
||
|
|
The XXE attack is prevented disabling the load of external entities in the libxml library used by PHP, using the function [libxml_disable_entity_loader](http://www.php.net/manual/en/function.libxml-disable-entity-loader.php).
|
||
|
|
|
||
|
|
The XEE attack is prevented looking inside the XML document for ENTITY usage. If the XML document uses ENTITY the library throw an Exception.
|
||
|
|
|
||
|
|
We have two static methods to scan and load XML document from a string (scan) and from a file (scanFile). You can decide to get a SimpleXMLElement or DOMDocument as result, using the following use cases:
|
||
|
|
|
||
|
|
```php
|
||
|
|
use Laminas\Xml\Security as XmlSecurity;
|
||
|
|
|
||
|
|
$xml = <<<XML
|
||
|
|
<?xml version="1.0"?>
|
||
|
|
<results>
|
||
|
|
<result>test</result>
|
||
|
|
</results>
|
||
|
|
XML;
|
||
|
|
|
||
|
|
// SimpleXML use case
|
||
|
|
$simplexml = XmlSecurity::scan($xml);
|
||
|
|
printf ("SimpleXMLElement: %s\n", ($simplexml instanceof \SimpleXMLElement) ? 'yes' : 'no');
|
||
|
|
|
||
|
|
// DOMDocument use case
|
||
|
|
$dom = new \DOMDocument('1.0');
|
||
|
|
$dom = XmlSecurity::scan($xml, $dom);
|
||
|
|
printf ("DOMDocument: %s\n", ($dom instanceof \DOMDocument) ? 'yes' : 'no');
|
||
|
|
```
|