matraux/xml-orm

A PHP 8.4+ library for converting XML data to typed entities and back, with support for lazy-loading collections and XML namespaces.

1.6.0 2025-07-31 22:48 UTC

Requires

• php: ^8.4
• nette/utils: *

Requires (Dev)

• contributte/qa: ^0.3.2
• nette/neon: ^3.4
• nette/tester: ^2.5
• phpstan/phpstan: ^2.1
• tracy/tracy: ^2.10

MIT

• Daniel Žůrek

• MATRAUX
• XML ORM
• xml-orm

README

Introduction

A PHP 8.4+ library for converting XML data to typed entities and back, with support for lazy-loading collections, XML namespaces, and structured entity design. Useful for parsing configuration files, processing structured XML APIs, and working with hierarchical XML data in an object-oriented way.

Features

• Object-oriented XML mapping
• Conversion from XML to typed entities and back
• Lazy-loading collections for efficient memory usage
• Entity objects are mutable and can be freely modified after creation
• Mapping via PHP attributes (no separate config files needed)
• Strict type support with automatic casting
• Native support for nested structures and arrays
• Full support for XML namespaces
• Easy integration with configuration files or XML-based APIs

Installation

composer require matraux/xml-orm

Requirements

version	PHP	Note
1.0.1	8.2+	Initial commit
1.4.1	8.3+	Parsing via PHP attributes
1.5.0	8.4+	Performance optimization, metadata caching
1.6.0	8.4+	Enum support, security hardening, doc fixes

Examples

See Definitions for how to define your own entities and collections.

See Read for full reading examples.

use Matraux\XmlORM\Xml\SimpleXmlExplorer;

$explorer = SimpleXmlExplorer::fromString($xml);
$main = MainEntity::fromExplorer($explorer);
echo $main->name;

See Write for writing examples.

$main = MainEntity::create();
$main->id = 1000;
$main->name = 'Maim entity';

echo $main;

Development

See Development for debug, test instructions, static analysis, and coding standards.

Support

For bug reports and feature requests, please use the issue tracker.