A simple class to convert an array to xml
This package provides a very simple class to convert an array to an xml string.
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
You can install this package via composer.
composer require spatie/array-to-xmluse Spatie\ArrayToXml\ArrayToXml;
...
$array = [
'Good guy' => [
'name' => 'Luke Skywalker',
'weapon' => 'Lightsaber'
],
'Bad guy' => [
'name' => 'Sauron',
'weapon' => 'Evil Eye'
]
];
$result = ArrayToXml::convert($array);After running this piece of code $result will contain:
Luke Skywalker
Lightsaber
Sauron
Evil Eye
Optionally you can set the name of the rootElement by passing it as the second argument. If you don't specify this argument (or set it to an empty string) "root" will be used.
$result = ArrayToXml::convert($array, 'customrootname');By default all spaces in the key names of your array will be converted to underscores. If you want to opt out of this behaviour you can set the third argument to false. We'll leave all keynames alone.
$result = ArrayToXml::convert($array, 'customrootname', false);You can use a key named _attributes to add attributes to a node, and _value to specify the value.
$array = [
'Good guy' => [
'_attributes' => ['attr1' => 'value'],
'name' => 'Luke Skywalker',
'weapon' => 'Lightsaber'
],
'Bad guy' => [
'name' => 'Sauron',
'weapon' => 'Evil Eye'
],
'The survivor' => [
'_attributes' => ['house'=>'Hogwarts'],
'_value' => 'Harry Potter'
],
'Good movie' => [
'_attributes' => ['category' => 'Action'],
'_value' => 300,
],
];
$result = ArrayToXml::convert($array);This code will result in:
Luke Skywalker
Lightsaber
Sauron
Evil Eye
Harry Potter
300
Note, that the value of the _value field must be a string. (More)
You can use a key named _comment to add a comment to a node. The exact placement depends on where you put the key in your array. You can also add multiple keys starting with _comment to add multiple comments.
…This code will result in:
Luke Skywalker
Lightsaber
Sauron
Evil Eye
John Wick
Pencil
Harry Potter
[!NOTE] A comment will be omitted if the value is an empty string "" or
null.
It is also possible to wrap the value of a node into a CDATA section. This allows you to use reserved characters.
$array = [
'Good guy' => [
'name' => [
'_cdata' => '
Luke Skywalker
'
],
'weapon' => 'Lightsaber'
],
'Bad guy' => [
'name' => '
Sauron
',
'weapon' => 'Evil Eye'
]
];
$result = ArrayToXml::convert($array);This code will result in:
Lightsaber
<h1>Sauron</h1>
Evil Eye
If your input contains something that cannot be parsed a DOMException will be thrown.
You could specify specific values in for:
$result = ArrayToXml::convert($array, [], true, 'UTF-8', '1.1', [], true);This will result in:
To add attributes to the root element provide an array with an _attributes key as the second argument.
The root element name can then be set using the rootElementName key.
$result = ArrayToXml::convert($array, [
'rootElementName' => 'helloyouluckypeople',
'_attributes' => [
'xmlns' => 'https://github.com/spatie/array-to-xml',
],
], true, 'UTF-8');Use a multi-dimensional array to create a collection of elements.
$array = [
'Good guys' => [
'Guy' => [
['name' => 'Luke Skywalker', 'weapon' => 'Lightsaber'],
['name' => 'Captain America', 'weapon' => 'Shield'],
],
],
'Bad guys' => [
'Guy' => [
['name' => 'Sauron', 'weapon' => 'Evil Eye'],
['name' => 'Darth Vader', 'weapon' => 'Lightsaber'],
],
],
];This will result in:
Luke Skywalker
Lightsaber
Captain America
Shield
Sauron
Evil Eye
Darth Vader
Lightsaber
The package can use Closure values:
$users = [
[
'name' => 'one',
'age' => 10,
],
[
'name' => 'two',
'age' => 12,
],
];
$array = [
'users' => function () use ($users) {
$new_users = [];
foreach ($users as $user) {
$new_users[] = array_merge(
$user,
[
'double_age' => $user['age'] * 2,
]
);
}
return $new_users;
},
];
ArrayToXml::convert($array)This will result in:
one
10
20
two
12
24
The package can also can handle numeric keys:
$array = [
100 => [
'name' => 'Vladimir',
'nickname' => 'greeflas',
],
200 => [
'name' => 'Marina',
'nickname' => 'estacet',
],
];
$result = ArrayToXml::convert(['__numeric' => $array]);This will result in:
Vladimir
greeflas
Marina
estacet
You can change key prefix with setter method called setNumericTagNamePrefix().
The package can also can handle custom keys:
$array = [
'__custom:custom-key:1' => [
'name' => 'Vladimir',
'nickname' => 'greeflas',
],
'__custom:custom-key:2' => [
'name' => 'Marina',
'nickname' => 'estacet',
'tags' => [
'__custom:tag:1' => 'first-tag',
'__custom:tag:2' => 'second-tag',
]
],
];
$result = ArrayToXml::convert($array);This will result in:
Vladimir
greeflas
Marina
estacet
first-tag
second-tag
A custom key contains three, colon-separated parts: "__custom:[custom-tag]:[unique-string]".
a colon character can be included within the custom-tag portion by escaping it with a backslash:
$array = [
'__custom:ns\\:custom-key:1' => [
'name' => 'Vladimir',
'nickname' => 'greeflas',
],
'__custom:ns\\:custom-key:2' => [
'name' => 'Marina',
'nickname' => 'estacet',
'tags' => [
'__custom:ns\\:tag:1' => 'first-tag',
'__custom:ns\\:tag:2' => 'second-tag',
]
],
];This will result in:
Vladimir
greeflas
Marina
estacet
first-tag
second-tag
To set properties of the internal DOMDocument object just pass an array consisting of keys and values. For a full list of valid properties consult https://www.php.net/manual/en/class.domdocument.php.
You can use the constructor to set DOMDocument properties.
$result = ArrayToXml::convert(
$array,
$rootElement,
$replaceSpacesByUnderScoresInKeyNames,
$xmlEncoding,
$xmlVersion,
['formatOutput' => true]
);
Alternatively you can use setDomProperties
$arrayToXml = new ArrayToXml($array);
$arrayToXml->setDomProperties(['formatOutput' => true]);
$result = $arrayToXml->toXml();Call $arrayToXml->prettify() method on ArrayToXml to set XML in pretty form.
Example:
$array = [
'Good guy' => [
'name' => 'Luke Skywalker',
'weapon' => 'Lightsaber'
],
'Bad guy' => [
'name' => 'Sauron',
'weapon' => 'Evil Eye'
]
];
$arrayToXml = new ArrayToXml($array);With prettification:
$arrayToXml->prettify()->toXml();will result in:
Luke Skywalker
Lightsaber
Sauron
Evil Eye
Without prettification:
$arrayToXml->toXml();will result in:
Luke SkywalkerLightsaberSauronEvil EyeCall $arrayToXml->dropXmlDeclaration() method on ArrayToXml object to omit default XML declaration on top of the generated XML.
Example:
$root = [
'rootElementName' => 'soap:Envelope',
'_attributes' => [
'xmlns:soap' => 'http://www.w3.org/2003/05/soap-envelope/',
],
];
$array = [
'soap:Header' => [],
'soap:Body' => [
'soap:key' => 'soap:value',
],
];
$arrayToXml = new ArrayToXml($array, $root);
$result = $arrayToXml->dropXmlDeclaration()->toXml();This will result in:
soap:valueCall $arrayToXml->addProcessingInstruction($target, $data) method on ArrayToXml object to prepend a processing instruction before the root element.
Example:
$arrayToXml = new ArrayToXml($array);
$arrayToXml->addProcessingInstruction('xml-stylesheet', 'type="text/xsl" href="base.xsl"');
$result = $arrayToXml->toXml();This will result in:
Luke SkywalkerLightsaberSauronEvil Eyevendor/bin/phpunitPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium.
We publish all received postcards on our company website.
The MIT License (MIT). Please see License File for more information.
No open issues yet, or sync has not completed.