deepeloper/lib-xml

XML library allowing to parse XML as array converting node values/attributes types using XSD

3.0.1 2024-06-02 13:03 UTC

Requires

• php: >=8.1
• ext-dom: *
• ext-json: *
• ext-simplexml: *
• ext-xml: *

Requires (Dev)

• friendsofphp/php-cs-fixer: *
• phpunit/phpunit: ^10
• squizlabs/php_codesniffer: *

MIT

• deepeloper

• php
• xml
• library
• xsd

README

Compatibility

Installation

composer require deepeloper/lib-xml

Usage

use deepeloper\Lib\XML\Converter;

require_once "/path/to/vendor/autoload.php";

$converter = new Converter();

// @see https://www.php.net/manual/en/function.xml-parse-into-struct.php#66487
// Little bit modified.
$xml = $converter->xmlToArray(
    file_get_contents("/path/to/xml")
);

// lib-xml<3.0.0, PHP<8.1:
$xml = $converter->parse(
    file_get_contents("/path/to/xml"),
    file_get_contents("/path/to/xsd"),
    [
        // Optional, used to move attributes from '/attributes' key to the element. 
        Converter::COLLAPSE_ATTRIBUTES => true,
        // Optional, used to move children from '/children' key to the element as arrays named as child name. 
        Converter::COLLAPSE_CHILDREN => true,
        // Optional, used to convert arrays from previous option as 'name' => "value". 
        Converter::COLLAPSE_ARRAYS => [
            // Optional, used to exclude collapsing for list of the elements. 
            'exclusions' => [
                "node/subnode/...",
                // ...,
            ],
        ],
    ]
);

// lib-xml>=3.0.0, PHP>=8.1:
$xml = $converter->parse(
    file_get_contents("/path/to/xml"),
    [
        file_get_contents("/path/to/xsd1"),
        file_get_contents("/path/to/xsd2"),
        // ...    
    ],
    [
        Converter::COLLAPSE_ATTRIBUTES => true,
        Converter::COLLAPSE_CHILDREN => true,
        Converter::COLLAPSE_ARRAYS => [
            'exclusions' => [
                "node/subnode/...",
                // ...,
            ],
        ],
    ]
);