XML_Serializer

Swiss-army knive for reading and writing XML files. Creates XML files from data structures and vice versa.

XML_Serializer serializes complex data structures like arrays or object as XML documents. This class helps you generating any XML document you require without the need for DOM. Furthermore this package can be used as a replacement to serialize() and unserialize() as it comes with a matching XML_Unserializer that is able to create PHP data strcutures (like arrays and objects) from XML documents, if type hints are available. If you use the XML_Unserialzer on standard XML files, it will try to guess how it has to be unserialized. In most cases it does exactly what you expect it to do. Try reading a RSS file with XML_Unserializer and you have the whole RSS file in a structured array or even a collection of objects, similar to XML_RSS. Since version 0.8 the package is able to treat XML documents like the simplexml extension of PHP 5. schst Stephan Schmidt schst@php-tools.net lead 0.13.1 2004-11-26 PHP License beta Serializer: - fixed error handling (suppress error handling, when XML_Util returns an error) (patch by Lukas Smith) - replaced some left-over tabs with spaces XML_Util XML_Parser PEAR 0.2 2003-08-03 beta inital release 0.4 2003-08-12 beta added Unserializer removed bug with object typehint removed bug with unnameditem w/o _originalKey attribute uses XML_Util to validate tagname serializer does not break on resources anymore added support for __sleep() and __wakeup() 0.5 2003-08-14 PHP License beta Unserializer is now able to unserialize XML files w/o type hints by automatically transforming multiple occurences of the same tag to an indexed array This is now similar to ext/simpleXML in PHP5 that means it can be used to parse any XML file, try it with your favorite RSS feed 0.6 2003-08-21 PHP License beta Unserializer is able to return the name of the root tag, added 'complexType' option to XML_Unserializer, added possibility to create nested objects from any XML file, tagname is used as classname if no other class is specified, added 'overrideOptions' option that can be used to restore the default options for a serialization, added 'keyAttribute' option to XML_Unserializer, added Todo list 0.8 2003-09-23 PHP License beta XML_Serializer: * added option: scalarAsAttribute to create tags with attributes from an array or object, * added option: prependAttributes to enable a prepend string for attributes (ensure they are different from type hints), * added option: attributeIndent to allow multiline tags, if a tag has several attributes; this makes it easier to read (requested by Yavor Shahpasov), * now requires XML_Util 0.4.1 or newer, * added option: mode => simplexml, allows you to serialize indexed arrays like simpleXML of PHP5 does: tags use name of the parent structure and are in the same depth (this is still in alpha state, not thoroughly tested) XML_Unserializer: * added option: parseAttributes which allows you to parse tags with attributes, * added option: attributesArray to specify the name of the array in which attributes should be stored, * added option: prependAttributes to specify a prepend string for the generated array keys, * added option: contentName to specify the key for the content of a tag that contains also attributes * added option: tagMap, to change the names of the tags while parsing Both: * removed bug that occured when instantiating w/o options (reported by Alan Knowles), * added options: keyAttribute, typeAttribute and classAtribute to allow user to specify attribute names for typehints, * added resetOptions(), * added setOption(), * added option: overrideOptions that allows you to reset to defaults for one call of serialize or unserialize, * added some very small docs to defaultOptions arrays 0.8.1 2003-09-23 PHP License beta Bugfix release XML_Serializer: * removed bug when using mode => simplexml and indexed arrays contained only scalar values, * removed bug with missing _originalKey attribute when serializing objects XML_Unserializer: * added check for set{$propName} method to use methods to set properties in Unserializer instead of direct access 0.9 2003-10-13 PHP License beta XML_Serializer: + added support for doctype declaration (requested by Lapo 'Raist' Luchini), * changed tagName option to rootName option (tagName is still supported but deprecated), + added rootAttributes option (thanks to Lapo 'Raist' Luchini), + added rootName option for serializing objects XML_Unserializer: * removed bug with unserializing aggregated objects 0.9.1 2003-10-26 PHP License beta fixed bug #105 0.9.2 2004-04-23 PHP License beta fixed invalid multiple call to XML_Parser constructor 0.10.0 2004-05-24 PHP License beta - fixed bug #1478 (Array to string conversion) - fixed bug #170 (RDF examples produce incorrect code) - added new options to XML_Serializer: attributesArray and contentName to match XML_Unserializer 0.10.1 2004-07-12 PHP License beta fixed bug #1846 (unserialization bug with empty arrays) 0.11.0 2004-08-24 PHP License beta Serializer: - Request #2019 (use classname as tagname in indexed arrays) - replaced double quotes with single quotes - some CS fixes Unserializer: - added new option 'forceEnum' - replaced double quotes with single quotes 0.11.1 2004-08-25 PHP License beta Serializer: - fixed bug with default line endings 0.12.0 2004-11-03 PHP License beta Serializer: - added new option tagMap (requested by Toby) Unserializer: - added encoding option (thanks to mc[at]glouglou[dot]net) 0.13.0 2004-11-06 PHP License beta Serializer: - fixed bug #2688: in simplexml mode $array needs to be non-empty (thanks to demian[at]phpkitchen[dot]com and derek[at]hostbaby[dot]com) Unserializer: - implemented Request #2650: Multiple key attributes 0.13.1 2004-11-26 PHP License beta Serializer: - fixed error handling (suppress error handling, when XML_Util returns an error) (patch by Lukas Smith) - replaced some left-over tabs with spaces