library laravel-xml

bmatovu/laravel-xml

Laravel XML Support

Laravel XML Support Package

, _(*1)

, _(*2)

This package comes with the much desired xml support for you Laravel project., _(*3)

Supports: Laravel versions v5.3 and above, _(*4)

Installation

composer require bmatovu/laravel-xml

Requests

Get the request content (body)., _(*5)

$request->xml();

* Returns Bmatovu\LaravelXml\Support\XMLElement object., _(*6)

Determine if the request content type is XML., _(*7)

$request->sentXml();

Determine if the current request is accepting XML., _(*8)

$request->wantsXml();

Validate XML content, _(*9)

$isValid = Xml::is_valid($request->xml());

if (! $isValid) {
    return response()->xml(['message' => 'The given data was malformed.'], 400);
}

Validation - Against XML Schema Definition, _(*10)

$errors = Xml::validate($request->xml(), 'path_to/sample.xsd');

if ($errors) {
    return response()->xml([
        'message' => 'The given data was invalid.',
        'errors' => $errors,
    ], 422);
}

Responses

Route::get('/users/{user}', function (Request $request, int $userId) {
    $user = User::findOrFail($userId);

    return response()->xml($user);
});

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <id>1</id>
    <name>jdoe</name>
    <email>jdoe@example.com</email>
</document>

Route::get('/users/{user}', function (Request $request, int $userId) {
    $user = User::findOrFail($userId);

    return response()->xml(['user' => $user->toArray()]);
});

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <user>
        <id>1</id>
        <name>jdoe</name>
        <email>jdoe@example.com</email>
    </user>
</document>

Route::get('/users/{user}', function (Request $request, int $userId) {
    $user = User::findOrFail($userId);

    return response()->xml($user, 200, [], ['root' => 'user']);
});

<?xml version="1.0" encoding="UTF-8"?>
<user>
    <id>1</id>
    <name>jdoe</name>
    <email>jdoe@example.com</email>
</user>

Route::get('/users', function () {
    $users = User::get();

    return response()->xml(['users' => $users->toArray()]);
});

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <users>
        <id>1</id>
        <name>John Doe</name>
        <email>jdoe@example.com</email>
    </users>
    <users>
        <id>2</id>
        <name>Gary Plant</name>
        <email>gplant@example.com</email>
    </users>
</document>

And will automatically set the content type to xml, _(*11)

Content-Type → text/xml; charset=UTF-8, _(*12)

Middleware

First register the middleware in app\Http\Kernel.php, _(*13)

protected $routeMiddleware = [
    // ...
    'xml' => \Bmatovu\LaravelXml\Http\Middleware\RequireXml::class,
];

Then use the middleware on your routes, or in the controllers., _(*14)

Route::post('/users', function (Request, $request) {
    // do something...
})->middleware('xml');

This middleware only checks the Content-Type by defaul;, _(*15)

[415 - Unsupported Media Type], _(*16)

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <message>Only accepting content of type XML.</message>
</document>

To check is the passed content is valid XML, pass a bool to the middleware, _(*17)

Route::post('/users', function (Request, $request) {
    // do something...
})->middleware('xml:1');

[400 - Bad Request], _(*18)

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <message>The given data was malformed.</message>
</document>

Utilities

Encode: Array to Xml, _(*19)

Xml::encode(['key' => 'value']);

Or, _(*20)

xml_encode(['key' => 'value']);

Decode: Xml to Array, _(*21)

Xml::decode('<?xml version="1.0" encoding="UTF-8"?><document><key>value</key></document>');

Or, _(*22)

xml_decode('<?xml version="1.0" encoding="UTF-8"?><document><key>value</key></document>');

Credits

Under the hood, I'm using;, _(*23)

Spatie's array to XML convernsion, _(*24)

Hakre's XML to JSON conversion, _(*25)

Akande's XML validation, _(*26)

Reporting bugs

If you've stumbled across a bug, please help us by leaving as much information about the bug as possible, e.g., _(*27)

• Steps to reproduce
• Expected result
• Actual result

This will help us to fix the bug as quickly as possible, and if you do wish to fix it yourself; feel free to fork the package on GitHub and submit a pull request!, _(*28)