Download the PHP package michelmelo/response-xml without Composer
On this page you can find all versions of the php package michelmelo/response-xml. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download michelmelo/response-xml
More information about michelmelo/response-xml
Files in michelmelo/response-xml
Package response-xml
Short Description The missing XML support for Laravel's Response class.
License
Informations about the package response-xml
The missing XML support for Laravel's Response class.
This package is designed to work with the Laravel framework.
Installation
Install via composer:
Registering the service provider
For Laravel 5.4 and lower, add the following line to your config/app.php
:
For Laravel 5.5 and greater, the package will auto register the provider for you.
Using Lumen
To register the service provider, add the following line to app/bootstrap/app.php
:
Quick start
Respond with xml
Returns:
Respond with xml from a collection or eloquent query
You may also pass a collection to be transformed into xml.
Respond with existing xml
If you already have xml, you can pass it to the xml
method to respond.
Respond with the request's preferred format (xml/json)
If you want to respond with either xml or json on the fly without writing if/else statements you may use the ->preferredFormat()
method. This will take the request's Accept
header and try to determine which format the request wants to be served. If this header is nonexistent, it will default to json. Note: when using this method, it will automatically set your response's Content-Type
header to match the request's Accept
header.
Adding attributes
You can use a key named _attributes
to add attributes to a node, and _value
to specify the value.
This code will result in:
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.
This code will result in:
Methods and arguments
Response method
->xml($xml, $status = 200, array $headers = [], $xmlRoot = 'response')
The $xml
argument is the data you want to be transformed into xml (may also be a premade xml string).
$status
is the http code your response will send.
$headers
is an array of key/values of http headers your response will return.
$xmlRoot
will change the root xml element. Default is response
.
Response method
->preferredFormat($data, $status = 200, array $headers = [], $xmlRoot = 'response')
See ->xml()
method arguments.
The only difference between this method and ->xml()
is $data
can potentially be transformed to json and $xmlRoot
will be ignored if the response is json.
Purpose
Have you ever found yourself wishing Laravel offered the same exemplary support for returning XML responses as it does for JSON? Imagine you are creating an api platform and want to be inclusive of other apps that would prefer to make XML requests to your application - sometimes the reasons are more than preferential. Wouldn't it be a dream if you could return XML as simply as writing return response()->xml($data);
and it just worked? Now you can!
This package achieves one critical goal: respond with XML as easily as you can with JSON in your Laravel application.
more
https://github.com/spatie/array-to-xml
Credits
- Mark Townsend
- Spatie
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of response-xml with dependencies
illuminate/http Version ^5.2
illuminate/routing Version ^5.2
illuminate/support Version ^5.3
illuminate/container Version ^5.2
spatie/array-to-xml Version ^2.6