Convert an array to XML with PHP
composer require rboonzaijer/php-array-to-xml ^2.0
Require the vendor files (these already loaded if you are using something like Symfony or Laravel)
require __DIR__ . '/vendor/autoload.php';Basic example:
use RBoonzaijer\PhpArrayToXml\PhpArrayToXml;
$converter = new PhpArrayToXml();
$result = $converter->toXmlString(['title' => 'My Products']);Output:
<?xml version="1.0" encoding="UTF-8"?>
<root><title>My Products</title></root>
->setFormatOutput(bool $value = false)
Alias:
->prettify()is the same as typing:->setFormatOutput(true)
$array = [
'title' => 'My Products',
'pricing' => 'Pricing'
];Default:
<?xml version="1.0" encoding="UTF-8"?>
<root><title>My Products</title><pricing>Pricing</pricing></root>Usage:
$result = $converter->setFormatOutput(true)->toXmlString($array);
// or use the alias:
$result = $converter->prettify()->toXmlString($array);Result:
<?xml version="1.0" encoding="UTF-8"?>
<root>
<title>My Products</title>
<pricing>Pricing</pricing>
</root>
->setCustomRootName(string $value = 'root')
$result = $converter->setCustomRootName('data')->toXmlString();Result:
<?xml version="1.0" encoding="UTF-8"?>
<data>
...
</data>Custom tag names are used when an array has no key names
->setCustomTagName(string $value = 'node')
$array = [
'title' => 'My Products',
'products' => [
[
'name' => 'Raspberry Pi 3',
'price' => 39.99
],
[
'name' => 'Arduino Uno Rev3',
'price' => 19.99
]
]
];Default (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<title>My Products</title>
<products>
<node>
<name>Raspberry Pi 3</name>
<price>39.99</price>
</node>
<node>
<name>Arduino Uno Rev3</name>
<price>19.99</price>
</node>
</products>
</root>Usage:
$xml_string = $converter->setCustomTagName('item')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<title>My Products</title>
<products>
<item>
<name>Raspberry Pi 3</name>
<price>39.99</price>
</item>
<item>
<name>Arduino Uno Rev3</name>
<price>19.99</price>
</item>
</products>
</root>
->setVersion(string $value = '1.0')
$xml_string = $converter->setVersion('1.1')->toXmlString(['test']);Result (prettified):
<?xml version="1.1" encoding="UTF-8"?>
<root>
<node>test</node>
</root>
->setEncoding(string $value = 'UTF-8')
$xml_string = $converter->setEncoding('ISO-8859-1')->toXmlString(['test']);Result (prettified):
<?xml version="1.0" encoding="ISO-8859-1"?>
<root>
<node>test</node>
</root>Set the value for the separator that will be used to replace special characters in tag names
->setSeparator(string $value = '_')
$array = [
'some of these keys have' => 'My Value 1',
'spaces in them' => 'My Value 2',
];Default (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<some_of_these_keys_have>My Value 1</some_of_these_keys_have>
<spaces_in_them>My Value 2</spaces_in_them>
</root>Usage:
$xml_string = $converter->setSeparator('-')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<some-of-these-keys-have>My Value 1</some-of-these-keys-have>
<spaces-in-them>My Value 2</spaces-in-them>
</root>Transform tag names to uppercase/lowercase
->setTransformTags(string $value = null)
$array = [
'This' => [
'Is' => [
'an',
'Example'
]
]
];Default (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<This>
<Is>
<node>an</node>
<node>Example</node>
</Is>
</This>
</root>Usage (lowercase):
$xml_string = $converter->setTransformTags('lowercase')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<this>
<is>
<node>an</node>
<node>Example</node>
</is>
</this>
</root>Usage (uppercase):
$xml_string = $converter->setTransformTags('uppercase')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
<THIS>
<IS>
<NODE>an</NODE>
<NODE>Example</NODE>
</IS>
</THIS>
</ROOT>Usage (uppercase, but with custom tag names, which will not be transformed):
$xml_string = $converter
->setTransformTags('uppercase')
->setCustomRootName('MyRoot')
->setCustomTagName('MyCustomTag')
->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<MyRoot>
<THIS>
<IS>
<MyCustomTag>an</MyCustomTag>
<MyCustomTag>Example</MyCustomTag>
</IS>
</THIS>
</MyRoot>If this is not null, it appends the numeric array key to the tag name, with the value as separator.
->setNumericTagSuffix(string $value = null)
$array = [
'this',
'is',
'an'
[
'example',
'using',
'numeric tag suffix',
],
];Default (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<node>this</node>
<node>is</node>
<node>an</node>
<node>
<node>example</node>
<node>using</node>
<node>numeric tag suffix</node>
</node>
</root>Usage:
$xml_string = $converter->setNumericTagSuffix('_')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<node_0>this</node_0>
<node_1>is</node_1>
<node_2>an</node_2>
<node_3>
<node_0>example</node_0>
<node_1>using</node_1>
<node_2>numeric tag suffix</node_2>
</node_3>
</root>By default boolean values from the array will be cast to the string 'true' or 'false'. You can choose to cast it to any (string) value you like. This method only works on real boolean values, so strings with the value 'true' and 'false' are untouched.
->setCastBooleanValueTrue(string $value = 'true')
->setCastBooleanValueFalse(string $value = 'false')
$array = [
'StringTrue' => 'true',
'StringFalse' => 'false',
'BooleanTrue' => true,
'BooleanFalse' => false
];Default (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<StringTrue>true</StringTrue>
<StringFalse>false</StringFalse>
<BooleanTrue>true</BooleanTrue>
<BooleanFalse>false</BooleanFalse>
</root>Usage:
$xml_string = $converter->setCastBooleanTrue('Yes')->setCastBooleanFalse('No')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<StringTrue>true</StringTrue>
<StringFalse>false</StringFalse>
<BooleanTrue>Yes</BooleanTrue>
<BooleanFalse>No</BooleanFalse>
</root>By default null values from the array will have no value in the XML, so the tag looks something like this:
<MyTag/>. You can choose to cast it to any (string) value you like. This method only works on real 'null' values, so strings with the value'null'or empty strings''are untouched.
->setCastNullValue(null|string $value = null)
$array = [
'StringNull' => 'null',
'StringEmpty' => '',
'RealNull' => null
];Default (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<StringNull>null</StringNull>
<StringEmpty/>
<RealNull/>
</root>Usage:
$xml_string = $converter->setCastNullValue('__NULL__')->setCastBooleanFalse('No')->toXmlString($array);Result (prettified):
<?xml version="1.0" encoding="UTF-8"?>
<root>
<StringNull>null</StringNull>
<StringEmpty/>
<RealNull>__NULL__</RealNull>
</root>
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent