AnyDataset-Xml

Read an XML document as a table: choose the node that is a row, map each field with XPath, iterate the rows.

Why

Reading XML with DOM or SimpleXML means walking nodes, handling namespaces and repeated elements, and converting every value by hand, each time with different code.

XmlDataset turns it into rows. Say which node is a row and map each field with an XPath expression (or a closure), namespaces included:

$dataset = new XmlDataset($xml, 'book', [
    'category' => '@category',
    'title'    => 'title',
    'lang'     => 'title/@lang',
]);

The result is the same iterator of rows as every other AnyDataset source, so the code that reads it does not care that the data was XML.

Features

• Simple XML Processing: Process XML data with a clean, consistent API
• XPath Support: Use XPath expressions to select nodes and attributes
• Namespace Support: Full support for XML namespaces
• Repeated Node Handling: Automatically handles repeated nodes by returning arrays
• Custom Field Processing: Define custom field mappings with closures/callbacks
• Flexible Input: Accept XML as string, DOMDocument, XmlNode, or File object
• AnyDataset Integration: Compatible with the AnyDataset abstraction layer

Documentation

• XmlDataset - Main class for working with XML data
• XPath Expressions - Guide to using XPath in the library

Quick Example

<?php
$xml = file_get_contents('example.xml');

$dataset = new \ByJG\AnyDataset\Xml\XmlDataset(
    $xml,        // The XML string, can also be an XmlNode, DOMDocument, or File object
    "book",      // The node that represents a row
    [
        "category" => "@category",
        "title" => "title",
        "lang" => "title/@lang",
        "lang2" => function ($row) {
            return substr($row->get('lang'), 0, 2);
        }
    ] // Mapping columns
);

$iterator = $dataset->getIterator();
foreach ($iterator as $row) {
    echo $row->get('category'); // Print COOKING, CHILDREN, WEB
    echo $row->get('title');    // Print Everyday Italian, Harry Potter, Learning XML
    echo $row->get('lang');     // Print en-US, de-DE, pt-BR
    echo $row->get('lang2');    // Print en, de, pt
}

Installation

composer require "byjg/anydataset-xml"

Running Tests

vendor/bin/phpunit

---

Open source ByJG