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

PHP compatibility

This package provides separate major versions for different PHP baselines.

Examples

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

See Read for full reading examples.

use Matraux\XmlOrm\Xml\SimpleExplorer;

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

See Write for writing examples.

$main = MainEntity::create();
$main->name = 'Main 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.