Download the PHP package vaclavvanik/dom-to-array without Composer
On this page you can find all versions of the php package vaclavvanik/dom-to-array. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vaclavvanik/dom-to-array
More information about vaclavvanik/dom-to-array
Files in vaclavvanik/dom-to-array
Package dom-to-array
Short Description An easy way to convert DOM Document to PHP array
License MIT
Homepage https://github.com/vaclavvanik/dom-to-array
Informations about the package dom-to-array
DomToArray
This package provides an easy way to convert DOMDocument to PHP array.
DomToArray supports attributes, cdata and array like elements.
Main usage is to convert any XML API response to array. DomToArray consumes good old PHP DOMDocument object. XML API responses are strings which could be flawlessly loaded to DOMDocument with vaclavvanik/dom-loader.
Install
You can install this package via composer.
Usage
Simply pass DOMDocument
XML API responses
DomToArray is meant mainly for turning XML responses from various APIs into a plain array to
work with. A typical setup drops the attributes and the response wrapper element:
A plain new DOMDocument() with loadXML() works just as well; DomLoader only adds proper
error handling.
Array elements
Multiple elements with same name will create multidimensional array.
This will result in:
Attributes
Element attributes create key => value like element_name@attribute_name => attribute_value
This will result in:
Cdata
Cdata are convert same as element text content.
This will result in:
Comments and processing instructions
Comments and processing instructions are skipped. Text they split is joined.
DomOptions
Options are passed to DomToArray::toArrayWithOptions().
DomOptions::SKIP_ATTRIBUTES
Sometimes it is useful to work only with elements (attributes are not needed).
This will result in:
DomOptions::KEEP_MIXED_CONTENT
By default an element that holds both text and child elements is converted to its text only and the child elements are dropped.
With DomOptions::KEEP_MIXED_CONTENT the text is kept under the @value key next
to the child elements.
Text is concatenated as-is (whitespace included) and its position relative to the child elements is not preserved.
DomOptions::OMIT_ROOT_ELEMENT
By default the result is wrapped in the name of the root element.
With DomOptions::OMIT_ROOT_ELEMENT the wrapper is removed and the children are
returned directly.
Root element attributes keep their root@attribute keys (and are still removed by
DomOptions::SKIP_ATTRIBUTES). A root element with only text content is returned
as ['@value' => '...'], an empty root element as [].
DomOptions::USE_ATTRIBUTE_NODE_NAME
By default attributes are keyed by their local name, so two attributes that only differ by namespace prefix collide.
With DomOptions::USE_ATTRIBUTE_NODE_NAME the full attribute node name (including
the namespace prefix) is used.
Run check - coding standards and php-unit
Install dependencies:
Run check:
Changelog
Please see CHANGELOG for more information what has changed recently.
License
The MIT License (MIT). Please see License File for more information.
All versions of dom-to-array with dependencies
ext-dom Version *