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.
- 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
composer require matraux/xml-orm| 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 |
| 1.6.1 | 8.4+ | Optimized metadata |
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;See Development for debug, test instructions, static analysis, and coding standards.
For bug reports and feature requests, please use the issue tracker.