Merge commit 'be43e324b8da8cf5f4a6effb3221dfe945372fa9'

Author: ashenwolf

.styleci.yml

@@ -1,3 +1 @@
 preset: laravel
-
-linting: true

.travis.yml

@@ -1,9 +1,8 @@
 language: php
 
 php:
-  - 7.0
-  - 7.1
   - 7.2
+  - 7.3
 
 env:
   matrix:

CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to `array-to-xml` will be documented in this file
 
+## 2.11.1 - 2019-07-25
+
+- do not interpret "0" as a non-empty value
+
+## 2.11.0 - 2019-09-26
+
+- drop support for PHP 7.1
+
+## 2.10.0 - 2019-09-26
+
+- add `setDomProperties`
+
+## 2.9.0 - 2019-05-06
+
+- add support for numeric keys
+
+## 2.8.1 - 2019-03-15
+
+- fix tests
+- drop support for PHP 7.0
+
+## 2.8.0 - 2018-11-29
+
+- added support for mixed content 
+
+## 2.7.3 - 2018-10-30
+- fix for `DomExeception`s being thrown
+
+## 2.7.2 - 2018-09-17
+- remove control characters
+
 ## 2.7.1 - 2018-02-02
 - fix setting attributes
 

README.md

@@ -51,19 +51,25 @@ After running this piece of code `$result` will contain:
 </root>
 ```
 
+### Setting the name of the root element
+
 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');
 ```
 
+### Handling key names
+
 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.
+### Adding attributes
+
+You can use a key named `_attributes` to add attributes to a node, and `_value` to specify the value.
 
 ```php
 $array = [
@@ -76,6 +82,10 @@ $array = [
         'name' => 'Sauron',
         'weapon' => 'Evil Eye'
     ]
+    'The survivor' => [
+        '_attributes' => ['house'=>'Hogwarts'],
+        '_value' => 'Harry Potter'
+    ]
 ];
 
 $result = ArrayToXml::convert($array);
@@ -94,9 +104,14 @@ This code will result in:
         <name>Sauron</name>
         <weapon>Evil Eye</weapon>
     </Bad_guy>
+    <The_survivor house="Hogwarts">
+        Harry Potter
+    </The_survivor>
 </root>
 ```
 
+### Using reserved characters
+
 It is also possible to wrap the value of a node into a CDATA section. This allows you to use reserved characters.
 
 ```php
@@ -134,6 +149,8 @@ This code will result in:
 
 If your input contains something that cannot be parsed a `DOMException` will be thrown.
 
+### Adding attributes to the root element
+
 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.
 
@@ -143,7 +160,118 @@ $result = ArrayToXml::convert($array, [
     '_attributes' => [
         'xmlns' => 'https://github.com/spatie/array-to-xml',
     ],
-]);
+], true, 'UTF-8');
+```
+
+### Using a multi-dimensional array
+
+Use a multi-dimensional array to create a collection of elements.
+```php
+$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:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<helloyouluckypeople xmlns="https://github.com/spatie/array-to-xml">
+    <Good_guys>
+        <Guy>
+            <name>Luke Skywalker</name>
+            <weapon>Lightsaber</weapon>
+        </Guy>
+        <Guy>
+            <name>Captain America</name>
+            <weapon>Shield</weapon>
+        </Guy>
+    </Good_guys>
+    <Bad_guys>
+        <Guy>
+            <name>Sauron</name>
+            <weapon>Evil Eye</weapon>
+        </Guy>
+        <Guy>
+            <name>Darth Vader</name>
+            <weapon>Lightsaber</weapon>
+        </Guy>
+    </Bad_guys>
+</helloyouluckypeople>
+```
+
+### Handling numeric keys
+
+The package can also can handle numeric keys:
+
+```php
+$array = [
+    100 => [
+        'name' => 'Vladimir',
+        'nickname' => 'greeflas',
+    ],
+    200 => [
+        'name' => 'Marina',
+        'nickname' => 'estacet',
+    ],
+];
+
+$result = ArrayToXml::convert(['__numeric' => $array]);
+```
+
+This will result in:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+    <numeric_100>
+        <name>Vladimir</name>
+        <nickname>greeflas</nickname>
+    </numeric_100>
+    <numeric_200>
+        <name>Marina</name>
+        <nickname>estacet</nickname>
+    </numeric_200>
+</root>
+```
+
+You can change key prefix with setter method called `setNumericTagNamePrefix()`.
+
+### Setting DOMDocument properties
+
+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.
+
+```php
+$result = ArrayToXml::convert(
+   $array, 
+   $rootElement, 
+   $replaceSpacesByUnderScoresInKeyNames, 
+   $xmlEncoding, 
+   $xmlVersion, 
+   ['formatOutput' => true]
+);
+
+```
+
+Alternatively you can use  `setDomProperties`
+
+```php
+$arrayToXml = new ArrayToXml($array);
+$arrayToXml->setDomProperties(['formatOutput' => true]);
+$result = $arrayToXml->toXml();
 ```
 
 ## Testing

composer.json

@@ -17,12 +17,13 @@
         }
     ],
     "require": {
-        "php" : "^7.0"
+        "php" : "^7.2",
+        "ext-dom": "*"
     },
     "require-dev": {
-        "phpunit/phpunit" : "^6.3",
+        "phpunit/phpunit" : "^8.0",
         "mockery/mockery": "^1.0",
-        "spatie/phpunit-snapshot-assertions": "^1.0"
+        "spatie/phpunit-snapshot-assertions": "^2.0"
     },
     "autoload": {
         "psr-4": {

phpunit.xml

@@ -7,11 +7,15 @@
          convertNoticesToExceptions="true"
          convertWarningsToExceptions="true"
          processIsolation="false"
-         stopOnFailure="false"
-         syntaxCheck="false">
+         stopOnFailure="false">
     <testsuites>
         <testsuite name="Application Test Suite">
             <directory>./tests/</directory>
         </testsuite>
     </testsuites>
+     <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
 </phpunit>