Merge multiple XML sources from strings, files, DOM objects
The class allows to merge the XML sources (files, strings, objects) into single DOM XML object. The merging is performed recursively on the node level adding new elements and replacing existing ones. The nodes with the same path/name are replaced/added sequentially and the modification can be controlled by the options.
MergeXML could be useful in cases where it is necessary to gather XML data from multiple sources. For example, to join the configuration files of different subsystems depending on the system operation.
$oMX = new MergeXML([$opts]);
$opts - the options array:
- join - common root name if any source has different root name (default is root, specifying false denies different names)
- updn - traverse the nodes by name sequence (true, default) or overall sequence (false)
- stay - the destination node stay attribute value to deny overwriting of specific node (default is all, can be array of values or empty)
- keep - the source node keep attribute value to deny overwriting of specific node (default is all, can be array of values or empty)
$file - XML file's pathed name
$source - XML string or DOM object
The methods merge a sequent source and return the final object or false if failed (see error property below).
You can search in the result object:
$expr - XPath query expression
You can get the XML result tree:
- 0 - object (default)
- 1 - text
- 2 - html
The result object can be accessed also via $oMX->dom property. The properties available:
- dom - result XML DOM object
- dxp - result XPath object
- nsp - namespaces array (prefix => URI)
- count - number of sources merged
- error - error information
- error->code ('' is ok)
The sources must have the same default namespace (if have at all). Prefix '_' is reserved to handle default namespace.
The following files are included:
- mergexml.php - the MergeXML class; requires PHP 5.2+;
- example.html - client-side to select the xml files and display result;
- example.php - server-side to receive & pass the xml data and return result;
- test1.xml, test2.xml - test data for the example.
22 May 2014
- stay parameter is added for AddFile and AddSource methods
- NameSpaces method is added to register/xpath 1st (single) source
17 Sep 2015
- fmt and enc parameters are added
- packxml.php utility is added to compress the XML string
18 Dec 2015
- keep parameter is added for __construct, AddFile and AddSource methods
28 Apr 2017
- PackApp obfuscation compatibility